Skip to main content
GET
/
accounting
/
invoices
/
{invoiceId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/invoices/{invoiceId} \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "invoiceId": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "discountAmount": 10,
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "invoiceDate": "2021-01-01T00:00:00Z",
    "invoiceNumber": "1020",
    "invoiceType": "STANDARD",
    "journalCode": "50",
    "lineAmountType": "EXCLUSIVE",
    "lineItems": [
      {
        "lineItemId": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
            "categoryName": "CostCenter",
            "name": "C1"
          }
        ],
        "discountItemAmount": 10,
        "discountItemPercentage": 10,
        "grossAmount": 109,
        "itemsAmount": 100,
        "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "name": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "taxRatePercentage": 19,
        "unitAmount": 100,
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentStatus": "PENDING",
    "paymentTermDuration": 30,
    "paymentTermId": "1",
    "reference": "RCXF197253F",
    "shippingDate": "2021-01-01T00:00:00Z",
    "status": "DRAFT",
    "sumNetAmount": 100,
    "taxRule": "NET",
    "totalAmount": 109,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

​
Field support per integration

Support rawData: true
Supported Response Fields:
​
id
string
​
invoiceId
string
Deprecated. Use id instead.
​
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
currency
enum
The currency field supports **ISO 4217 ** (3-letter codes). For details visits the Standardized Data section.
​
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.
Support rawData: true
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[]
​
lineItems
LineItem[]
​
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
Support rawData: true
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
​
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
​
lineItems
LineItem[]
​
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
Support rawData: true
Supported Response Fields:
​
id
string
​
invoiceId
string
Deprecated. Use id instead.
​
addresses
Address[]
​
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
​
lineItems
LineItem[]
​
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
paymentTermId
string
​
status
enum
Available options: VOIDED, DRAFT, PAID
​
totalAmount
number
​
totalTaxAmount
number
Support rawData: true
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
​
shippingDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
paymentTermDuration
number
​
addresses
Address[]
​
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_GOODS, INTRACOMMUNITY_SERVICE, EXPORT_SERVICE, EXPORT_GOODS, REVERSE_CHARGE , GROSS, CONSTRUCTION_SERVICE, PHOTOVOLTAIC_EQUIPMENT
​
lineAmountType
enum
Available options: EXCLUSIVE, INCLUSIVE, NOTAX
​
lineItems
LineItem[]
Support rawData: true
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
Support rawData: true
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.
Support rawData: true
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
​
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
Support rawData: true
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
​
lineItems
LineItem[]
Support rawData: true
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
​
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
Support rawData: true
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, 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
​
addresses
Address[]
​
sumNetAmount
number
​
totalAmount
number
​
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
​
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
paymentStatus
enum
Available options: PENDING, PAID, PARTLY_PAID,CANCELED, PARTIAL_CANCELLATION, BAD_DEBT,DEBITED
​
lineAmountType
enum
Available options: EXCLUSIVE, INCLUSIVE, NOTAX
​
lineItems
LineItem[]
Support rawData: true
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

Path Parameters

​
invoiceId
string
required

Query Parameters

​
companyId
string
​
environmentName
string
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object
Last modified on June 10, 2026