---
title: Invoices API
summary: Get information on current and past invoices.
url: https://www.fastly.com/documentation/reference/api/account/invoices
---

Get information on current and past invoices.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `billing_end_date` | string | Date and time (in ISO 8601 format) for termination point of a billing cycle, signifying the end of charges for a service or subscription. |
| `billing_start_date` | string | Date and time (in ISO 8601 format) for initiation point of a billing cycle, signifying the start of charges for a service or subscription. |
| `currency_code` | string | Three-letter code representing a specific currency used for financial transactions. |
| `customer_id` | string | Customer ID associated with the invoice. |
| `invoice_id` | string | Numeric string identifying the invoice. |
| `invoice_posted_on` | string | Date and time invoice was posted on, in ISO 8601 format. |
| `monthly_transaction_amount` | number | Total billable amount for invoiced services charged within a single month. |
| `statement_number` | string | Alphanumeric string identifying the statement number. |
| `transaction_line_items` | array |  |
| `amount` | number | Billed amount for line item. |
| `credit_coupon_code` | string | Discount coupon associated with the invoice for any account or service credits. |
| `description` | string | Invoice line item transaction name. |
| `product_group` | string | The broader classification of the product (e.g., <code>Compute</code> or <code>Full-Site Delivery</code>). |
| `product_line` | string | The broader classification of the product (e.g., <code>Network Services</code> or <code>Security</code>). |
| `product_name` | string | The name of the product. |
| `rate` | number | Price per unit. |
| `region` | string | The geographical area applicable for regionally based products. |
| `units` | number | Total number of units of usage. |
| `usage_type` | string | The unit of measure (e.g., <code>requests</code> or <code>bandwidth</code>). |
| `meta` | object | Pagination metadata. |
| `limit` | integer | The number of invoices included in the response. |
| `next_cursor` | string | The token used to request the next set of results. |
| `sort` | string | The sort order of the invoices in the response. |
| `total` | integer | Total number of records available on the backend. |

## API endpoints

### List of invoices

**GET** `/billing/v3/invoices`

Returns the list of invoices, sorted by billing start date (newest to oldest).

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `billing_end_date` | string | query | No | Filter invoices by billing end date. |
| `billing_start_date` | string | query | No | Filter invoices by billing start date. |
| `cursor` | string | query | No | Cursor value from the <code>next_cursor</code> field of a previous response, used to retrieve the next page. To request the first page, this should be empty. |
| `limit` | string | query | No | Number of results per page. The maximum is 200. |

### Get invoice by ID

**GET** `/billing/v3/invoices/{invoice_id}`

Returns invoice associated with the invoice id.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `invoice_id` | integer | path | Yes |  |

### Get month-to-date invoice

**GET** `/billing/v3/invoices/month-to-date`

Returns month-to-date invoice for the current month.