> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload a dispute document

> 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.

**`v1`** · Base URL `https://api.fintoc.com/v1`


## OpenAPI

````yaml reference/fintoc-api.json POST /disputes/{dispute_id}/documents
openapi: 3.1.0
info:
  title: fintoc-api
  version: v2026-02-01
servers:
  - url: https://api.fintoc.com/v1
security: []
paths:
  /disputes/{dispute_id}/documents:
    post:
      tags:
        - Disputes
      summary: Upload a dispute document
      description: >-
        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.
      operationId: disputes-documents-create
      parameters:
        - name: dispute_id
          in: path
          description: >-
            The dispute the document is uploaded to, prefixed with `cb_` (for
            example `cb_8anBm9YpVwXzKqL2`).
          required: true
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: >-
                    The document to upload. Must be a PDF, JPEG, or PNG and
                    smaller than 10 MB.
              required:
                - file
        required: true
      responses:
        '201':
          description: The uploaded dispute document.
          content:
            application/json:
              examples:
                dispute_document_created:
                  value:
                    id: cbd_8anBm9YpVwXzKqL2
                    object: dispute_document
                    content_type: application/pdf
                    created_at: '2024-01-16T17:04:10.284Z'
                    dispute_id: cb_8anBm9YpVwXzKqL2
                    filename: evidence.pdf
                    size: 102400
              schema:
                $ref: '#/components/schemas/dispute_document'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              examples:
                invalid_api_key:
                  value:
                    error:
                      type: authentication_error
                      code: invalid_api_key
                      message: 'Invalid API Key: invalid-*oken'
              schema:
                $ref: '#/components/schemas/error_object'
        '404':
          description: >-
            The dispute does not exist, or belongs to a different organization
            or to the `live`/`test` mode the API key does not use.
          content:
            application/json:
              examples:
                dispute_not_found:
                  value:
                    error:
                      type: invalid_request_error
                      code: missing_resource
                      param: id
                      message: 'No such dispute: cb_8anBm9YpVwXzKqL2'
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
        '409':
          description: >-
            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.
          content:
            application/json:
              examples:
                dispute_not_open_for_documents:
                  value:
                    error:
                      type: conflicted_request_error
                      code: dispute_not_open_for_documents
                      message: >-
                        Documents can only be uploaded while the dispute is in
                        waiting_documentation status.
                      doc_url: https://docs.fintoc.com/reference/errors
                dispute_deadline_exceeded:
                  value:
                    error:
                      type: conflicted_request_error
                      code: dispute_deadline_exceeded
                      message: >-
                        The documentation upload deadline for this dispute has
                        passed.
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
        '422':
          description: >-
            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.
          content:
            application/json:
              examples:
                unsupported_content_type:
                  value:
                    error:
                      type: invalid_request_error
                      code: unsupported_content_type
                      message: >-
                        Unsupported content type: text/csv. Allowed types:
                        application/pdf, image/jpeg, image/png.
                      doc_url: https://docs.fintoc.com/reference/errors
                file_too_large:
                  value:
                    error:
                      type: invalid_request_error
                      code: file_too_large
                      message: File exceeds the maximum size of 10 MB.
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
      security:
        - api_key: []
components:
  schemas:
    dispute_document:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the dispute document.
          example: cbd_8anBm9YpVwXzKqL2
        object:
          const: dispute_document
          description: Type of the object. Always `dispute_document`.
        content_type:
          type:
            - string
            - 'null'
          description: >-
            Media type of the uploaded file, for example `application/pdf`.
            `null` when Fintoc cannot determine the type.
          example: application/pdf
        created_at:
          type: string
          format: date-time
          description: ISO 8601 datetime in UTC when the document was uploaded.
          example: '2024-01-16T17:04:10.284Z'
        dispute_id:
          type: string
          description: Identifier of the dispute this document belongs to.
          example: cb_8anBm9YpVwXzKqL2
        filename:
          type: string
          description: Name of the uploaded file.
          example: evidence.pdf
        size:
          type: integer
          description: Size of the uploaded file in bytes.
          example: 102400
      required:
        - id
        - object
        - content_type
        - created_at
        - dispute_id
        - filename
        - size
    error_object:
      type: object
      properties:
        error:
          type: object
          description: Details of the error that caused the request to fail.
          properties:
            code:
              type: string
              description: >-
                Machine-readable code identifying the specific error, for
                example `invalid_api_key`. Not returned by every error.
              example: invalid_api_key
            doc_url:
              type: string
              description: >-
                URL of a documentation page with more details about the error.
                Not returned by every error.
              example: https://docs.fintoc.com/reference/errors
            message:
              type: string
              description: Human-readable message describing the error.
              example: 'Invalid API Key: invalid-*oken'
            param:
              type:
                - string
                - 'null'
              description: >-
                Name of the request parameter that caused the error. `null` when
                the error cannot be tied to a single parameter, and not returned
                by every error.
              example: amount
            type:
              type: string
              description: >-
                Category of the error, for example `invalid_request_error`,
                `authentication_error`, or `api_error`.
              example: invalid_request_error
          required:
            - type
            - message
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````