> ## 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. # Submit a dispute for review > Submits the uploaded documentation of a dispute for review. The dispute must be in `waiting_documentation`, have at least one document, and be within its documentation upload deadline. On success the dispute moves to `in_review` and Fintoc's operations team is notified. **`v1`** ยท Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json POST /disputes/{id}/submit_for_review openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /disputes/{id}/submit_for_review: post: tags: - Disputes summary: Submit a dispute for review description: >- Submits the uploaded documentation of a dispute for review. The dispute must be in `waiting_documentation`, have at least one document, and be within its documentation upload deadline. On success the dispute moves to `in_review` and Fintoc's operations team is notified. operationId: disputes-submit-for-review parameters: - name: id in: path description: Unique identifier for the dispute to submit for review. required: true schema: type: string responses: '200': description: The dispute, now in `in_review`. content: application/json: examples: dispute_submitted: value: id: cb_8anBm9YpVwXzKqL2 object: dispute amount: 7005 created_at: '2024-01-15T17:04:10.284Z' currency: CLP documentation_upload_deadline: '2024-01-22T17:04:10.284Z' documents: - 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 mode: live resource_id: pi_8anBm9YpVwXzKqL2 resource_type: payment_intent status: in_review updated_at: '2024-01-16T17:04:10.284Z' schema: $ref: '#/components/schemas/dispute' '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 mode than the API key. 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 cannot be submitted: it has no documents, its deadline has passed, or it is not in `waiting_documentation`. content: application/json: examples: no_documents_to_submit: value: error: type: conflicted_request_error code: no_documents_to_submit message: >- This dispute has no documents to submit. Upload at least one document before submitting. doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: dispute: type: object properties: id: type: string description: Unique identifier of the dispute. example: cb_8anBm9YpVwXzKqL2 object: const: dispute description: Type of the object. Always `dispute`. amount: type: integer description: >- Disputed amount, in the currency's smallest unit. CLP has no decimals, so `7005` means 7005 CLP; MXN and USD have cents, so `7005` means 70.05. example: 7005 created_at: type: string format: date-time description: ISO 8601 datetime in UTC when the dispute was created. example: '2024-01-15T17:04:10.284Z' currency: type: string description: ISO 4217 currency code of the disputed amount. example: CLP documentation_upload_deadline: type: string format: date-time description: >- ISO 8601 datetime in UTC for the documentation submission deadline before the dispute is lost by default. example: '2024-01-22T17:04:10.284Z' documents: type: array description: Documents uploaded as evidence for the dispute. items: $ref: '#/components/schemas/dispute_document' mode: $ref: '#/components/schemas/mode' resource_id: type: string description: Identifier of the disputed resource. example: pi_8anBm9YpVwXzKqL2 resource_type: const: payment_intent description: Type of the disputed resource. Always `payment_intent`. status: type: string enum: - waiting_documentation - in_review - lost - expired - won description: >- Current status of the dispute. One of `waiting_documentation`, `in_review`, `lost`, `expired`, or `won`. example: waiting_documentation updated_at: type: string format: date-time description: ISO 8601 datetime in UTC when the dispute was last updated. example: '2024-01-16T17:04:10.284Z' required: - id - object - amount - created_at - currency - documentation_upload_deadline - documents - mode - resource_id - resource_type - status - updated_at 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 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 mode: type: string enum: - test - live description: >- Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing. example: live securitySchemes: api_key: type: apiKey name: Authorization in: header ````