Skip to main content
GET
/
accounting
/
bills
/
{billId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/bills/{billId} \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "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-02-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",
          "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,
      "paymentStatus": "PENDING",
      "paymentTermCode": "21",
      "reference": "RCXF197253F",
      "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

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.
Support rawData: true
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
lineItems
BillLineItem[]
reference
string
paymentTermCode
string
paymentStatus
enum
Available options: BAD_DEBT, PENDING, PAID
status
enum
Available options: OPEN, PAID, OVERDUE
totalGrossAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Support rawData: true
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
journalCode
string
lineItems
BillLineItem[]
reference
string
totalGrossAmount
number
Support rawData: true
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
lineItems
BillLineItem[]
name
string
shippingDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
status
enum
Available options: DRAFT, OPEN, PAID, OVERDUE, VOIDED, SUBMITTED
taxRule
enum
Available options: NET, GROSS
totalGrossAmount
number
totalTaxAmount
number
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

Headers

X-API-KEY
string
required

API key

Example:

"example value"

X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Path Parameters

billId
string
required

Query Parameters

companyId
string
environmentName
string
rawData
boolean

Response

200 - application/json
meta
object
data
object[]
I