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

# List disputes

> Returns a paginated list of card disputes, newest first. Filter by status, reason, category, card, transaction, or filed time range. No status default is applied.



## OpenAPI

````yaml /api-reference/openapi.json get /disputes/
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sandbox.api.reap.global
    description: Sandbox
  - url: https://prod.api.reap.global
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Disputes
  - name: Fiat Deposits
  - name: Fraud Alerts
  - name: Policies
  - name: Simulation
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
paths:
  /disputes/:
    get:
      tags:
        - Disputes
      summary: List disputes
      description: >-
        Returns a paginated list of card disputes, newest first. Filter by
        status, reason, category, card, transaction, or filed time range. No
        status default is applied.
      operationId: list_disputes
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            examples:
              - 20
              - 50
              - 100
            description: 'Maximum number of items to return (1-100, default: 20)'
            type: integer
            exclusiveMinimum: 0
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            description: >-
              Opaque cursor for pagination. Pass nextCursor from previous
              response to get next page.
            type: string
        - name: status
          in: query
          required: false
          schema:
            description: Filter by dispute status (comma-separated)
            type: array
            items:
              type: string
              enum:
                - PENDING_SIGNATURE
                - RECEIVED
                - REVIEWING
                - SUBMITTED
                - WON
                - LOST
                - REFUNDED
                - DECLINED
                - CANCELED
              description: >-
                - `PENDING_SIGNATURE`: Cardholder must sign a form before the
                case can progress

                - `RECEIVED`: Dispute has been recorded and is awaiting review

                - `REVIEWING`: Dispute is under internal review

                - `SUBMITTED`: Dispute has been submitted to the card network

                - `WON`: Dispute resolved in favour of the cardholder

                - `LOST`: Dispute was filed and Visa ruled for the merchant

                - `REFUNDED`: Dispute resulted in a refund

                - `DECLINED`: Reap did not file the case with the network

                - `CANCELED`: Dispute was canceled
              example: PENDING_SIGNATURE
        - name: reason
          in: query
          required: false
          schema:
            description: Filter by dispute reason (comma-separated)
            type: array
            items:
              type: string
              enum:
                - FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT
                - FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT
                - FRAUD_OTHER_CARD_PRESENT
                - FRAUD_OTHER_CARD_ABSENT
                - FRAUD_VISA_MONITORING_PROGRAM
                - AUTHORIZATION_CARD_RECOVERY_BULLETIN
                - AUTHORIZATION_DECLINED
                - AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT
                - PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE
                - PROCESSING_ERROR_INCORRECT_CURRENCY
                - PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER
                - PROCESSING_ERROR_INCORRECT_AMOUNT
                - PROCESSING_ERROR_DUPLICATE_PROCESSING
                - PROCESSING_ERROR_INVALID_DATA
                - CONSUMER_MERCHANDISE_NOT_RECEIVED
                - CONSUMER_CANCELLED_RECURRING
                - CONSUMER_NOT_AS_DESCRIBED
                - CONSUMER_COUNTERFEIT_MERCHANDISE
                - CONSUMER_MISREPRESENTATION
                - CONSUMER_CREDIT_NOT_PROCESSED
                - CONSUMER_CANCELLED_MERCHANDISE
                - CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED
                - CONSUMER_NON_RECEIPT_CASH_ATM
              description: >-
                - `FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT`: A counterfeit copy of
                the card was used in person

                - `FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT`: The genuine card
                was used in person by someone else after being lost or stolen

                - `FRAUD_OTHER_CARD_PRESENT`: Fraudulent use of the card in
                person that no other fraud reason covers

                - `FRAUD_OTHER_CARD_ABSENT`: Fraudulent use of the card details
                online, by phone, or by mail

                - `FRAUD_VISA_MONITORING_PROGRAM`: Fraud at a merchant Visa has
                placed under its fraud monitoring program

                - `AUTHORIZATION_CARD_RECOVERY_BULLETIN`: The merchant charged
                the card without authorization while it was blocked

                - `AUTHORIZATION_DECLINED`: The merchant charged the card after
                the authorization was declined

                - `AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT`: The charge was never
                authorized, or was settled too long after authorization

                - `PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE`: The transaction
                was processed as the wrong type, such as a charge instead of a
                refund

                - `PROCESSING_ERROR_INCORRECT_CURRENCY`: The transaction was
                processed in the wrong currency

                - `PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER`: The transaction
                was posted to the wrong card number

                - `PROCESSING_ERROR_INCORRECT_AMOUNT`: The transaction was
                processed for the wrong amount

                - `PROCESSING_ERROR_DUPLICATE_PROCESSING`: The same purchase was
                charged more than once, or was already paid by other means

                - `PROCESSING_ERROR_INVALID_DATA`: The transaction was processed
                with invalid or incorrect data

                - `CONSUMER_MERCHANDISE_NOT_RECEIVED`: The goods or services
                were never received

                - `CONSUMER_CANCELLED_RECURRING`: A recurring charge was taken
                after the cardholder cancelled

                - `CONSUMER_NOT_AS_DESCRIBED`: The goods or services were not as
                described, or arrived defective

                - `CONSUMER_COUNTERFEIT_MERCHANDISE`: The goods received were
                counterfeit

                - `CONSUMER_MISREPRESENTATION`: The merchant misrepresented what
                was being sold

                - `CONSUMER_CREDIT_NOT_PROCESSED`: The merchant agreed to a
                refund but never processed it

                - `CONSUMER_CANCELLED_MERCHANDISE`: The cardholder cancelled the
                order or returned the goods and was not refunded

                - `CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED`: A payment pushed to
                the card was not accepted by the cardholder

                - `CONSUMER_NON_RECEIPT_CASH_ATM`: An ATM debited the card
                without dispensing the cash
              example: FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT
        - name: category
          in: query
          required: false
          schema:
            description: Filter by dispute category (comma-separated)
            type: array
            items:
              type: string
              enum:
                - FRAUD
                - AUTHORIZATION
                - PROCESSING_ERROR
                - CONSUMER
              example: FRAUD
        - name: cardId
          in: query
          required: false
          schema:
            description: Filter by card ID
            type: string
            format: uuid
        - name: transactionId
          in: query
          required: false
          schema:
            description: Filter by card transaction ID
            type: string
            format: uuid
        - name: filedFrom
          in: query
          required: false
          schema:
            description: >-
              Inclusive lower bound on when the dispute was filed. ISO 8601
              datetime.
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        - name: filedTo
          in: query
          required: false
          schema:
            description: >-
              Inclusive upper bound on when the dispute was filed. ISO 8601
              datetime.
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/CardDispute'
                      description: Card dispute resource
                  nextCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Cursor for next page, or null if no more items
                required:
                  - items
                  - nextCursor
components:
  schemas:
    CardDispute:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique dispute identifier
        transactionId:
          type: string
          format: uuid
          description: The card transaction being disputed
        cardId:
          type: string
          format: uuid
          description: Card used for the disputed transaction
        status:
          type: string
          enum:
            - PENDING_SIGNATURE
            - RECEIVED
            - REVIEWING
            - SUBMITTED
            - WON
            - LOST
            - REFUNDED
            - DECLINED
            - CANCELED
          description: Current dispute status
          example: PENDING_SIGNATURE
        reason:
          type: string
          enum:
            - FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT
            - FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT
            - FRAUD_OTHER_CARD_PRESENT
            - FRAUD_OTHER_CARD_ABSENT
            - FRAUD_VISA_MONITORING_PROGRAM
            - AUTHORIZATION_CARD_RECOVERY_BULLETIN
            - AUTHORIZATION_DECLINED
            - AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT
            - PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE
            - PROCESSING_ERROR_INCORRECT_CURRENCY
            - PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER
            - PROCESSING_ERROR_INCORRECT_AMOUNT
            - PROCESSING_ERROR_DUPLICATE_PROCESSING
            - PROCESSING_ERROR_INVALID_DATA
            - CONSUMER_MERCHANDISE_NOT_RECEIVED
            - CONSUMER_CANCELLED_RECURRING
            - CONSUMER_NOT_AS_DESCRIBED
            - CONSUMER_COUNTERFEIT_MERCHANDISE
            - CONSUMER_MISREPRESENTATION
            - CONSUMER_CREDIT_NOT_PROCESSED
            - CONSUMER_CANCELLED_MERCHANDISE
            - CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED
            - CONSUMER_NON_RECEIPT_CASH_ATM
          description: Why the cardholder is disputing the transaction
          example: FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT
        category:
          type: string
          enum:
            - FRAUD
            - AUTHORIZATION
            - PROCESSING_ERROR
            - CONSUMER
          description: The grouping the reason belongs to
          example: FRAUD
        requiresCardholderSignature:
          type: boolean
          description: Whether the cardholder must sign a form before the case can progress
        amount:
          $ref: '#/components/schemas/CardDisputeAmount'
        cardholder:
          $ref: '#/components/schemas/CardDisputeCardholder'
        resolvedAt:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            - type: 'null'
          description: When the dispute reached a final status, or null while open
        createdAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 timestamp of last update
      required:
        - id
        - transactionId
        - cardId
        - status
        - reason
        - category
        - requiresCardholderSignature
        - amount
        - cardholder
        - resolvedAt
        - createdAt
        - updatedAt
    CardDisputeAmount:
      type: object
      properties:
        value:
          type: number
          exclusiveMinimum: 0
          examples:
            - 100.5
            - 1234.99
          description: Disputed amount
        currency:
          description: Currency of the disputed amount
          type: string
          pattern: ^[A-Z]{3}$
      required:
        - value
        - currency
      description: The amount under dispute, which may be less than the transaction total
    CardDisputeCardholder:
      type: object
      properties:
        name:
          type: string
          description: Cardholder name on the case
        email:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
          description: Cardholder email on the case
        contactEmail:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
          description: Address that receives the dispute outcome
      required:
        - name
        - email
        - contactEmail
      description: Cardholder identity on the case
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````