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

# List Disputes for a PayIn

### Path parameters

<ParamField path="PayInId" type="string" required>
  The unique identifier of the pay-in.
</ParamField>

### Query parameters

<ParamField query="BeforeDate" type="Unix timestamp">
  The date before which the object was created (based on the object's `CreationDate` parameter). You can filter on a specific time range by using both the `AfterDate` and `BeforeDate` query parameters.
</ParamField>

<ParamField query="AfterDate" type="Unix timestamp">
  The date after which the object was created (based on the object's `CreationDate` parameter). You can filter on a specific time range by using both the `AfterDate` and `BeforeDate` query parameters.
</ParamField>

<ParamField query="Status" type="string">
  **Allowed values:** `CREATED`, `PENDING_CLIENT_ACTION`, `SUBMITTED`, `PENDING_BANK_ACTION`, `CLOSED`, `REOPENED_PENDING_CLIENT_ACTION`

  The status of the Dispute. You can filter on multiple values by separating them with a comma.
</ParamField>

<ParamField query="DisputeType" type="string">
  **Allowed values:** `CONTESTABLE`, `NOT_CONTESTABLE`, `RETRIEVAL`

  The type of the Dispute. You can filter on multiple values by separating them with a comma.
</ParamField>

### Responses

<AccordionGroup>
  <Accordion title="200">
    <ResponseField name="Array (Disputes)" type="array">
      The list of disputes automatically created by Mangopay.

      <Expandable title="properties">
        <ResponseField name="Object (Dispute)" type="object">
          The dispute automatically created by Mangopay.

          <Expandable title="properties">
            <ResponseField name="InitialTransactionId" type="string">
              The unique identifier of the initial pay-in being disputed.
            </ResponseField>

            <ResponseField name="InitialTransactionType" type="string">
              **Returned values:** `PAYIN`

              The type of the initial transaction being disputed.
            </ResponseField>

            <ResponseField name="InitialTransactionNature" type="string">
              **Returned values:** `REGULAR`, `REPUDIATION`, `REFUND`, `SETTLEMENT`

              The nature of the initial transaction being refunded, providing more information about the context in which the transaction occurred:

              * REGULAR – Relative to most of the transactions (pay-ins, payouts, and transfers) in a usual workflow.
              * REPUDIATION – Automatic withdrawal of funds from the platform’s repudiation wallet as part of the dispute process (when the user requested a chargeback).
              * REFUND – Reimbursement of a transaction to the user (pay-in refund), to a wallet (transfer refund), or of a payout (payout refund, only initiated by Mangopay).
              * SETTLEMENT – Transfer made to the repudiation wallet by the platform to settle the credit from a repudiation following a lost dispute.
            </ResponseField>

            <ResponseField name="DisputeType" type="string">
              **Returned values:** `CONTESTABLE`, `NOT_CONTESTABLE`, `RETRIEVAL`

              The type of dispute:

              * `CONTESTABLE` – Dispute for which the chargeback can be contested by providing proof (i.e., Dispute Documents) justifying the original transaction.
              * `NOT_CONTESTABLE` – Dispute that is automatically closed after its creation, without any action possible for the platform.
              * `RETRIEVAL` – Dispute that is actually a chargeback warning issued by the bank. The platform is required to provide documents, but no funds will be taken from the Repudiation Wallet.
            </ResponseField>

            <ResponseField name="ContestDeadlineDate" type="Unix timestamp">
              The date and time until which the platform can contest the dispute (i.e., the `Status` is set to `SUBMITTED`). This date is defined by the issuing bank of the initial transaction and may usually vary between 7 to 18 days. Once the deadline passes, the dispute `Status` is automatically set to `CLOSED`.
            </ResponseField>

            <ResponseField name="DisputedFunds" type="string">
              Information about the disputed funds.\
              Note: This amount can be lower than the initial transaction amount.

              <Expandable title="properties">
                <ResponseField name="Currency" type="string">
                  **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

                  The currency of the funds.
                </ResponseField>

                <ResponseField name="Amount" type="integer">
                  An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`).
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="ContestedFunds" type="object">
              Information about the contested funds, in other words, the amount that you wish to contest.\
              Note: This amount can be lower than the disputed funds amount.

              <Expandable title="properties">
                <ResponseField name="Currency" type="string">
                  **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

                  The currency of the funds.
                </ResponseField>

                <ResponseField name="Amount" type="integer">
                  An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`).
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="Status" type="string">
              **Returned values:** `CREATED`, `PENDING_CLIENT_ACTION`, `SUBMITTED`, `PENDING_BANK_ACTION`, `REOPENED_PENDING_CLIENT_ACTION`, `CLOSED`

              The status of the dispute:

              * `CREATED` – The dispute is created.
              * `PENDING_CLIENT_ACTION` – The dispute was not closed automatically upon its creation, it now requires some actions from the platform (either submission after providing the relevant proofs or closing).
              * `SUBMITTED` – The dispute is submitted by the platform for the Mangopay team to review the documents.
              * `PENDING_BANK_ACTION` – Mangopay accepted the documents and passed them on to the bank for them to review the dispute contestation. They will either reject or accept the contestation, or require further documents.
              * `REOPENED_PENDING_CLIENT_ACTION` – Mangopay didn’t accept the documents and requires more information or documents before sending the documents to the bank.
              * `CLOSED` – The dispute is closed.
            </ResponseField>

            <ResponseField name="StatusMessage" type="string">
              Additional information about the dispute `Status` communicated by Mangopay teams.
            </ResponseField>

            <ResponseField name="DisputeReason" type="object">
              Information about the reasons for the dispute.

              <Expandable title="properties" defaultOpen>
                <ResponseField name="DisputeReasonType" type="string">
                  The reason for the dispute.
                </ResponseField>

                <ResponseField name="DisputeReasonMessage" type="string">
                  Max. length: 255 characters

                  Additional information about the reason for the dispute sent by Mangopay teams.
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="ResultCode" type="string">
              **Returned values:** `LOST`, `WON`, `VOID`

              The result of the dispute for the platform, which can be:

              * `LOST` – The platform lost the dispute and must settle its debt to Mangopay with a Settlement Transfer.
              * `WON` – The platform won the dispute, the disputed funds will be credited back to the Repudiation Wallet.
              * `VOID` – The dispute has been canceled.
            </ResponseField>

            <ResponseField name="ResultMessage" type="string">
              The explanation of the result code.
            </ResponseField>

            <ResponseField name="Id" type="string">
              Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details)

              The unique identifier of the object.
            </ResponseField>

            <ResponseField name="Tag" type="string">
              Max. length: 255 characters

              Custom data that you can add to this object.
            </ResponseField>

            <ResponseField name="CreationDate" type="Unix timestamp">
              The date and time at which the object was created.
            </ResponseField>

            <ResponseField name="ClosedDate" type="Unix timestamp">
              The date and time the dispute was closed (i.e., its `Status` is set to `CLOSED`).\
              Note: This value will be `null` for any Dispute closed before February 16th, 2023.
            </ResponseField>

            <ResponseField name="RepudiationId" type="string">
              The unique identifier of the repudiation.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Accordion>
</AccordionGroup>

<ResponseExample>
  ```json 200 theme={null}
  [
      {
          "InitialTransactionId": "158596153",
          "InitialTransactionType": "PAYIN",
          "InitialTransactionNature": "REGULAR",
          "DisputeType": "CONTESTABLE",
          "ContestDeadlineDate": 1673049599,
          "DisputedFunds": {
              "Currency": "EUR",
              "Amount": 1200
          },
          "ContestedFunds": {
              "Currency": "EUR",
              "Amount": 1200
          },
          "Status": "PENDING_CLIENT_ACTION",
          "StatusMessage": null,
          "DisputeReason": {
              "DisputeReasonMessage": "This is a test dispute",
              "DisputeReasonType": "UNKNOWN"
          },
          "ResultCode": "",
          "ResultMessage": null,
          "Id": "159102965",
          "Tag": null,
          "CreationDate": 1672411848,
          "ClosedDate": null,
          "RepudiationId": "159102966"
      }
  ]  
  ```
</ResponseExample>

<RequestExample>
  ```
  ```
</RequestExample>