Sign in
Invoices

Retrieve invoice

Retrieves the details of an existing invoice.

Required permissions:

  • invoice:basic:read
get/invoices/{id}

Path parameters

idstring required
Example:inv_xxxxxxxxxxxxxx

The unique identifier of the invoice, or a secure token.

Response

A successful response

created_atstring date-time required

The datetime the invoice was created.

due_datestring date-time nullable required

The deadline by which payment is expected. Null if the invoice is collected automatically.

email_addressstring nullable required

The email address of the customer this invoice is addressed to. Null if no email is on file.

fetch_invoice_tokenstring required

A signed token that allows fetching invoice data publicly without authentication.

idstring required

The unique identifier for the invoice.

numberstring required

The sequential invoice number for display purposes.

status'draft' | 'open' | 'paid' | 'past_due' | 'uncollectible' | 'void' required

The different statuses an invoice can be in

Example response

{
  "created_at": "2023-12-01T05:00:00.401Z",
  "current_plan": {
    "formatted_price": "$10.00",
    "id": "plan_xxxxxxxxxxxxx"
  },
  "due_date": "2023-12-01T05:00:00.401Z",
  "email_address": "customer@example.com",
  "fetch_invoice_token": "eyJhbGciOiJIUzI1NiJ9...",
  "id": "inv_xxxxxxxxxxxxxx",
  "line_items": [
    {
      "label": "Platform subscription",
      "position": 42,
      "quantity": 6.9,
      "total": 6.9,
      "unit_price": 6.9
    }
  ],
  "number": "#0001",
  "user": {
    "id": "user_xxxxxxxxxxxxx",
    "name": "John Doe",
    "username": "johndoe42"
  }
}

Changes