# List a rebill's disputes

`GET https://api.mothership.com/beta/rebills/{rebillId}/disputes`

Sandbox: `https://sandbox.api.mothership.com/beta/rebills/{rebillId}/disputes`

Lists the disputes on a rebill, oldest first. Each line item has at most one. Dispute a charge from your dashboard.

Lists the disputes on a rebill, oldest first. Each is also the `dispute` of its line item in [Retrieve a rebill](https://docs.mothership.com/reference/fetchrebillbyid), and `lineItemId` names that line item. A rebill nobody disputed returns an empty `results`.

Disputing a charge, and answering when the status is `info-needed`, happen on the [Billing page in your dashboard](https://dashboard.mothership.com/billing). [Rebills](https://docs.mothership.com/reference/rebills#dispute-statuses) explains each status.

## Authorization

Send your API token as a Bearer token: `Authorization: Bearer <token>`.

## Path parameters

- `rebillId` (string, required): The ID of the rebill, or its reference number, such as MSSR5016101.

## Responses

### 200

The rebill's disputes, inside `data`.

- `data` (object, required)
  - `rebillId` (string, required): The ID of the rebill.
  - `results` (array of objects, required): The rebill's disputes, oldest first.
    - `id` (string, required): The ID of the dispute.
    - `lineItemId` (string, required): The ID of the line item the dispute is about.
    - `status` (string, required): Where the dispute is. The Rebills reference page explains each status. One of: `under-review`, `with-carrier`, `info-needed`, `resolved-approved`, `resolved-waived-approved`, `resolved-charged`, `withdrawn`, `voided`.
    - `reason` (string, required, nullable): The reason you picked when you disputed the charge, such as Wasn't performed.
    - `message` (string, required, nullable): Your explanation of why the charge is wrong.
    - `infoRequested` (string, required, nullable): What Mothership last asked you to send while the status was info-needed, or null when Mothership has not asked for anything.
    - `fileIds` (array of strings, required): The files you attached to the dispute. Download one with Retrieve a file.
    - `createdAt` (string, required): ISO string of when you disputed the charge.
    - `updatedAt` (string, required): ISO string of when the dispute last changed.

## Example request

```bash
curl --request GET \
  --url 'https://sandbox.api.mothership.com/beta/rebills/MSSR5016101/disputes' \
  --header "Authorization: Bearer $MOTHERSHIP_API_TOKEN" \
  --header 'Accept: application/json'
```

## Example response (200)

```json
{
  "data": {
    "rebillId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "results": [
      {
        "id": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lineItemId": "6fa459ea-ee8a-4ca4-894e-db77e160355e",
        "status": "info-needed",
        "reason": "Wasn't performed",
        "message": "The receiver unloaded the truck within the free time.",
        "infoRequested": "Please send the delivery receipt showing the check-in and check-out times.",
        "fileIds": ["3f1c2a9e-5b7d-4e8a-9c61-2d4f8b0e7a15"],
        "createdAt": "2026-03-20T15:12:44.000Z",
        "updatedAt": "2026-03-22T14:05:31.000Z"
      }
    ]
  }
}
```