---
title: "Get an invoice"
method: GET
path: "/ar/invoices/{invoiceId}"
tags: ["Invoices"]
---

# Get an invoice

`GET /ar/invoices/{invoiceId}`

Retrieve details of an invoice by its ID

## Path parameters

- `invoiceId` string, uuid, required — ID for the invoice.

## Response `200`

- ApiV1ArInvoiceResponse — The response type for an invoice in the api.
  - `achDebitEnabled` boolean, required — Whether or not the invoice can be paid via ach debit.
  - `amount` number, required — The total amount of the invoice line items plus taxes.
  - `canceledAt` string, yyyy-mm-ddThh:MM:ssZ, nullable — The time when the invoice was canceled.
  - `ccEmails` Email[], required — Emails to be CCed on invoice notifications/reminders.
  - `createdAt` string, yyyy-mm-ddThh:MM:ssZ, required — The timestamp when the invoice was created.
  - `creditCardEnabled` boolean, required — Whether or not the invoice can be paid via credit card. Requires stripe to be setup for the Mercury account.
  - `currencyCode` string, required — ISO 4217 currency code for the invoice (e.g. "USD", "EUR").
  - `customerId` string, uuid, required — Id of the customer the invoice was sent to.
  - `destinationAccountId` string, uuid, required — The Mercury account where invoice payments will be deposited. Use the /api/v1/accounts endpoint to list your accounts and find the corresponding id. Only checking and savings accounts are supported.
  - `dueDate` string, date, required — The due date the invoice should be paid by.
  - `id` string, uuid, required — The ID of the invoice.
  - `internalNote` string, nullable — Internal note for the invoice, visible by users in the mercury organization but not visible to payers.
  - `invoiceDate` string, date, required — The date of the invoice, set by the invoice creator and likely to be context specific to the type of transaction. i.e. it could be a date a service was performed, it does not need to be the date the invoice was created.
  - `invoiceNumber` string, required — The payer facing invoice number/identifier.
  - `lineItems` ApiV1ArLineItemData[], required — The line items for the invoice.
    - `name` string, required — the name of the line item
    - `quantity` number, double, required — the quantity of this item
    - `salesTaxRate` number, double, nullable — the sales tax applied to this item
    - `unitPrice` number, required — the price of one unit of the item before sales tax
  - `payerMemo` string, nullable — Memo for the payer of the invoice.
  - `poNumber` string, nullable — Purchase order number for the invoice if applicable.
  - `servicePeriodEndDate` string, date, nullable — The end date for the service period this invoice covers, if applicable. YYYY-MM-DD
  - `servicePeriodStartDate` string, date, nullable — The start date for the service period this invoice covers, if applicable. YYYY-MM-DD
  - `slug` string, required — Public slug for an invoice. Used to construct the pay page URL as well as the URL to retrieve the PDF of the invoice.
  - `status` 'Unpaid' | 'Paid' | 'Cancelled' | 'Processing', required — The status of the invoice.
  - `updatedAt` string, yyyy-mm-ddThh:MM:ssZ, required — The timestamp when the invoice was updated.
  - `useRealAccountNumber` boolean, required — Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead.

## Other responses

- `404` — `invoiceId` not found

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)