Skip to main content
GET
/
accounting
/
bills
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/bills \
  --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",
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "addresses": [
        {
          "addressLine1": "Main street 45",
          "addressLine2": "2nd floor",
          "city": "Berlin",
          "countryCode": "DE",
          "postalCode": "10243",
          "type": "BILLING"
        }
      ],
      "billDate": "2021-01-01T00:00:00Z",
      "billNumber": "1020",
      "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
      "createdDate": "2021-01-01T00:00:00Z",
      "currency": "EUR",
      "deliveryDate": "2021-01-01T00:00:00Z",
      "dueDate": "2021-07-01T00:00:00Z",
      "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
      "journalCode": "30",
      "lineItems": [
        {
          "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
          "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
          "accountNumber": "200",
          "createdDate": "2021-01-01T00:00:00Z",
          "deferredEndDate": "2021-06-01T00:00:00Z",
          "deferredStartDate": "2021-01-01T00:00:00Z",
          "description": "SEOUL Guest Chair, red",
          "dimensions": [
            {
              "name": "C1",
              "categoryName": "CostCenter"
            }
          ],
          "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
          "itemName": "RED CHAIR",
          "quantity": 1,
          "taxCode": "03",
          "taxRatePercentage": 19,
          "totalDiscountAmount": 10,
          "totalDiscountPercentage": 10,
          "totalGrossAmount": 109,
          "totalNetAmount": 100,
          "totalTaxAmount": 19,
          "unitAmount": 100,
          "unitDiscountAmount": 10,
          "unitDiscountPercentage": 10,
          "unitName": "PIECE",
          "updatedDate": "2021-01-01T00:00:00Z"
        }
      ],
      "name": "Office Supplies",
      "oneLineAddress": "Main street 45, Berlin",
      "paidDate": "2021-01-25T00:00:00Z",
      "paymentDays": 30,
      "paymentReference": "Edefad142e764894",
      "paymentStatus": "PENDING",
      "paymentTermCode": "21",
      "reference": "026 / 245",
      "shippingDate": "2021-01-01T00:00:00Z",
      "shippingType": "DELIVERY",
      "status": "DRAFT",
      "taxRule": "NET",
      "taxText": "Tax 19 percent",
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

​
Field support per integration

Query parameters:
​
limit
enum
Available options: 5, 10, 20, 50, 100
​
page
number
​
filter
string
​
orderField
string
​
oderDir
object
Available options: ASC, DESC
​
rawData
boolean
Supported Response Fields:
​
id
string
​
accountId
string
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
string
​
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
deliveryDate
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
​
name
string
​
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
status
enum
Available options: OPEN, PAID
​
totalGrossAmount
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.
Query parameters:
​
limit
enum
Available options: 5, 10, 20, 50, 100
​
page
number
​
filter
string
​
rawData
boolean
Supported response fields:
​
id
string
​
addresses
Address[]
​
billDate
string
For date format details visit the Standardized Data section
​
billNumber
string
​
contactId
string
​
currency
enum
The currency field supports ISO 4217 (3-letter codes).For details visit the Standardized Data section.
​
dueDate
string
For date format details visit the Standardized Data section
​
lineItems
LineItem[]
​
paymentStatus
enum
Available options: PENDING, PAID, CANCELED, NO_OPEN_ITEM, UNKNOWN
​
reference
string
​
status
enum
Available options: DRAFT, SUBMITTED, OPEN, PAID, VOIDED, CORRECTIVE
​
totalDiscountAmount
number
​
totalGrossAmount
number
​
totalNetAmount
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.
Query parameters:
​
limit
enum
Available options: 5, 10, 20, 50, 100
​
page
number
​
filter
string
​
rawData
boolean
Supported Response Fields:
​
id
string
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
string
​
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
​
journalCode
string
​
paymentReference
string
​
paymentTermCode
string
​
reference
string
​
status
enum
Available options: OPEN, PAID, OVERDUE
​
totalGrossAmount
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
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
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
​
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
totalGrossAmount
number
Query parameters:
​
limit
enum
Available options: 5, 10, 20, 50, 100
​
page
number
​
filter
string
​
orderField
string
​
oderDir
object
Available options: ASC, DESC
​
rawData
boolean
Supported Response Fields:
​
id
string
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
string
​
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
​
name
string
​
status
enum
Available options: DRAFT, OPEN, PAID, OVERDUE, VOIDED, SUBMITTED
​
totalGrossAmount
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
​
oderDir
object
Available options: ASC, DESC
​
rawData
boolean
Supported Response Fields:
​
id
string
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
string
​
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
​
name
string
​
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
status
enum
Available options: DRAFT,SUBMITTED, OPEN, PAID,VOIDED
​
totalGrossAmount
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
​
billDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
billNumber
string
​
contactId
string
​
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
currency
enum
The currency field supports ISO 4217 alpha-3 (3-letter codes). For details visits the Standardized Data section.
​
deliveryDate
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
​
fileId
string
​
name
string
​
paidDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
status
enum
Available options: DRAFT, SUBMITTED, OPEN, PARTIALLY_PAID, PAID
​
totalGrossAmount
number
​
totalNetAmount
number
​
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

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:
billlDate,
billNumber,
createdDate,
updatedDate
​
companyId
string
​
environmentName
string
​
lastModifiedAt
number
​
billDateFrom
number
​
status
string
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object[]
Last modified on June 29, 2026