Create dispute case content - Marqeta Docs

POST///

Upload and store documents related to a dispute, such as supporting evidence or KYC verification documents. The supported document formats are PDF, TIFF, and JPEG. Each uploaded file is restricted to 2 MB.

URL path parameter

Fields	Description
token string Required	Unique identifier of the dispute case. Send a `GET` request to `/cases` to retrieve dispute case tokens. Allowable Values: 36 char max

Request body

Fields	Description
document_category string Required	Category of the document. The category is also forwarded to PULSE. Allowable Values: `AFFIDAVIT_FRAUD`, `AUTHORIZATION_RECORD`, `BANK_STATEMENT`, `CANCELLED_CHECK`, `CARDHOLDER_LETTER`, `CREDIT_VOUCHER`, `FULFILLMENT`, `ISSUER_CERTIFICATION`, `MERCHANT_LETTER`, `NETWORK_DOCUMENT`, `NETWORK_EXHIBIT`, `OTHERS`, `RECEIPT`, `SALES_DRAFT`, `SECOND_OPTION`, `UPDATED_CARDHOLDER_LETTER`, `UPDATED_MERCHANT_LETTER`
document_name string Required	Name of the document. Allowable Values: Must include the file extension, as appropriate for a supported file format: `.pdf`, `.tiff`, or `.jpeg`.
document_data binary Required	Base64-encoded file. Allowable Values: 2 MB max size

Create content response body

Fields	Description
token string Returned	Unique identifier of the document. Allowable Values: 36 char max
case_token string Returned	Unique identifier of the dispute case you want to upload documents against. Allowable Values: 36 char max
document_name string Returned	Name of the document. Allowable Values: 255 char max
document_category string Returned	Type of document. Allowable Values: `AFFIDAVIT_FRAUD`, `AUTHORIZATION_RECORD`, `BANK_STATEMENT`, `CANCELLED_CHECK`, `CARDHOLDER_LETTER`, `CREDIT_VOUCHER`, `FULFILLMENT`, `ISSUER_CERTIFICATION`, `MERCHANT_LETTER`, `NETWORK_DOCUMENT`, `NETWORK_EXHIBIT`, `OTHERS`, `RECEIPT`, `SALES_DRAFT`, `SECOND_OPTION`, `UPDATED_CARDHOLDER_LETTER`, `UPDATED_MERCHANT_LETTER`
document_content_type string Returned	Content type of the document. Allowable Values: `application/pdf`, `image/tiff`, `image/jpeg`
network_processing_type string Returned	Indicates the current status of the document at the network: - `SUBMITTED` – Indicates it has been submitted to the network using the Dispute Case Transition or Network Dispute Transition endpoint. - `RECEIVED` – Indicates that the document has been downloaded from the network, which occurs when the acquirer uploaded a document to support their claim. Allowable Values: `SUBMITTED`, `RECEIVED`
network_processing_phase string Returned	Indicates the status of the document in the dispute lifecycle. Allowable Values: `INITIATED`, `REPRESENTMENT`, `PRE_ARBITRATION`
network_processing_time datetime Returned	Date and time when the document has either been submitted by the user or received from the network. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
created_time datetime Returned	Date and time when the dispute was created. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
updated_time datetime Returned	Date and time when the dispute was last modified. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
download_link string Returned	Link to download the file if it is included in the request. This only applies to the `GET` case content by token endpoint. Allowable Values: Valid URI

Sample request body

JSON

Content-Type: multipart/form-data; boundary=marqeta_file_separator
Cache-Control: no-cache

--marqeta_file_separator
Content-Type: application/json; Content-Disposition: form-data; name="body"

{
  "document_category": "RECEIPT",
  "document_name": "receipt.pdf",
  "document_data": "string"
}

--marqeta_file_separator
Content-Type: image/jpeg; Content-Disposition: form-data; name="file"

file=@/Users/username/Downloads/online-receipt-location.jpg

--marqeta_file_separator--

Sample response body

JSON

{
  "token": "my_content_token",
  "case_token": "my_case_token",
  "document_name": "string",
  "document_category": "RECEIPT",
  "document_content_type": "application/pdf",
  "network_processing_type": "SUBMITTED",
  "network_processing_phase": "INITIATED",
  "network_processing_time": "2025-02-01T20:22:34.913Z",
  "created_time": "2025-02-01T20:22:34.913Z",
  "updated_time": "2025-02-01T20:22:34.913Z",
  "download_link": "download_link"
}