Accounting Period Closure1

AdministrationAmenities2

Administrations2

AgeGroups2

AgendaPeriods8

AggregatedJournalTransactions1

Agreement PeriodicCosts2

Agreements5

Amenities3

AmenityGroups2

App Availabilities1

App Supported Payment Methods1

Availabilities1

Booking Customer1

Bookings5

Brands2

Categories7

Category Availability1

Category CategoryAmenities3

Category Costs1

Category Extras1

Category Images3

Category LOSPrices1

Category NightPrices1

Channel Bookings4

Channel Channels2

Channel Costs2

Channel ExtraPackages2

Channel Extras2

Channel PrimaryPackages2

Channel RentableTypes2

Channel Reservations7

Channel Security Deposit Policies2

Channels5

CheckoutPortal Bookings2

CheckoutPortal Reservations2

Contact Search1

Contacts3

Contractors2

Conversation messages4

Conversations2

Costs2

Costs Channels1

Costs RentableTypes2

CustomerLoginRequests1

Customers6

DAC7 Reports4

Debtors1

DiscountActions7

DiscountCampaigns2

DiscountCards2

Domains2

Executors2

ExtraPackages2

Extras2

Extras RentableTypes1

Facilities2

Guests2

InternalMessages1

InventoryObject Images3

InventoryObject MeterReadings2

InventoryObjects9

Invoice PeppolDeliveries3

Invoice Signatures1

Invoices3

JournalTransactions1

Labels4

LedgerAccount JournalTransactions1

LedgerAccounts2

MasterPriceList ComplexPrices1

MasterPriceList SimplePrices1

MasterPriceLists4

Measurers2

MeterTypes2

Night Registry1

Orders2

Organizations1

Owners4

Payment Batches3

PaymentHandlers5

PaymentMethods4

PaymentRequest Chargebacks1

PaymentRequests2

PaymentResults1

Payments3

PeriodicCosts2

Periods5

PrimaryPackage Categories1

PrimaryPackage RentableTypes1

PrimaryPackages2

Promotions2

Receipt Signatures1

Receipts2

RefundResults1

Registers3

RentableIdentities5

Rentables10

RentableSegments2

RentableType Availabilities1

RentableType Costs1

RentableType Extras1

RentableType Images3

RentableType LOSPrices1

RentableType NightPrices1

RentableType RentableTypeAmenities3

RentableType Security Deposit Policies1

RentableTypes5

Reservation ChangeRequests2

Reservation Extra Packages1

Reservation ExtraOrderItems2

Reservation Guests5

Reservation Memos1

Reservation Messages1

ReservationPreviews1

Reservations8

ReviewForm Reviews1

ReviewForms2

Reviews3

Security Deposit Policies RentableTypes1

SpecialPeriods2

Subdomains2

Subscriptions2

Supplier RentableTypes5

Supplier Reservations2

Supplier Suppliers4

Suppliers3

TaskCosts5

Todo Timesheets5

Todo TodoImages4

Todo UsedMaterials5

TodoLists5

Todos5

TrafficSources2

Users2

VATCodes2

Vouchers3

Invoices

GET invoices

Changed on Nov 3, 2026

Returns invoices of the administration

get/v3/administrations/{administration_id}/invoices

Request

Base URL
https://api.bookingexperts.com
Auth
- API key in header X-API-KEY
- or OAuth 2
  Authorization code/oauth/authorize
  Token URL/oauth/token
TypeScript
https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/administrations/:administration_id/invoices/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

administration_idstring required

Administration ID

Query parameters

page[number]integer

Page number

page[size]integer

Page size

sortstring

Sort. Specify a comma separated list of attributes to sort on. Prefix attribute with a - to sort in descending order. Allowed attributes: id, created_at, updated_at

fields[invoice]string

Fieldset. Specify a comma separated list of attributes to return

includestring

Includes list. Specify a comma separated list of resources to include.

filter[id]string

Filter on ID

filter[date]string

Filter on date

filter[type]string

Filter on type

filter[invoice_nr]string

Filter on invoice_nr

filter[company]string

Filter on company

filter[country_code]string

Filter on country_code

filter[city]string

Filter on city

filter[address_line_1]string

Filter on address_line_1

filter[address_line_2]string

Filter on address_line_2

filter[postalcode]string

Filter on postalcode

filter[address_subdivision]string

Filter on address_subdivision

filter[memo]string

Filter on memo

filter[period_start_date]string

Filter on period_start_date

filter[period_end_date]string

Filter on period_end_date

filter[total]string

Filter on total

filter[last_sent]string

Filter on last_sent

filter[created_at]string

Filter on created_at

filter[updated_at]string

Filter on updated_at

filter[owner]string

Filter on owner. Specify a comma separated list of IDs to filter on.

filter[invoice_items]string

Filter on invoice_items. Specify a comma separated list of IDs to filter on.

filter[debtor]string

Filter on debtor. Specify a comma separated list of IDs to filter on.

filter[administration]string

Filter on administration. Specify a comma separated list of IDs to filter on.

filter[booking]string

Filter on booking. Specify a comma separated list of IDs to filter on.

filter[inventory_objects]string

Filter on inventory_objects. Specify a comma separated list of IDs to filter on.

filter[credited_invoice]string

Filter on credited_invoice. Specify a comma separated list of IDs to filter on.

filter[previous_invoice]string

Filter on previous_invoice. Specify a comma separated list of IDs to filter on.

filter[payments]string

Filter on payments. Specify a comma separated list of IDs to filter on.

filter[security_deposits]string

Filter on security_deposits. Specify a comma separated list of IDs to filter on.

filter[sent]boolean

Filter on sent. When false, concept invoices will be returned.

filter[paid]boolean

Filter on paid. When true, only fully paid invoices will be returned. When false, only invoices with an outstanding amount (either direction) will be returned.

Headers

Accept-Languagestring

Supported languages. A comma separated list with one or more of the following locales: cs, da-DK, de, de-AT, de-CH, en-US, en-GB, es, fr, fr-BE, fr-LU, it, nb, nl, nl-BE, pl, pt, tr, en, da. Default: 'en'.

Response

InvoiceCollectionResponse

Example response

{
  "data": [
    {
      "id": "1",
      "type": "invoice",
      "relationships": {
        "owner": {
          "data": {
            "type": "owner"
          }
        },
        "invoice_items": {
          "data": [
            {
              "type": "invoice_item"
            }
          ]
        },
        "debtor": {
          "data": {
            "type": "debtor"
          }
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        },
        "reservation": {
          "data": {
            "type": "reservation"
          }
        },
        "booking": {
          "data": {
            "type": "booking"
          }
        },
        "inventory_objects": {
          "data": [
            {
              "type": "inventory_object"
            }
          ]
        },
        "credited_invoice": {
          "data": {
            "type": "invoice"
          }
        },
        "previous_invoice": {
          "data": {
            "type": "invoice"
          }
        },
        "payments": {
          "data": [
            {
              "type": "payment"
            }
          ]
        },
        "security_deposits": {
          "data": [
            {
              "type": "security_deposit"
            }
          ]
        }
      }
    }
  ],
  "included": [
    {
      "id": "1",
      "type": "owner",
      "attributes": {
        "title": "mr",
        "locale": "cs",
        "country_code": "NL"
      },
      "relationships": {
        "primary_contact": {
          "data": {
            "type": "contact"
          }
        },
        "contacts": {
          "data": [
            {
              "type": "contact"
            }
          ]
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        },
        "active_inventory_objects": {
          "data": [
            {
              "type": "inventory_object"
            }
          ]
        },
        "owner_guests": {
          "data": [
            {
              "type": "owner_guest"
            }
          ]
        },
        "active_rentable_identities": {
          "data": {
            "type": "rentable_identity"
          }
        },
        "labels": {
          "data": [
            {
              "type": "label"
            }
          ]
        }
      }
    }
  ]
}

Changes

Nov 3, 2026ff81bc4fefa9 Revision changes
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- info
  added the new optional query request parameter filter[debtor]
- info
  added the optional property /// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added to the / response property anyOf list for the response status

Operation history