Upload Documents

Attach files to a case using POST /cases/{id}/files. Documents strengthen collection efforts by providing evidence of the debt.

Upload a File

Send a multipart form request with the file and optional metadata:

curl -X POST https://customer-api.debitura.com/cases/{caseId}/files \
  -H "XApiKey: YOUR_API_KEY" \
  -F "File=@invoice.pdf" \
  -F "DocumentType=OriginalInvoice" \
  -F "Description=Invoice #1234 dated 2025-01-15"

Request Fields

Field	Required	Description
File	Yes	The file to upload (binary)
DocumentType	No	Category for the document (defaults to OriginalInvoice)
Description	No	Human-readable label

Document Types

Value	Use for
OriginalInvoice	The invoice being collected (default)
CreditorDocuments	Contracts, agreements, delivery confirmations
DebtorDocuments	Documents provided by the debtor
PartnerDocuments	Documents provided by the collection partner
DemandLetter	Formal payment demands you've sent
Miscellaneous	Other supporting evidence

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "caseId": "d3051d9e-8b4a-4c5f-9e1a-123456789abc",
  "fileName": "invoice.pdf",
  "documentType": "OriginalInvoice",
  "description": "Invoice #1234 dated 2025-01-15",
  "url": "https://admino.blob.core.windows.net/...",
  "dateCreated": "2025-06-25T10:30:00Z"
}

The url is a signed download link valid for approximately 1 hour. To get a fresh URL, call the list endpoint again.

Filenames

Filenames are preserved exactly as uploaded, including non-ASCII characters such as accented letters or umlauts (for example, Versäumnisurteil.pdf). The url returned in the upload response, and any URL returned later by the list endpoint, is always safe to open regardless of what characters the original filename contains.

List Files

Retrieve all files attached to a case:

curl https://customer-api.debitura.com/cases/{caseId}/files \
  -H "XApiKey: YOUR_API_KEY"

Returns an array of file objects with the same structure as the upload response.

Constraints

Constraint	Limit
Maximum file size	25 MB
Allowed formats	.pdf, .xls, .xlsx, .jpg, .jpeg, .png, .gif, .txt, .csv

Error Handling

Status	Cause
400	File missing, empty, or failed validation
404	Case not found or belongs to another account
413	File exceeds 25 MB limit
415	File type not in allowed list

For error response formats, see Error Handling.

Create a case before uploading files. See Track Case Status to monitor case progress after submission.