# e-invoice.be > API documentation for e-invoice.be, a Peppol Access Point: send and receive e-invoices with JSON, UBL or PDF - [Introduction](https://docs.e-invoice.be/index.md): Find out how to send and receive Peppol e-invoices with the e-invoice.be API from JSON, UBL XML or PDF. - [Quickstart](https://docs.e-invoice.be/quickstart.md): Create a sandbox company, then validate, create and send your first invoice with the API in about five minutes. - [Authentication](https://docs.e-invoice.be/authentication.md): Authenticate your API requests with the API key of your company as a Bearer token. - [Test mode and sandbox companies](https://docs.e-invoice.be/environments.md): Use a sandbox company to build and test your integration on the single API host without Peppol traffic. - [Go-live checklist](https://docs.e-invoice.be/going-live.md): Move an integration from a sandbox company to a production company that sends and receives documents on the Peppol network. - [Validation during development](https://docs.e-invoice.be/guides/validation.md): Validate invoice JSON and UBL XML against the Peppol BIS Billing 3.0 rules before you create a document. - [Create e-invoices](https://docs.e-invoice.be/guides/creating-invoices.md): Validate, create and send an invoice on the Peppol network with the e-invoice.be API. - [Create credit notes](https://docs.e-invoice.be/guides/credit-notes.md): Create a credit note that cancels or decreases an invoice, and send it through Peppol. - [Self-billing and debit notes](https://docs.e-invoice.be/guides/self-billing.md): Create self-billing invoices, self-billing credit notes and debit notes, and understand which party is the vendor and the customer in each document type. - [Advanced invoicing](https://docs.e-invoice.be/guides/advanced-invoicing.md): Add allowances (discounts) and charges (fees) to an invoice at document level and at line level. - [Invoice totals and calculations](https://docs.e-invoice.be/guides/invoice-totals.md): Calculate the totals of an invoice in the same way as the API, so that the API accepts the values that you send. - [Attachments and PDF](https://docs.e-invoice.be/guides/attachments.md): Add files to an invoice so that the receiver gets them in the UBL, let the platform generate a PDF, and download attachments and UBL files. - [Look up Peppol participants](https://docs.e-invoice.be/guides/lookup-participants.md): Find the Peppol ID of a customer and make sure that the customer can receive invoices before you send. - [Receive documents](https://docs.e-invoice.be/guides/receiving-documents.md): Find the documents that your suppliers send to you through Peppol, read their data, and download the original UBL, the PDF and the attachments. - [List, filter and manage documents](https://docs.e-invoice.be/guides/managing-documents.md): List your documents with pagination, filters and sort options, and validate, send or delete drafts. - [Document lifecycle and delivery tracking](https://docs.e-invoice.be/guides/document-lifecycle.md): Follow a document through its states, read its timeline, and interpret the Peppol responses that the receiver returns. - [Usage statistics and credits](https://docs.e-invoice.be/guides/usage-statistics.md): Read the number of sent and received documents per day, week or month, and compare the usage with the credit balance of your company. - [Send UBL documents](https://docs.e-invoice.be/guides/ubl-documents.md): Validate, create and send an invoice or credit note from a UBL XML file that your system generates. - [Create documents from PDF](https://docs.e-invoice.be/guides/pdf-documents.md): Upload a PDF invoice, get the extracted invoice data and a UBL document, and send the result through Peppol. - [Send invoices by email (Mailbox)](https://docs.e-invoice.be/guides/mailbox.md): Create draft e-invoices from emails with a UBL or PDF attachment, and monitor, download and retry those emails with the Mailbox API. - [Webhooks](https://docs.e-invoice.be/essentials/webhooks.md): Create a webhook, verify the signature of each event in your receiver, and debug deliveries with the test call and the delivery history. - [Model Context Protocol (MCP)](https://docs.e-invoice.be/essentials/mcp.md): Connect an AI assistant to your e-invoice.be company with the Model Context Protocol (MCP) and read your documents, Peppol data and usage statistics. - [Errors and troubleshooting](https://docs.e-invoice.be/guides/errors.md): Read the error formats and status codes of the e-invoice.be API, correct frequent validation failures and retry failed requests safely. - [SDKs](https://docs.e-invoice.be/sdks.md): Install an official e-invoice.be SDK for TypeScript, Python, Ruby, PHP or Java and validate, create and send a document with typed calls. - [peppol CLI](https://docs.e-invoice.be/cli.md): Install the peppol command-line tool and validate, create and send Peppol documents from a terminal or a script. - [Reseller programme](https://docs.e-invoice.be/reseller-programme.md): Offer Peppol e-invoicing to your customers through one integration with e-invoice.be. - [Admin API](https://docs.e-invoice.be/admin-api.md): Create tenants, issue API keys and register tenants on Peppol with the organisation API key of a reseller. - [Glossary](https://docs.e-invoice.be/glossary.md): Find the definition of each Peppol, e-invoicing and e-invoice.be term that this documentation uses. - [Changelog](https://docs.e-invoice.be/changelog.md): See which API behaviour and documentation changed, and which endpoints and parameters are deprecated. - [API reference](https://docs.e-invoice.be/api-reference.md): Find the host, the authentication, all endpoints, the response formats and the limits of the e-invoice.be API. - [Document](https://docs.e-invoice.be/api-reference/schemas/document.md): Look up each field of the Document schema and see how the API converts it to UBL BIS Billing 3.0. - [LineItem](https://docs.e-invoice.be/api-reference/schemas/line-item.md): Look up each field of an invoice line, with its type, its rules and an example value. - [Create Document](https://docs.e-invoice.be/api-reference/documents/create-document.md): Create a new invoice or credit note - [Send Document](https://docs.e-invoice.be/api-reference/documents/send-document.md): Send an invoice or credit note via Peppol. By default, the sender and receiver Peppol IDs are derived from the company (tax) IDs in the document, regardless of whether the document was created from a UBL with a different endpoint ID. To explicitly set the sender or receiver Peppol ID, provide them v… - [Validate Document](https://docs.e-invoice.be/api-reference/documents/validate-document.md): Validate a UBL document according to Peppol BIS Billing 3.0 - [Get Document Attachments](https://docs.e-invoice.be/api-reference/documents/get-document-attachments.md): Get all attachments for an invoice or credit note - [Add Attachment](https://docs.e-invoice.be/api-reference/documents/add-attachment.md): Add one or more attachments to an invoice. Be careful: the attachments ARE NOT ADDED to the UBL! They are only stored in our database and can be downloaded later. To add attachments to the UBL, you need to add the attachment(s) via POST /api/documents - [Get Document](https://docs.e-invoice.be/api-reference/documents/get-document.md): Get an invoice or credit note by ID - [Delete Document](https://docs.e-invoice.be/api-reference/documents/delete-document.md): Delete an invoice or credit note - [Get Document Attachment](https://docs.e-invoice.be/api-reference/documents/get-document-attachment.md): Get attachment details with for an invoice or credit note with link to download file (signed URL, valid for 1 hour) - [Delete Document Attachment](https://docs.e-invoice.be/api-reference/documents/delete-document-attachment.md): Delete an attachment from an invoice or credit note - [Get Document UBL](https://docs.e-invoice.be/api-reference/documents/get-document-ubl.md): Get the UBL for an invoice or credit note - [Create Document from UBL](https://docs.e-invoice.be/api-reference/documents/create-document-from-ubl.md): Create a new invoice or credit note from a UBL file - [Create Document from PDF](https://docs.e-invoice.be/api-reference/documents/create-document-from-pdf.md): Create a new invoice or credit note from a PDF file. If the 'ubl_document' field is set in the response, it indicates that sufficient details were extracted from the PDF to automatically generate a valid UBL document ready for sending. If 'ubl_document' is not set, human intervention may be required… - [Get Document Timeline](https://docs.e-invoice.be/api-reference/documents/get-document-timeline.md): Get the timeline of events for an invoice or credit note, including creation, validation, transmission, and delivery events - [List Received Documents](https://docs.e-invoice.be/api-reference/inbox/list-received-documents.md): Retrieve a paginated list of received documents with filtering options including state, type, sender, date range, and text search. - [List Received Invoices](https://docs.e-invoice.be/api-reference/inbox/list-received-invoices.md): Retrieve a paginated list of received invoices with filtering options. - [List Received Credit Notes](https://docs.e-invoice.be/api-reference/inbox/list-received-credit-notes.md): Retrieve a paginated list of received credit notes with filtering options. - [List Inbound Emails](https://docs.e-invoice.be/api-reference/mailbox/list-inbound-emails.md): Retrieve a paginated list of received inbound emails with filtering, search, and sorting options. - [Get Inbound Email Detail](https://docs.e-invoice.be/api-reference/mailbox/get-inbound-email-detail.md): Retrieve a single inbound email by ID, scoped to the caller's tenant. - [Download Inbound Email Attachment](https://docs.e-invoice.be/api-reference/mailbox/download-inbound-email-attachment.md): Download a specific attachment from an inbound email by filename. Returns the binary content with the correct Content-Type. - [Reprocess Failed Inbound Email](https://docs.e-invoice.be/api-reference/mailbox/reprocess-failed-inbound-email.md): Retry processing of a previously failed inbound email by replaying the original Postmark payload. - [List Sent Documents](https://docs.e-invoice.be/api-reference/outbox/list-sent-documents.md): Retrieve a paginated list of sent documents with filtering options including state, type, sender, date range, and text search. - [List Draft Documents](https://docs.e-invoice.be/api-reference/outbox/list-draft-documents.md): Retrieve a paginated list of draft documents with filtering options including state and text search. - [List Draft Documents](https://docs.e-invoice.be/api-reference/drafts/list-draft-documents.md): Retrieve a paginated list of draft documents with filtering options including state and text search. - [Validate UBL Document](https://docs.e-invoice.be/api-reference/validate/validate-ubl-document.md): Validate the correctness of a UBL document - [Validate JSON Document](https://docs.e-invoice.be/api-reference/validate/validate-json-document.md): Validate if the JSON document can be converted to a valid UBL document - [Validate Peppol ID](https://docs.e-invoice.be/api-reference/validate/validate-peppol-id.md): Validate if a Peppol ID exists in the Peppol network and retrieve supported document types. The peppol_id must be in the form of `:`. The scheme is a 4-digit code representing the identifier scheme, and the id is the actual identifier value. For example, for a Belgian company it is `0208… - [Lookup Peppol ID](https://docs.e-invoice.be/api-reference/lookup/lookup-peppol-id.md): Lookup Peppol ID. The peppol_id must be in the form of `:`. The scheme is a 4-digit code representing the identifier scheme, and the id is the actual identifier value. For example, for a Belgian company it is `0208:0123456789` (where 0208 is the scheme for Belgian enterprises, followed b… - [Lookup Peppol participants](https://docs.e-invoice.be/api-reference/lookup/lookup-peppol-participants.md): Lookup Peppol participants by name or other identifiers. You can limit the search to a specific country by providing the country code. - [Get information about your account](https://docs.e-invoice.be/api-reference/tenant/get-information-about-your-account.md): Retrieve information about your account. - [Get Usage Statistics](https://docs.e-invoice.be/api-reference/tenant/get-usage-statistics.md): Retrieve usage statistics for billing purposes. Returns statistics for document sent and document received actions, grouped by aggregation period (day/week/month). If no date parameters are provided, returns daily stats for all available data. - [Get All Webhooks](https://docs.e-invoice.be/api-reference/webhooks/get-all-webhooks.md): Get all webhooks for the current tenant - [Create Webhook](https://docs.e-invoice.be/api-reference/webhooks/create-webhook.md): Create a new webhook - [Get Webhook](https://docs.e-invoice.be/api-reference/webhooks/get-webhook.md): Get a webhook by ID - [Update Webhook](https://docs.e-invoice.be/api-reference/webhooks/update-webhook.md): Update a webhook by ID - [Delete Webhook](https://docs.e-invoice.be/api-reference/webhooks/delete-webhook.md): Delete a webhook - [Get Webhook History](https://docs.e-invoice.be/api-reference/webhooks/get-webhook-history.md): Get the history of a webhook - [Test Webhook](https://docs.e-invoice.be/api-reference/webhooks/test-webhook.md): Send a test event to a webhook for testing and debugging purposes - [Convert a PDF to a document](https://docs.e-invoice.be/api-reference/conversion/convert-a-pdf-to-a-document.md): Convert a PDF to a document - [Get PDF conversion status](https://docs.e-invoice.be/api-reference/conversion/get-pdf-conversion-status.md): Get the status of a PDF conversion task - [Get PDF conversion result](https://docs.e-invoice.be/api-reference/conversion/get-pdf-conversion-result.md): Get the result of a PDF conversion task ## OpenAPI Specs - [openapi](/openapi.json) ## Optional - [GitHub](https://github.com/e-invoice-be) - [API explorer](https://api.e-invoice.be/docs) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.