# Retrieve an invoice

Retrieves a specific invoice by its unique identifier, including all invoice details, line items, and payment information.

Endpoint: GET /invoices/{id}
Version: 1.0

## Path parameters:

  - `id` (string, required)
    Unique identifier of the invoice
    Example: "84c413b1-cda9-4637-a75d-352e36274bf2"

## Header parameters:

  - `cc-api-key` (string, required)
    Chaching API Key

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the object.
    Example: "a80baa67-1341-4184-b712-b6f9b85b5a2b"

  - `object` (string, required)
    String representing the object’s type.
    Enum: "invoice"

  - `account_country` (string,null)
    Country of the account associated with the invoice (only US is supported).
    Enum: "US"

  - `account_name` (string,null)
    Name of the account associated with the invoice.
    Example: "Acme Corp"

  - `amount_due` (number, required)
    Final amount due at this time for this invoice (in cents for USD).
    Example: 1500

  - `amount_paid` (number,null)
    The amount, in cents, that was paid.
    Example: 500

  - `amount_remaining` (number,null)
    The difference between amount_due and amount_paid, in cents.
    Example: 1000

  - `attempt_count` (number,null)
    Number of payment attempts made for this invoice.
    Example: 1

  - `attempted` (boolean,null)
    Whether payment of this invoice was attempted.
    Example: true

  - `billing_reason` (string,null)
    Describes why this invoice was created.
    Enum: "subscription", "manual"

  - `collection_method` (string,null)
    Collection method of this invoice.
    Enum: "charge_automatically", "send_invoice"

  - `created` (number, required)
    Time at which the object was created. Measured in seconds since the Unix epoch
    Example: 1680645568

  - `currency` (string, required)
    Three-letter ISO currency code, in uppercase
    Example: "USD"

  - `customer` (string,null)
    ID of the customer associated with this invoice.
    Example: "cus_383fda0065594749023e8c8d"

  - `customer_address` (object)
    The customer’s address.

  - `customer_address.city` (string)
    City, district, suburb, town, or village.
    Example: "San Francisco"

  - `customer_address.country` (string)
    Two-letter country code(ISO 3166 - 1 alpha - 2).
    Example: "US"

  - `customer_address.line1` (string)
    Address line 1(e.g., street, PO Box, or company name).
    Example: "123 Market St"

  - `customer_address.line2` (string)
    Address line 2(e.g., apartment, suite, unit, or building).
    Example: "Apt 4B"

  - `customer_address.postal_code` (string)
    ZIP or postal code.
    Example: "94103"

  - `customer_address.state` (string)
    State, county, province, or region.
    Example: "CA"

  - `customer_email` (string, required)
    Email of the customer associated with the invoice.
    Example: "john.doe@example.com"

  - `customer_name` (string, required)
    Name of the customer associated with the invoice.
    Example: "John Doe"

  - `customer_phone` (string,null)
    Phone number of the customer.
    Example: "+1234567890"

  - `lines` (array, required)
    The individual line items that make up the invoice.

  - `number` (string, required)
    A unique, identifying string that appears on emails sent to the customer for this invoice.
    Example: "INV-1001"

  - `paid` (boolean, required)
    Whether payment was successfully collected for this invoice.
    Example: true

  - `period_end` (number,null)
    End of the usage period during which invoice items were added to this invoice.
    Example: 1680645568

  - `period_start` (number,null)
    Start of the usage period during which invoice items were added to this invoice.
    Example: 1680645568

  - `status` (string, required)
    The status of the invoice, one of draft, open, paid, or void.
    Enum: "draft", "open", "paid", "void"

  - `status_transitions` (object,null)
    The timestamps at which the invoice status was updated.

  - `status_transitions.finalized_at` (number,null, required)
    Timestamp when the invoice was marked as finalized.
    Example: 1680645568

  - `status_transitions.paid_at` (number,null, required)
    Timestamp when the invoice was marked as paid.
    Example: 1680645568

  - `status_transitions.voided_at` (number,null, required)
    Timestamp when the invoice was marked as voided.
    Example: 1680645568

  - `subscription` (string,null)
    The ID of the subscription that this invoice was prepared for, if any.
    Example: "sub_Wm45f5PGQvv67azFeH1z7PO3"

  - `subtotal` (number,null)
    Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied
    Example: 1500

  - `subtotal_excluding_tax` (number,null)
    The integer amount in cents representing the subtotal of the invoice before any invoice level discount or tax is applied
    Example: 1500

  - `tax` (number,null)
    The amount of tax on this invoice.
    Example: 150

  - `total` (number,null)
    Total after discounts and taxes.
    Example: 1650

  - `total_excluding_tax` (number,null)
    The integer amount in cents representing the total amount of the invoice including all discounts but excluding all tax.
    Example: 1500

  - `total_taxes` (object,null)
    The aggregate amounts calculated per tax rate for all line items.

  - `total_taxes.amount` (number, required)
    The amount of the tax, in cents.
    Example: 150

  - `total_taxes.tax_behavior` (string, required)
    Whether this tax is inclusive or exclusive.
    Enum: "exclusive", "inclusive"

  - `total_taxes.tax_rate` (string, required)
    Tax rate id.
    Example: "txr_1S2tlWDZYOQH9uHkltYEi1ap"

  - `total_taxes.taxable_amount` (number, required)
    The amount on which tax is calculated.
    Example: 1500


## Response 400 fields