# getInvoice

### Arguments

| Argument                                                                           | Description |
| ---------------------------------------------------------------------------------- | ----------- |
| token ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id)) |             |
| id ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id))    |             |

### Return fields

#### city ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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

#### collectionCase ([CollectionCase](https://developer.firmhouse.com/graphql-api/api-reference/objects/collection-case))

The collection case this invoice is part of.

#### companyName ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

The customer's company name stored on the invoice.

#### country ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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

#### createdAt ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time)!)

When the invoice record was first created.

#### currency ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

Currency used for this invoice

#### description ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

The description of the invoice.

#### detailsUrl ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string)!)

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

#### externalUrl ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

An external invoice URL that replaces the default invoice

#### fullAddress ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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

#### fullName ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

The customer's full name stored on the invoice.

#### id ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id)!)

The database ID of this invoice.

#### invoiceLineItems (\[[InvoiceLineItem](https://developer.firmhouse.com/graphql-api/api-reference/objects/invoice-line-item)!])

The line items of this invoice.

#### invoiceNumber ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string)!)

The formatted (legal) invoice number.

#### invoiceReminders (\[[InvoiceReminder](https://developer.firmhouse.com/graphql-api/api-reference/objects/invoice-reminder)!])

The reminders for this invoice.

#### invoiceStatus ([InvoiceStatusEnum](https://developer.firmhouse.com/graphql-api/api-reference/objects/invoice-status-enum)!)

The payment status of the invoice.

#### invoicedAt ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time))

When the invoice was formally invoiced.

#### nextInstalmentChargeDate ([ISO8601Date](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date))

The next instalment charge date for this invoice. Is empty if the last instalment of the invoice has already been charged or the invoice is being paid in 1 instalment.

#### originalInvoice ([Invoice](https://developer.firmhouse.com/graphql-api/api-reference/objects/invoice))

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

#### paidAt ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time))

The date and time when the invoice was paid.

#### payment ([Payment](https://developer.firmhouse.com/graphql-api/api-reference/objects/payment))

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

#### payments ([PaymentConnection](https://developer.firmhouse.com/graphql-api/api-reference/objects/payment-connection))

The payment instalments for the invoice

| Argument                                                                                    | Description                                                             |
| ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| after ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))  | Returns the elements in the list that come after the specified cursor.  |
| before ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string)) | Returns the elements in the list that come before the specified cursor. |
| first ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int))        | Returns the first *n* elements from the list.                           |
| last ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int))         | Returns the last *n* elements from the list.                            |

#### phoneNumber ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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

#### salutation ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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

#### state ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

The customer's state stored on the invoice.

#### ~~status (~~[~~String~~](https://developer.firmhouse.com/graphql-api/api-reference/objects/string)~~!)~~

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

#### subscription ([Subscription](https://developer.firmhouse.com/graphql-api/api-reference/objects/subscription))

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

#### subscriptionId ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id)!)

ID of the associated subscription.

#### taxPercentage ([Float](https://developer.firmhouse.com/graphql-api/api-reference/objects/float))

The percentage of tax used for this invoice.

#### totalAmountCents ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int)!)

Total amount of invoice in cents.

#### totalTaxAmountCents ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int)!)

Total tax amount of invoice in cents.

#### zipcode ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string))

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