---
title: "GET peppol deliveries"
method: GET
path: "/v3/administrations/{administration_id}/invoices/{invoice_id}/peppol_deliveries"
tags: ["Invoice PeppolDeliveries"]
---

# GET peppol deliveries

`GET /v3/administrations/{administration_id}/invoices/{invoice_id}/peppol_deliveries`

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/invoices/{invoice_id}/peppol_deliveries`
- Auth: one of:
  - API key in header `X-API-KEY`
  - 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/:invoice_id/peppol_deliveries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns peppol deliveries of a specific Invoice

## Path parameters

- `administration_id` string, required
- `invoice_id` string, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `sort` string
- `fields[peppol_delivery]` string
- `include` string
- `filter[id]` string
- `filter[state]` string
- `filter[status_code]` string
- `filter[peppol_guid]` string
- `filter[invoice]` string
- `filter[administration]` string

## Headers

- `Accept-Language` string

## Response `200`

PeppolDeliveryCollectionResponse

- object
  - `data` PeppolDelivery[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `state` string
      - `status_code` string
      - `peppol_guid` string
      - `receiver_peppol_identifiers` object[]: PEPPOL Identifiers for the receiver with scheme ID. See https://docs.peppol.eu/edelivery/codelists/v9.4/Peppol%20Code%20Lists%20-%20Participant%20identifier%20schemes%20v9.4.html
        - `scheme` string
        - `value` string
    - `relationships` object: Relationships
      - `invoice` object
        - `data` object
          - `id` string: invoice ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `administration` object
        - `data` object
          - `id` string: administration ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `included` union[]
    - union
      - Invoice: Invoices can be created for Orders, Channels and Owners. An Invoice will be in concept until it is sent, after which it becomes immutable. Changes to an Order will be invoiced by crediting the current Invoice and generating a new Invoice.
        - `id` string: ID
        - `type` string: Type
        - `attributes` object: Attributes
          - `date` string, date: The date of the invoice
          - `type` 'CancellationInvoice' | 'ChannelInvoice' | 'CreditInvoice' | 'MeasurementInvoice' | 'OneOffOwnerInvoice' | 'OwnerPeriodicInvoice' | 'RentSettlementInvoice' | 'ReservationInvoice' | 'ReservationMeasurementInvoice' | 'TodoInvoice' | 'UtilitiesAdvanceInvoice'
          - `invoice_nr` string: The invoice number, which is unique within the administration
          - `sent` boolean: Returns whether this invoice has been sent
          - `currency` string: An ISO 4217 currency code
          - `reference_nr` string: Reference number from the associated booking (if any)
          - `company` string: The company name of the billed to party (if any)
          - `country_code` string: The country code of the billed to party (if any)
          - `city` string: The city of the billed to party (if any)
          - `address` string: Combined address of the billed to party (if any)
          - `address_line_1` string: Address line 1 of the billed to party (if any)
          - `address_line_2` string: Address line 2 of the billed to party (if any)
          - `postalcode` string: The postal code of the billed to party (if any)
          - `address_subdivision` string: The subdivision (state/province/region) of the billed to party (if any)
          - `debtor_code` string
          - `memo` string: Returns the current content of the memo. For booking invoices, this returns the memo of the booking.
          - `recurring_payment` boolean: Yields whether this invoice should be paid with recurring payment
          - `period_start_date` string, date: The start date of the period this invoice applies to (if any)
          - `period_end_date` string, date: The end date of the period this invoice applies to (if any)
          - `payment_deadlines` object[]: Deadlines for payment of the invoice, with the due date, open and paid amounts, and the current status. Status can have the following values: first_reminder, second_reminder, final_notice
            - `date` string, date
            - `status` string
            - `open_amount` object
              - …
            - `paid_amount` object
              - …
          - `total` object
            - `currency` string
            - `value` string
          - `total_open` object
            - `currency` string
            - `value` string
          - `pdf_url` string
          - `last_sent` string, date-time: Returns the last time this invoice was sent to the Customer.
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - `links` object: Links
          - `self` string: Link to self
          - `url` string: Link to url
          - `payment_portal_short_url` string: A short URL to the payment portal for this invoice
        - `relationships` object: Relationships
          - `owner` object
            - `data` object
              - …
          - `invoice_items` object
            - `data` object[]
              - …
          - `debtor` object
            - `data` object
              - …
            - `links` object
              - …
          - `administration` object
            - `data` object
              - …
            - `links` object
              - …
          - `reservation` object: DEPRECATED use booking instead
            - `data` object
              - …
            - `links` object
              - …
          - `booking` object
            - `data` object
              - …
            - `links` object
              - …
          - `inventory_objects` object
            - `data` object[]
              - …
          - `credited_invoice` object: The invoice that was credited, if any
            - `data` object
              - …
          - `previous_invoice` object: For a mutation invoice, this yields the previous (credited) invoice
            - `data` object
              - …
          - `payments` object
            - `data` object[]
              - …
          - `security_deposits` object
            - `data` object[]
              - …
        - `meta` object: Metadata
          - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
      - Administration: An organization can have multiple administrations, usually a holiday park or camping.
        - `id` string: ID
        - `type` string: Type
        - `attributes` object: Attributes
          - `name` string
          - `email` string
          - `phone` string
          - `website` string
          - `native_currency` string
          - `address` string
          - `country_code` string
          - `postal_code` string
          - `city` object
            - `cs` string
            - `da-DK` string
            - `de` string
            - `de-AT` string
            - `de-CH` string
            - `en-US` string
            - `en-GB` string
            - `es` string
            - `fr` string
            - `fr-BE` string
            - `fr-LU` string
            - `it` string
            - `nb` string
            - `nl` string
            - `nl-BE` string
            - `pl` string
            - `pt` string
            - `tr` string
            - `en` string
            - `da` string
          - `description` object: A description of the administration
            - `cs` string
            - `da-DK` string
            - `de` string
            - `de-AT` string
            - `de-CH` string
            - `en-US` string
            - `en-GB` string
            - `es` string
            - `fr` string
            - `fr-BE` string
            - `fr-LU` string
            - `it` string
            - `nb` string
            - `nl` string
            - `nl-BE` string
            - `pl` string
            - `pt` string
            - `tr` string
            - `en` string
            - `da` string
          - `surroundings_description` object: A description of the surroundings
            - `cs` string
            - `da-DK` string
            - `de` string
            - `de-AT` string
            - `de-CH` string
            - `en-US` string
            - `en-GB` string
            - `es` string
            - `fr` string
            - `fr-BE` string
            - `fr-LU` string
            - `it` string
            - `nb` string
            - `nl` string
            - `nl-BE` string
            - `pl` string
            - `pt` string
            - `tr` string
            - `en` string
            - `da` string
          - `tin` string: Tax Identification Number
          - `vat_nr` string: VAT Number
          - `available_locales` string[]: Enabled locales
          - `native_locale` string: The default locale used by the administration internally, and which should be used for communication with the administration
          - `timezone` string: The timezone of the administration, for example: Amsterdam
          - `invoice_email` string: The email address to contact for invoicing questions
          - `invoice_phone` string: The phone number to contact for invoicing questions
          - `invoice_address` string: The address to use for invoicing
          - `invoice_postalcode` string: The postal code to use for invoicing
          - `invoice_city` string: The city to use for invoicing
          - `invoice_country_code` string: The country code to use for invoicing
          - `billing_vat_percentage` integer
          - `available_currencies` string[]: Enabled currencies
          - `map_available` boolean: If a map is available. The map can be used to pick a specific accommodation or pitch.
          - `guest_list_group` 'main_guest' | 'all' | 'adults' | 'none'
          - `guest_accepted_document_type` string[]
          - `guest_identification_required` 'none' | 'main_guest' | 'all' | 'adults'
          - `ask_for_guest_gender` boolean
          - `ask_for_guest_address` boolean
          - `ask_for_guest_postal_code` boolean
          - `ask_for_guest_city` boolean
          - `ask_for_guest_country` boolean
          - `ask_for_guest_email` boolean
          - `ask_for_guest_phone` boolean
          - `ask_for_guest_profession` boolean
          - `ask_for_guest_signature` boolean
          - `ask_for_fellow_guest_gender` boolean
          - `ask_for_fellow_guest_address` boolean
          - `ask_for_fellow_guest_postal_code` boolean
          - `ask_for_fellow_guest_city` boolean
          - `ask_for_fellow_guest_country` boolean
          - `ask_for_fellow_guest_email` boolean
          - `ask_for_fellow_guest_phone` boolean
          - `ask_for_fellow_guest_profession` boolean
          - `ask_for_fellow_guest_signature` boolean
          - `default_option_validity` integer: The default option validity in days. When 0, customer options are not allowed.
          - `max_options_per_customer` integer: DEPRECATED use max_options_per_booker instead
          - `max_options_per_booker` integer: The maximum number of options that can be created at the same time by a particular customer
          - `latitude` number, double
          - `longitude` number, double
          - `allow_multi_reservation_bookings_through_api` boolean: Whether the administration accepts bookings containing multiple reservations.
          - `accounting_closed_upto` string, date: Date up to which accounting is closed. All financial transactions made before this date are locked and cannot be changed.
          - `enable_license_plates` boolean: Whether the administration accepts license plates for bookings.
          - `iban` string: International Bank Account Number
          - `bic` string: Bank Identifier Code
          - `peppol_identifiers` object[]: PEPPOL Identifiers for the administration with scheme ID. See https://docs.peppol.eu/edelivery/codelists/v9.4/Peppol%20Code%20Lists%20-%20Participant%20identifier%20schemes%20v9.4.html
            - `scheme` string
            - `value` string
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - `links` object: Links
          - `self` string: Link to self
          - `url` string: Link to url
        - `relationships` object: Relationships
          - `city` object
            - `data` object
              - …
          - `checkin_timetable` object: The timetable that defines the default check-in times for this administration. It can be overridden for each rentable type.
            - `data` object
              - …
          - `checkout_timetable` object: The timetable that defines the default check-out times for this administration. It can be overridden for each rentable type.
            - `data` object
              - …
          - `interactive_map` object
            - `data` object
              - …
          - `payment_handlers` object
            - `data` object[]
              - …
        - `meta` object: Metadata
          - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `meta` object
    - `pagination` object
      - `total_records` integer
      - `page` integer
      - `size` integer

## Other responses

- `429`: Error
- `default`: Error

## Changes

- **2026-11-03** `ff81bc4fefa9`: 10 info
  - added the optional property `included/items/anyOf[#/components/schemas/Administration]/attributes/city/da-DK` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/Administration]/attributes/city/en-GB` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/Administration]/attributes/city/en-US` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/Administration]/attributes/description/da-DK` to the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/invoices/:invoice_id/peppol_deliveries/get.md)

---

[API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)