Skip to main content
GET
cURL

Field support per integration

Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
orderField
string
orderDir
enum
Available options: ASC, DESC
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceNumber
string
name
string
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
status
enum
Available options: OPEN, PAID
totalAmount
number
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Please ensure the query parameters environmentName and companyId are accurately populated with the appropriate environment and company ID. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
contactId
string
invoiceType
enum
Available options: STANDARD
currency
enum
Available options (3-letter ISO 4217):
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
status
enum
Available options: DRAFT, OPEN, PAID
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
addresses
Address[]
totalTaxAmount
number
discountAmount
number
sumNetAmount
number
totalAmount
number
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
lineAmountType
enum
Available options: EXCLUSIVE, INCLUSIVE
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
To retrieve invoices in Exact Online, your account must have one of the following package subscriptions enabled:
  • Manufacturing (any tier)
  • Professional Services (Plus, Professional, or Premium)
  • Wholesale & Distribution (any tier)
  • Accountancy Premium
  • Accounting
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
contactId
string
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
currency
enum
Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
discountAmount
number
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
fileId
string
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceNumber
string
invoiceType
enum
Available options: STANDARD
journalCode
string
name
string
paymentStatus
enum
Available options: NO_OPEN_ITEM, PENDING, PAID, PARTIALLY_PAID
paymentTermId
string
reference
string
status
enum
Available options: DRAFT, OPEN, SUBMITTED
sumNetAmount
number
totalAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
contactId
string
currency
enum
Available options (3-letter ISO 4217):AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
invoiceType
enum
Available options: STANDARD
journalCode
string
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
paymentTermId
string
status
enum
Available options: VOIDED, DRAFT, PAID
totalAmount
number
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
orderField
string
orderDir
enum
Available options: ASC, DESC
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
name
string
contactId
string
currency
enum
Available options (3-letter ISO 4217):AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
status
enum
Available options: DRAFT, SUBMITTED, AUTHORISED, PAID, CANCELED
invoiceType
enum
Available options: STANDARD
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
totalAmount
number
Only customer invoices (Odoo move_type out_invoice) are returned.
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
contactId
string
createdDate
string
For date format details visit the Standardized Data section
currency
enum
The currency field supports ISO 4217 alpha-3 (3-letter codes). For details visits the Standardized Data section.
dueDate
string
For date format details visit the Standardized Data section
invoiceDate
string
For date format details visit the Standardized Data section
invoiceNumber
string
invoiceType
enum
Available options: STANDARD
journalCode
string
lineItems
LineItem[]
name
string
paidDate
string
For date format details visit the Standardized Data section
paymentTermDuration
number
Derived from the number of days between invoiceDate and dueDate.
paymentTermId
string
reference
string
status
enum
Available options: DRAFT, OPEN, PARTIALLY_PAID, PAID, VOIDED
sumNetAmount
number
totalAmount
number
totalTaxAmount
number
updatedDate
string
For date format details visit the Standardized Data section
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
orderField
string
orderDir
enum
Available options: ASC, DESC
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
addresses
Address[]
contactId
string
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
currency
enum
Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
fileId
string
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceNumber
string
lineItems
LineItem[]
name
string
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
paymentTermDuration
string
status
enum
Available options: DRAFT,OPEN, PAID,VOIDED
totalAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
addresses
Address[]
contactId
string
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
currency
enum
Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
lineItems
LineItem[]
status
enum
Available options: DRAFT,OPEN, PAID
sumNetAmount
number
totalAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section. Please use the id field as the companyId.
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
contactId
string
invoiceType
enum
Available options: STANDARD
currency
enum
Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
status
enum
Available options: DRAFT, SUBMITTED, VOIDED
paymentStatus
enum
Available options: PENDING, PAID, PARTLY_PAID, CANCELED, PARTIAL_CANCELLATION, BAD_DEBT, DEBITED
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
addresses
Address[]
lineItems
LineItem[]
totalTaxAmount
number
sumNetAmount
number
totalAmount
number
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
name
string
reference
string
Additional reference number. May be customer number, order number or similar.
contactId
string
currency
enum
The currency field supports ISO 4217 alpha-3 (3-letter codes). For details visits the Standardized Data section.
status
enum
Available options: DRAFT, OPEN, VOIDED, PARTIALLY_PAID, PAID
invoiceType
enum
Available options: STANDARD
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
shippingDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
paymentTermDuration
number
oneLineAddress
string
countryCode
enum
Available options (ISO 3166-1 alpha-2):AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
discountAmount
number
totalTaxAmount
number
sumNetAmount
number
totalAmount
number
taxRule
enum
Available options:NET, TAXFREE, INTRACOMMUNITY_SERVICE, EXPORT_SERVICE, REVERSE_CHARGE, SMALL_BUSINESS_VAT_EXEMPTION , NON_DOMESTIC_SERVICE, OSS_GOODS, OSS_ELECTRONIC_SERVICES, OSS_SERVICES
lineAmountType
enum
Available options: EXCLUSIVE
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
addresses
Address[]
contactId
string
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
currency
enum
Available options (3-letter ISO 4217):AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
invoiceType
enum
Available options: STANDARD
lineItems
LineItem[]
paymentStatus
enum
Available options: PENDING, PAID, CLEARED_WITH_CREDIT_NOTE, CREDIT_NOTE_CLEARED, NO_OPEN_ITEM, UNKNOWN
salesOrderId
string
shippingDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
status
enum
Available options: DRAFT, SUBMITTED, DOCUMENT_CREATED, OPEN, VOIDED
sumNetAmount
number
totalAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
orderField
string
orderDir
enum
Available options: ASC, DESC
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
name
string
currency
enum
Available options (3-letter ISO 4217):AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
status
enum
Available options: DRAFT, SUBMITTED, AUTHORISED, PAID, CANCELED, OPEN
invoiceType
enum
Available options: STANDARD
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
countryCode
enum
Available options (ISO 3166-1 alpha-2):AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
paymentStatus
enum
Available options: PENDING, PAID, PARTLY_PAID,CANCELED, PARTIAL_CANCELLATION, BAD_DEBT,DEBITED
lineAmountType
enum
Available options: EXCLUSIVE, INCLUSIVE, NOTAX
Please note, that the Xero API does not send back the discount values for the list endpoint.
Query parameters:
limit
enum
Available options: 5, 10, 20, 50, 100
page
number
filter
string
rawData
boolean
Supported response fields:
id
string
invoiceId
string
Deprecated. Use id instead.
invoiceNumber
string
Unique alpha numeric code identifying the invoice.
name
string
reference
string
Additional reference number. May be customer number, order number or similar.
contactId
string
currency
enum
Available options (3-letter ISO 4217):AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
status
enum
Available options: DRAFT, SUBMITTED, AUTHORISED, PAID, CANCELED
invoiceType
enum
Available options: STANDARD
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
invoiceDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
addresses
Address[]
discountAmount
number
totalTaxAmount
number
sumNetAmount
number
totalAmount
number
lineAmountType
enum
Available options: EXCLUSIVE, INCLUSIVE, NOTAX
lineItems
LineItem[]

Headers

X-API-KEY
string
required

API key

X-ACCOUNT-KEY
string
required

Account key

Query Parameters

page
number
limit
enum<number>
Available options:
5,
10,
20,
50,
100
orderDir
enum<string>
Available options:
ASC,
DESC
orderField
enum<string>
Available options:
invoiceDate,
invoiceNumber,
createdDate,
updatedDate
companyId
string
environmentName
string
lastModifiedAt
number
paymentStatus
string
status
string
rawData
boolean
dueDateFrom
string

Response

200 - application/json
meta
object
data
object[]
Last modified on July 9, 2026