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 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 10, 2026