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

# List disputes

> Lists the disputes of your organization for the `live` or `test` mode of the API key used. Returns the most recent disputes first. Use the `status`, `resource_id`, `since`, and `until` query parameters to filter the list.

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


## OpenAPI

````yaml reference/fintoc-api.json GET /disputes
openapi: 3.1.0
info:
  title: fintoc-api
  version: v2026-02-01
servers:
  - url: https://api.fintoc.com/v1
security: []
paths:
  /disputes:
    get:
      tags:
        - Disputes
      summary: List disputes
      description: >-
        Lists the disputes of your organization for the `live` or `test` mode of
        the API key used. Returns the most recent disputes first. Use the
        `status`, `resource_id`, `since`, and `until` query parameters to filter
        the list.
      operationId: disputes-list
      parameters:
        - name: status
          in: query
          required: false
          description: >-
            Filter by dispute status. One of `waiting_documentation`,
            `in_review`, `won`, `lost`, `expired`. Accepts a comma-separated
            list.
          schema:
            type: string
        - name: resource_id
          in: query
          required: false
          description: Filter by the `id` of the disputed resource (the payment intent).
          schema:
            type: string
        - name: since
          in: query
          required: false
          description: >-
            ISO 8601 datetime in UTC that filters disputes created on or after
            the provided time.
          schema:
            type: string
        - name: until
          in: query
          required: false
          description: >-
            ISO 8601 datetime in UTC that filters disputes created on or before
            the provided time.
          schema:
            type: string
      responses:
        '200':
          description: List of disputes for the current mode, most recent first.
          content:
            application/json:
              examples:
                disputes_list:
                  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:
                type: array
                items:
                  $ref: '#/components/schemas/dispute'
        '400':
          description: 'Invalid request: the `status` filter is not a valid value.'
          content:
            application/json:
              examples:
                invalid_status:
                  value:
                    error:
                      type: invalid_request_error
                      code: invalid_enum
                      param: status
                      message: >-
                        must be one of: waiting_documentation, in_review, won,
                        lost, expired
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
        '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'
      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

````