Skip to main content
GET
/
fleets
/
{fleet}
/
invoices
List fleet’s invoices
curl --request GET \
  --url https://api.chargeapi.co/v1/fleets/{fleet}/invoices \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "object": "list",
  "url": "<string>",
  "has_more": true,
  "data": [
    {
      "id": null,
      "object": null,
      "amount_due": null,
      "amount_paid": null,
      "created": null,
      "currency": null,
      "due_date": null,
      "line_items": null,
      "paid_at": null,
      "period_end": null,
      "period_start": null,
      "status": null
    }
  ]
}

Path Parameters

​
fleet
string
required

ID of the fleet whose invoices you want to list.

Query Parameters

​
limit
integer

Maximum number of invoices to return (default 10).

Required range: 1 <= x <= 100
​
starting_after
string

Pagination cursor; returns items after this invoice ID.

​
ending_before
string

Pagination cursor; returns items before this invoice ID.

​
status
enum<string>

Filter results by invoice status.

Available options:
draft,
open,
paid,
void,
uncollectible
​
expand
string[]

Specifies related objects to expand in each invoice (for example, expand[]=line_items).

Body

application/json · object

Response

A dictionary with a data property that contains an array of up to limit Invoice objects belonging to the specified fleet, starting after Invoice starting_after. Each entry in data is a separate Invoice object. If no additional invoices are available, the array is empty.

​
object
enum<string>
required

Always list.

Available options:
list
​
url
string
required

Endpoint URL for this list.

​
has_more
boolean
required

True if additional pages are available.

​
data
object[]
required

Array of Invoice objects.