# Fetch an invoice

Retrieve an existing invoice by its ID.

Endpoint: GET /invoices/{invoice_id}
Version: V5
Security: basicAuth

## Path parameters:

  - `invoice_id` (string, required)
    ID of the invoice to retrieve

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the invoice.
    Example: "PMMlaE5wbg0"

  - `source` (string)
    Enum: "QUICKBOOKS", "MERCHANT_USER", "ADMIN_USER", "CUSTOMER_USER", "API"

  - `customer_id` (string)
    ID of the customer being charged.

  - `order_number` (string)
    Order number identifier.
    Example: "5055"

  - `number` (string)
    Invoice number identifier.
    Example: "Inv # 123"

  - `po_number` (string)
    PO number identifier.
    Example: "PO-555"

  - `notes` (string)
    Additional notes for the Customer
    Example: "Example of additional notes for Customer."

  - `line_items` (array)
    Line item data
    Example: []

  - `merchant_invoice_url` (string)
    The invoice PDF that you've uploaded to Resolve.
    Example: "https://www.example.com/invoice.pdf"

  - `resolve_invoice_url` (string)
    Resolve-issued invoice PDF with your invoice attached.
    Example: "https://www.example.com/resolve-invoice.pdf"

  - `resolve_invoice_status` (string)
    Shows current status of the Resolve-issued invoice PDF.

- not_generated - PDF wasn't created or queued for creation. Resolve PDFs
are generated when an invoice is sent.
- processing - PDF is in the process of being generated. Try to refetch the invoice
in a minute to get a resolve_invoice_url link.
- completed - PDF is generated, resolve_invoice_url points to the generated file.
    Enum: "not_generated", "processing", "completed"

  - `fully_paid` (boolean)
    Indicates whether the invoice is fully paid.
    Example: true

  - `fully_paid_at` (string)
    The date the invoice has been fully paid.
    Example: "2020-01-01T00:00:00.730Z"

  - `advanced` (boolean)
    Indicates whether the invoice has been advanced.

  - `due_at` (string)
    The current due date for this invoice's payment.
    Example: "2020-02-01T00:00:00.750Z"

  - `original_due_at` (string)
    The due date for this invoice at the time an advance was issued.
    Example: "2020-02-01T00:00:00.750Z"

  - `invoiced_at` (string)
    The date this invoice was created in your system of record (Resolve or Quickbooks).
    Example: "2020-01-01T00:00:00.750Z"

  - `advance_requested` (boolean)
    Indicated if advance was requested.
    Example: "false"

  - `terms` (string)
    The terms selected for this invoice.
    Enum: "due_upon_receipt", "net7", "net10", "net10th", "net15", "net20", "net30", "net45", "net60", "net75", "net90", "net120", "net180"

  - `amount_payout_due` (number)
    The original amount that Resolve owed on this invoice on the advance date.
    Example: 4000

  - `amount_payout_paid` (number)
    The amount that Resolve has paid out.
    Example: 2000

  - `amount_payout_pending` (number)
    The amount that Resolve has currently pending to be paid out.
    Example: 1000

  - `amount_payout_refunded` (number)
    The amount that Resolve has debited from due to refunds.
    Example: 500

  - `amount_payout_balance` (number)
    The amount remaining to be paid out.
    Example: 500

  - `payout_fully_paid` (boolean)
    The status of whether or not this invoice has been fully paid out.

  - `payout_fully_paid_at` (string)
    The date of when this invoice has been fully paid out.
    Example: "2020-01-02T00:00:00.730Z"

  - `amount_balance` (number)
    Current balance due.
    Example: 2000

  - `amount_due` (number)
    Original amount due.
    Example: 4000

  - `amount_refunded` (number)
    Amount that has been refunded.

  - `amount_pending` (number)
    Amount of total payments pending.
    Example: 1000

  - `amount_paid` (number)
    Amount of total payments applied to this invoice.
    Example: 1000

  - `amount_advance` (number)
    Amount of advance received.
    Example: 4000

  - `amount_additional_advance` (number)
    Amount of additional advance received.
    Example: 1000

  - `amount_advance_fee` (number)
    Fee for the amount of advance.
    Example: 10.75

  - `amount_advance_fee_refund` (number)
    Refunded fees for the amount of advance.
    Example: 10.75

  - `advance_rate` (number)
    The advance rate that was used to determine amount of advance.
    Example: 0.75

  - `advanced_at` (string)
    The date this invoice was advanced.
    Example: "2020-01-02T00:00:00.730Z"

  - `amount_customer_fee_total` (number)
    The total amount of customer fees accrued.
    Example: 500

  - `amount_customer_fee_waived` (number)
    The total amount of customer fees waived.
    Example: 120

  - `amount_customer_fee_paid` (number)
    The total amount of customer fees paid.
    Example: 300

  - `amount_customer_fee_balance` (number)
    The current amount of customer fees owed.
    Example: 80

  - `created_at` (string)
    Date the invoice was created.
    Example: "2020-01-02T00:00:00.730Z"

  - `updated_at` (string)
    Date the invoice was last updated.
    Example: "2020-01-02T00:00:00.730Z"

  - `archived` (boolean)
    Boolean indicating if invoice is archived.

  - `invoice_payment_url` (string)
    Link to make invoice payments.
    Example: "https://app.resolvepay.com/merchant/invoices/PMMlaE5wbg0"

  - `canceled` (boolean)
    Indicates whether the invoice is canceled.

  - `canceled_at` (string)
    Date the invoice was canceled.

  - `voided` (boolean)
    Indicates whether the invoice is voided.

  - `voided_at` (string)
    Date the invoice was voided.

  - `amount_canceled` (number)
    Amount that has been canceled.

  - `amount_voided` (number)
    Amount that has been voided.

## Response 401 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "Invalid merchant credentials"

  - `error.type` (string)
    A short string, describing error type
    Enum: "authentication_error"

## Response 404 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "[entity] not found"

  - `error.type` (string)
    A short string, describing error type
    Enum: "not_found_error"

## Response 429 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "Too many requests"

  - `error.type` (string)
    A short string, describing error type
    Enum: "rate_limit_error"