Skip to main content
GET
/
accounting
/
bookingProposals
/
{bookingProposalId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId} \
  --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": "BP-12345",
      "addresses ": [
        {
          "city": "city"
        }
      ],
      "bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
      "bankAccountNumber": 5407324931,
      "bankCode": "50010517",
      "bic": "DEUTDEFF",
      "bookingProposalDate": "2025-07-14T00:00:00Z",
      "bookingType": "INVOICE",
      "contactAccountNumber": 70000,
      "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
      "contactName ": "John Doe",
      "createdDate": "2025-07-16T00:00:00Z",
      "currency": "EUR",
      "deliveryDate": "2025-07-26T00:00:00Z",
      "discountPaymentDate": "2025-07-16T00:00:00Z",
      "discountPaymentDate2": "2025-07-18T00:00:00Z",
      "dueDate": "2025-07-24T00:00:00Z",
      "files": [
        "file1.pdf"
      ],
      "journalCode": "60",
      "iban": "DE43100500000920018963",
      "isPaymentOrder": "true",
      "ledgerName": "Payroll",
      "lineItems": [
        {
          "id": "Item-112233",
          "accountCode": "200",
          "accountId": "db32-4f56-8a9b-1234567890ab",
          "accountName": "EXPENSE",
          "accountNumber": 4900,
          "bookingTaxCode": "9",
          "createdDate": "2021-01-01T00:00:00Z",
          "description": "Item A",
          "dimension1": "Marketing",
          "dimension2": "Service and Maintenance",
          "discountAmount": 100,
          "discountAmount2": 50,
          "discountPercentage": 20,
          "discountPercentage2": 10,
          "taxCode": "02",
          "taxRatePercentage": 19,
          "totalGrossAmount": 500,
          "totalNetAmount": 450,
          "type": "SERVICES",
          "updatedDate": "2021-01-01T00:00:00Z"
        }
      ],
      "notes": "Bill for maintenance services",
      "number": "1233330",
      "orderId": "3344566",
      "paidDate": "2021-01-01T00:00:00Z",
      "paymentTermsId": "03",
      "status": "DRAFT",
      "taskId": "ADHUR74BCBSW8399DCN",
      "totalGrossAmount": 500,
      "updatedDate": "2025-07-16T00:00:00Z",
      "vatId": "DE987654321"
    }
  ]
}

​
Field support per integration

The endpoint only works with bookingProposalId that is associated with the following types:INVOICE, BILL, INVOICE_CREDIT_NOTE,BILL_CREDIT_NOTE
Support rawData: true
Supported Response Fields:
​
id
string
​
bookingProposalDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
bookingType
enum
Available options : INVOICE, BILL, INVOICE_CREDIT_NOTE,BILL_CREDIT_NOTE
​
contactId
string
​
contactName
string
​
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
currency
enum
Available options (3-letter ISO 4217): EUR
​
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
​
lineItems
BookingProposalLineItem[]
​
number
string
​
status
enum
Available options : DRAFT, SUBMITTED, OPEN, PAID, VOIDED, OVERDUE
​
totalGrossAmount
number
​
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Support rawData: true
Supported Response Fields:
​
id
string
​
bookingProposalDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
bookingType
enum
Available options : INVOICE, BILL, CREDIT_NOTE, OTHER
​
contactId
string
​
contactName
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
​
files
string[]
​
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
iban
string
​
number
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
​
vatId
string
Support rawData: true
Supported Response Fields:
​
id
string
​
bookingProposalDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
bookingType
enum
Available options : BILL, CREDIT_CARD, CREDIT_NOTE, EXPENSE, OTHER
​
contactId
string
​
contactName
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
​
files
string[]
​
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
​
iban
string
​
number
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
​
vatId
string

Headers

​
X-API-KEY
string
required

API key

Example:

"example value"

​
X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Path Parameters

​
bookingProposalId
string
required

Query Parameters

​
companyId
string
​
environmentName
string
​
rawData
boolean

Response

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