Skip to main content
GET
/
accounting
/
bookingProposals
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/bookingProposals \
  --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": "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

Supported filters:
  • lastModifiedAt
    It must be a timestamp in the form YYYY-MM-DDT00:00:00Z (milliseconds are not supported by lexoffice)
  • status
Support pagination: trueSupport ordering: trueSupport 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, INVOICE_CREDIT_NOTE,BILL_CREDIT_NOTE, DOWN_PAYMENT
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
dueDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
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

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

Response

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