> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/invoice.md).

# Invoice

An invoice. Can be draft or a final invoiced invoice.

### Fields

#### city ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's city or town stored on the invoice.

#### collectionCase ([CollectionCase](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/collection-case.md))

The collection case this invoice is part of.

#### companyName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's company name stored on the invoice.

#### country ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The billing country code (ISO 3116) stored on the invoice.

#### createdAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md)!)

When the invoice record was first created.

#### currency ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

Currency used for this invoice

#### description ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The description of the invoice.

#### detailsUrl ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)!)

URL to view invoice details, PDF download, and manual payment link.

#### externalUrl ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

An external invoice URL that replaces the default invoice

#### fullAddress ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's full address by combining address and house number stored on the invoice.

#### fullName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's full name stored on the invoice.

#### id ([ID](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/id.md)!)

The database ID of this invoice.

#### invoiceLineItems (\[[InvoiceLineItem](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/invoice-line-item.md)!])

The line items of this invoice.

#### invoiceNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)!)

The formatted (legal) invoice number.

#### invoiceReminders (\[[InvoiceReminder](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/invoice-reminder.md)!])

The reminders for this invoice.

#### invoiceStatus ([InvoiceStatusEnum](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/invoice-status-enum.md)!)

The payment status of the invoice.

#### invoicedAt ([ISO8601DateTime](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/iso-8601-date-time.md))

When the invoice was formally invoiced.

#### originalInvoice ([Invoice](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/invoice.md))

The associated original invoice for this invoice (only available for credit invoices)

#### payment ([Payment](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/payment.md))

The associated payment for this invoice. Can be null if this order didn't require payment.

#### phoneNumber ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's full international phone number stored on the invoice.

#### salutation ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's salutation (mr,ms,mx) stored on the invoice.

#### state ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's state stored on the invoice.

#### ~~status (~~[~~String~~](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)~~!)~~

*`Deprecated: Use the 'invoice_status' field instead.`*

#### subscription ([Subscription](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/subscription.md))

The associated subscription. Can be null in case of an archived subscription.

#### subscriptionId ([ID](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/id.md)!)

ID of the associated subscription.

#### taxPercentage ([Float](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/float.md))

The percentage of tax used for this invoice.

#### totalAmountCents ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md)!)

Total amount of invoice in cents.

#### totalTaxAmountCents ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md)!)

Total tax amount of invoice in cents.

#### zipcode ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))

The customer's postal code or zipcode stored on the invoice.