---
updatedAt: 2025-11-10T23:57:53.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# Get Dispute Batches

Use this endpoint to retrieve available dispute batches

**REQUEST**

| Field Name | Description                            | Type   | Required | Constraints            |
| :--------- | :------------------------------------- | :----- | :------- | :--------------------- |
| pageNum    | The number of the page to start from.  | String | Optional | Default: 1             |
| pageSize   | The number of items returned per page. | String | Optional | Default: 100. Max: 100 |

Sample Request

\{\{base\_url}}/api/v1/disputes/batches?pageNum=1\&pageSize=5

RESPONSE

| Field Name         | Description                             | Type       | Constraints                                                                                    |
| :----------------- | :-------------------------------------- | :--------- | :--------------------------------------------------------------------------------------------- |
| domainCode         | The domain code of the uploader         | String     |                                                                                                |
| domain             | The n                                   |            |                                                                                                |
| transactionGroup   | The transaction group                   | String     | [See Get Transaction Groups](get-transaction-groups)                                           |
| transactionChannel | The channel of the transaction.         | String     | [See Get Transaction Groups](get-transaction-groups)                                           |
| disputeCategory    | The name of the dispute category        | Enum       | INQUIRY, CHARGEBACK, GOVERNMENT\_BILLER, TSA\_BILLER, REFUND, GOOD\_FAITH, CO\_ACQUIRED, FRAUD |
| batchFile          | The name of the file                    | String     |                                                                                                |
| recordCount        | The total number of records in the file | Integer    |                                                                                                |
| processedCount     | The total number of processed records   | Integer    |                                                                                                |
| errorCount         | The total number of failed records      | Integer    |                                                                                                |
| status             | The processing status of the file       | String     |                                                                                                |
| createdBy          | The user that created the file          | String     |                                                                                                |
| createdOn          | The time the file was created           | DateTime   |                                                                                                |
| count              | The total number of records available   | Integer    |                                                                                                |
| content            | An array of the returned records        | JSON Array |                                                                                                |

Sample Response

```json
{
    "count": 205,
    "content": [
        {
            "domainCode": "ISW",
            "domain": "INTERSWITCH",
            "transactionGroup": "Bill Payment",
            "transactionChannel": "All",
            "disputeCategory": "Chargeback",
            "batchFile": "ISW-2023-09-29-733C41F1-6A39-4D52-A6BF-6C07DE1A973C.xlsx",
            "recordCount": 3,
            "processedCount": 3,
            "errorCount": 3,
            "status": "Completed",
            "createdBy": "Jideobi.Onuora@ISW",
            "createdOn": "2023-09-29T00:26:31.157Z",
            "lastUpdatedOn": "2023-09-29T00:29:21.477Z"
        },
        {
            "domainCode": "ISW",
            "domain": "INTERSWITCH",
            "transactionGroup": "Transfer Service",
            "transactionChannel": "All",
            "disputeCategory": "Chargeback",
            "batchFile": "ISW-2023-09-28-255A094E-DA80-496B-AF9B-1AEC5AF76384.xls",
            "recordCount": 1,
            "processedCount": 1,
            "errorCount": 0,
            "status": "Completed",
            "createdBy": "Ayobami.Ajibade@ISW",
            "createdOn": "2023-09-28T17:05:58.86Z",
            "lastUpdatedOn": "2023-09-28T17:06:57.547Z"
        },
        {
            "domainCode": "ISW",
            "domain": "INTERSWITCH",
            "transactionGroup": "IPG",
            "transactionChannel": "All",
            "disputeCategory": "Chargeback",
            "batchFile": "ISW-2023-09-28-34C0CDD8-3309-4F65-B72B-B02FCE45108A.xls",
            "recordCount": 1,
            "processedCount": 1,
            "errorCount": 0,
            "status": "Completed",
            "createdBy": "Ayobami.Ajibade@ISW",
            "createdOn": "2023-09-28T11:06:04.54Z",
            "lastUpdatedOn": "2023-09-28T11:07:43.837Z"
        },
        {
           "domainCode": "ISW",
            "domain": "INTERSWITCH",
            "transactionGroup": "Bill Payment",
            "transactionChannel": "All",
            "disputeCategory": "Chargeback",
            "batchFile": "ISW-2023-09-28-E9CEF254-59FC-4D32-BB16-992E6174185D.xlsx",
            "recordCount": 3,
            "processedCount": 0,
            "errorCount": 0,
            "status": "Cancelled",
            "createdBy": "Jideobi.Onuora@ISW",
            "createdOn": "2023-09-28T10:30:28.95Z",
            "lastUpdatedOn": "2023-09-28T11:03:21.357Z"
        },
        {
            "domainCode": "ISW",
            "domain": "INTERSWITCH",
            "transactionGroup": "CASH WITHDRAWAL",
            "transactionChannel": "ALL",
            "disputeCategory": "Chargeback",
            "batchFile": "ISW-2023-09-25-91EF6EE3-7225-45BA-B6BF-60D200360BCD.xls",
            "recordCount": 5,
            "processedCount": 5,
            "errorCount": 1,
            "status": "Completed",
            "createdBy": "Ayobami.Ajibade@ISW",
            "createdOn": "2023-09-25T10:50:18.633Z",
            "lastUpdatedOn": "2023-09-25T10:52:56.207Z"
        }
    ]
}
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "ipg",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sandbox.interswitchng.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/arbiter/api/v1/disputes/batches": {
      "get": {
        "summary": "Get Dispute Batches",
        "description": "Use this endpoint to retrieve available dispute batches",
        "operationId": "get-dispute-batches",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```