Drafts

List Draft Documents

Changed on Oct 11, 2026

Retrieve a paginated list of draft documents with filtering options including state and text search.

get/api/drafts/

Request

Base URL
https://api.e-invoice.be
Auth
HTTP bearer
TypeScript
https://skmtc.dev/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/docs/api/drafts/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

pageinteger

Page number

page_sizeinteger

Number of items per page

state'DRAFT' | 'TRANSIT' | 'FAILED' | 'SENT' | 'RECEIVED'

Filter by document state. By default return all states (DRAFT, TRANSIT, FAILED).

type'INVOICE' | 'CREDIT_NOTE' | 'DEBIT_NOTE' | 'SELFBILLING_INVOICE' | 'SELFBILLING_CREDIT_NOTE'

Filter by document type

date_fromstring date-time nullable

Filter by issue date (from)

date_tostring date-time nullable

Filter by issue date (to)

searchstring nullable

Search in invoice number, seller/buyer names

Sort field options for document listing.

Field to sort by

sort_order'asc' | 'desc'

Sort order options.

Sort direction (asc/desc)

Response

Successful Response

totalinteger required

pageinteger required

page_sizeinteger required

pagesinteger required

has_next_pageboolean required

Example response

{
  "items": [
    {
      "vendor_tax_id": "BE1018265814",
      "vendor_company_id": "1018265814",
      "customer_tax_id": "BE1018265814",
      "customer_company_id": "1018265814",
      "customer_peppol_id": "0208:0123456789",
      "items": [
        {
          "tax_rate": "21.00",
          "charges": [
            {
              "tax_rate": "21.00"
            }
          ]
        }
      ],
      "charges": [
        {
          "tax_rate": "21.00"
        }
      ]
    }
  ]
}

Changes

Oct 11, 202615e09b0714d6 Revision changes
- info
  added the optional property ///// to the response with the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the /// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the /// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ///////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the /// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the ////// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the /// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
- info
  the /// response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was added for the status
Oct 11, 20261bb0867bdfdf Revision changes
- info
  endpoint added

Operation history (9 revisions)