DEdebitura
Cases

Upload a file to a case

Changed on

Uploads a file and attaches it to a case. Mirrors the file upload action available in the Partner portal.

Access: Collection partners only. Managing partners are rejected.

Status gate: Allowed on all non-Merged statuses, including Closed. Only Merged cases are rejected.

File requirements:

  • Maximum size: 25 MB
  • Allowed extensions: .pdf .doc .docx .xls .xlsx .jpg .jpeg .png .txt .zip .csv .eml

DocumentType (optional): Omit it when the type is unknown; the file is stored as not specified and returned as null. Values are case-insensitive: OriginalInvoice, AccountStatement, Contract, TermsAndConditions, ProofOfDelivery, DemandLetter, Correspondence, PaymentProof, CourtDocument, IdentityDocument, Miscellaneous. Legacy names remain accepted for existing integrations: DebtorDocuments, CreditorDocuments, PartnerDocuments. Unknown names, numeric values, and AutoGeneratedSummary are rejected with 400 and error InvalidDocumentType.

The file is immediately visible to the creditor.

post/cases/{id}/files

Request

  • Base URL
    https://collectionpartner-api.debitura.com
  • URL
    https://collectionpartner-api.debitura.com/cases/{id}/files
  • Auth
    API key in header XApiKey

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Optional non-empty, non-whitespace idempotency key (max 255 characters) for safely retrying this request. If a previous request used the same key with an identical body, the original terminal response is replayed verbatim. Reusing the key with a different body returns 422 with businessErrors[0].type: "IdempotencyConflict". Field-level 400 validation errors are not stored, so you may fix the request and retry with the same key.

Request body multipart/form-data

Filestring binary

The file to upload. Required. Allowed extensions: .pdf .doc .docx .xls .xlsx .jpg .jpeg .png .txt .zip .csv .eml Maximum size: 25 MB.

DocumentTypestring

Optional document type, case-insensitive. Omit (or pass null) when you do not know it; the file is then stored as not specified. Valid values: OriginalInvoice, AccountStatement, Contract, TermsAndConditions, ProofOfDelivery, DemandLetter, Correspondence, PaymentProof, CourtDocument, IdentityDocument, Miscellaneous. Still accepted for existing integrations: DebtorDocuments, CreditorDocuments, PartnerDocuments. Any other value is rejected with 400 and error "InvalidDocumentType".

Descriptionstring

Optional free-text description / label for the file (max 500 characters).

Response

File uploaded successfully

idstring uuid
dateCreatedstring date-time
dateUpdatedstring date-time
caseIdstring uuid
entityTypestring nullable
entityIdstring uuid
fileNamestring nullable
urlstring nullable
descriptionstring nullable
documentTypestring nullable

Changes