> ## 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. # Get a dispute > Retrieves a dispute by its `id`. Only disputes matching the `live` or `test` mode of the API key are visible; any other dispute returns a `404 Not Found` error without leaking its existence. **`v1`** ยท Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json GET /disputes/{id} openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /disputes/{id}: get: tags: - Disputes summary: Get a dispute description: >- Retrieves a dispute by its `id`. Only disputes matching the `live` or `test` mode of the API key are visible; any other dispute returns a `404 Not Found` error without leaking its existence. operationId: disputes-get parameters: - name: id in: path description: Unique identifier for the dispute. required: true schema: type: string responses: '200': description: The dispute. content: application/json: examples: dispute: 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: [] mode: live resource_id: pi_8anBm9YpVwXzKqL2 resource_type: payment_intent status: waiting_documentation 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' 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 ````