---
title: "Upload a dispute document"
method: POST
path: "/disputes/{dispute_id}/documents"
tags: ["Disputes"]
---

# Upload a dispute document

`POST /disputes/{dispute_id}/documents`

Uploads a document as evidence for a dispute. Send the file as `multipart/form-data`. The file must be a PDF, JPEG, or PNG and smaller than 10 MB. You can upload documents only while the dispute is in `waiting_documentation` and within its documentation upload deadline. The dispute must match the `live` or `test` mode of the API key used.

## Path parameters

- `dispute_id` string, required

## Response `201`

The uploaded dispute document.

- DisputeDocument
  - `id` string, required — Unique identifier of the dispute document.
  - `object` 'dispute_document', required — Type of the object. Always `dispute_document`.
  - `content_type` string, nullable, required — Media type of the uploaded file, for example `application/pdf`. `null` when Fintoc cannot determine the type.
  - `created_at` string, date-time, required — ISO 8601 datetime in UTC when the document was uploaded.
  - `dispute_id` string, required — Identifier of the dispute this document belongs to.
  - `filename` string, required — Name of the uploaded file.
  - `size` integer, required — Size of the uploaded file in bytes.

## Other responses

- `401` — Invalid or missing API key.
- `404` — The dispute does not exist, or belongs to a different organization or to the `live`/`test` mode the API key does not use.
- `409` — The dispute is not open for documents. Returns `dispute_not_open_for_documents` when it is no longer in `waiting_documentation`, or `dispute_deadline_exceeded` when its documentation upload deadline has passed.
- `422` — Fintoc cannot process the upload. Returns `unsupported_content_type` when the file type is not allowed, or `file_too_large` when the file exceeds the size limit.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/versions/9dafa63688a3/schema)