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 |
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.
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, .doc, .docx, .xls, .xlsx, .jpg, .jpeg, .png, .txt, .zip, .csv, .eml |
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.
Related
- Create a Case — Create the case before uploading files
- Track Case Status — Monitor case progress after submission