Fetch a single case by creditor reference, scoped to a specific creditor and partner.
GET/cases/by-creditor-reference
Returns detailed case information using the creditor's own reference (CreditorReference) scoped to a specific creditor.
Use Case:
Use this endpoint when you have the creditor's reference (e.g. from an invoice file or payment import) and need to look up the corresponding Debitura case. Because CreditorReference is only unique within a single creditor, you must also supply creditorId to make the lookup unambiguous.
Matching:
Exact string match on CreditorReference. The case must also belong to the specified creditor and be assigned to the calling partner.
Access Control:
Only returns production collection cases where you are the collection partner. The creditorId parameter scopes the lookup to a specific creditor — you can only retrieve cases for creditors whose cases are assigned to you.
Request
Responses
- 200
- 400
- 404
Case found
Reference or creditorId missing or empty
No case found for this reference + creditor combination, or not assigned to you