---
title: "Return all invoices associated to the batch debit"
method: GET
path: "/batchDebits/{id}/invoices"
tags: ["accounting"]
---

# Return all invoices associated to the batch debit

`GET /batchDebits/{id}/invoices`

## Request

- Base URL: `https://demo-developer.convoy.com/broker`
- URL: `https://demo-developer.convoy.com/broker/batchDebits/{id}/invoices`
- Auth: HTTP bearer

Returns all invoices associated to a batch debit specified by the `id`.
The number of invoices can be large (e.g. 10k invoices), so you must paginate.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `X-Convoy-API-Version` string, required

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- GetInvoicesResponse
  - `invoices` LoadInvoiceBilled[], required
    - `id` string, uuid, required
    - `loadExternalId` string, required: Unique ID for the load in the consumer's external system.
    - `invoiceNumber` string, required: A short, unique name for the invoice used for human-readable identification.
    - `status` 'BILLED', required: The status of the invoice. It is always BILLED for now.
    - `dueDate` string, date-time, required: The due date of the invoice. It is the date when the invoice is due to be paid by the carrier.
    - `lineItems` LineItem[], required: The line items of the invoice. It lists all the fees that are included in the invoice.
      - `id` string, uuid, required: Unique ID for the line item.
      - `type` 'ADDITIONAL_CHARGE' | 'BROKER_PLATFORM_SERVICES' | 'DETENTION' | 'DRIVER_ASSIST' | 'EXTRA_MILES' | 'EXTRA_STOPS' | 'FUEL' | 'LAYOVER' | 'LUMPER' | 'REDELIVERY' | 'RETURN' | 'TRANSPORTATION_SERVICES' | 'TRUCK_ORDER_NOT_USED' | 'OTHER', required: The type of the fee. * `ADDITIONAL_CHARGE` - Generic term for any additional charge that may be added by the customer doesn't fit under any of the other categories (rarely used) * `BROKER_PLATFORM_SERVICES` - Fee derived from the entire cost of a shipment that is run through the Convoy Platform * `DETENTION` - Fee associated with excessive wait times at a given stop * `DRIVER_ASSIST` - Fee added to a shipment if the driver has to/is expected to help with loading/unloading a shipment * `EXTRA_MILES` - Fee based on any additional miles that a driver may have to drive for a shipment (i.e. driver arrives at the delivery address provided in the app/ratecon but they're re-routed to a different facility 10 miles away) * `EXTRA_STOPS` - Fee added for any additional stops that are added that were not in the app/ratecon * `FUEL` - Extra charge added for fuel * `LAYOVER` - Fee associated with a driver having to hold onto a shipment for more than 6 hours past the original appointment time * `LUMPER` - Fee paid to facility workers for unloading/stacking/sorting product off of or onto a truck * `REDELIVERY`, `RETURN` - Fee associated with any time a shipment has all or some of the load refused at delivery, causing it to be returned to pickup or delivered to another location * `TRANSPORTATION_SERVICES` - Truck cost at the time of booking * `TRUCK_ORDER_NOT_USED` - (TONU) Fee paid out to a carrier if the booked shipment is canceled 4 hours or less prior to pickup * `OTHER` - Similar to `ADDITIONAL_CHARGE`
      - `amountCents` integer, required: The amount of the fee in cents.
    - `invoiceDocumentUrl` string, required: The url link to the invoice. It is a pdf file to be downloaded and the link is valid for one hour.
    - `broker` BrokerProfile: A broker
      - `externalId` string: The unique identifier for the broker in the broker's TMS
      - `mcNumber` string: The broker's FMCSA Operating Authority (MC number)
      - `dotNumber` string: The broker's FMCSA USDOT number
  - `cursor` string

## Other responses

- `400`: Invalid request. No loads were created or updated.
- `default`: Unexpected error

---

[API](https://skmtc.dev/convoy/apis/brokers.md) - [All operations](https://skmtc.dev/convoy/apis/brokers/llms.txt) - [OpenAPI document](https://skmtc.dev/convoy/apis/brokers/revisions/a43e2868b355?raw)