Skip to main content
GET
Retrieve one invoice
Learn more:
  • What is an invoice? ↗
  • What is a contact? ↗

Path Parameters

consumer_id
string<uuid>
required
invoice_id
string
required

Query Parameters

include_pdf
enum<string> | null
default:false

Include the invoice PDF as a base64 encoded string in the response

Available options:
true,
false
include_analytic_accounts
enum<string> | null
default:false

Include analytic accounts in the response

Available options:
true,
false

Response

Successful Response

Invoice item returned in get 1 invoice

id
string
required

Technical id in Chift

Example:

"<this-id>"

source_ref
Ref · object
required

Technical id in the target software

currency
string
required

Currency matching target sofware name

Example:

"EUR"

invoice_type
enum<string>
required

Invoice type

Available options:
customer_invoice,
customer_refund,
supplier_invoice,
supplier_refund,
all
status
enum<string>
required

Status

Available options:
cancelled,
draft,
posted,
paid
invoice_date
string<date>
required

Invoicing date

Example:

"2026-01-15"

tax_amount
number
required

Taxes amount

Example:

42

untaxed_amount
number
required

Untaxed amount

Example:

200

total
number
required

Total amount incl. taxes

Example:

242

lines
InvoiceLineItemOut · object[]

Invoice lines

partner_id
string | null

Technical id of the vendor/customer in Chift

Example:

"<invoicing-partner-id>"

invoice_number
string | null

Number/sequence

Example:

"INV-2026-0001"

due_date
string<date> | null

Due date

Example:

"2026-02-14"

reference
string | null

Reference

Example:

"REF-0001"

payment_communication
string | null

Payment communication

Example:

"+++000/0000/00000+++"

customer_memo
string | null

Customer note/memo

Example:

"Thank you for your business."

journal_ref
FieldRef · object | null

Journal

italian_specificities
ItalianSpecificities · object | null

Specificities for Italy

spanish_specificities
SpanishSpecificities · object | null

Specificities for Spain

last_updated_on
string<date-time> | null
Example:

"2026-01-15T10:30:00Z"

outstanding_amount
number | null

Amount left to be paid

Example:

0

last_payment_date
string<date> | null

Date of the last payment linked to the invoice

Example:

"2026-02-14"

accounting_date
string<date> | null

Accounting date

Example:

"2026-01-15"

payment_method_id
string | null

Technical id of the payment method in Chift

Example:

"<invoicing-payment-method-id>"

currency_exchange_rate
number | null
default:1

Exchange rate from the invoice currency to the connector's base currency, at the date of the invoice.

pdf
string | null

PDF document in base64

Example:

"<base64-encoded-file-content>"