Retrieve Invoice

GET/api/v1/invoices/{invoice_id}

The invoice model contains the basic properties of a PEPPOL invoice object alongside some additional properties that are initialized by Greek sellers. Below is a list of all the properties that are included in the invoice object.

This endpoint allows you to retrieve am invoice by providing the invoice unique id. Below is an example request and response. Please ensure to replace {token} with your actual authentication token and {id} with the invoice unique identifier.

Request example with cURL

curl https://sandbox-api.peppol.gr/api/v1/invoices/{id} \
  -H "Authorization: Bearer {token}"

Response example

{
  "id": "01kev9gvvrwggfmbjb3zg4qvb3",
  "is_locked": true,
  "response_code": null,
  "invoice_number": "8853787386|13/01/2026|0|1.1|A|3553",
  "issue_date": "2025-12-31",
  "invoice_type": 380,
  "currency": "EUR",
  "buyer_reference": "ipsum",
  "project_reference": "asperiores",
  "contract_reference": "maiores",
  "billing_reference": null,
  "seller_tin": "999999999",
  "seller_name": "Roxanne Hyatt",
  "seller_country": "GR",
  "buyer_id": "1007.80239251.0064",
  "buyer_tin": "888888888",
  "buyer_name": "Liza Schuster",
  "buyer_country": "PL",
  "mark": 90000000268807235,
  "auth_code": "5B0632AE9150D608738702E0728E6326222A6AEE",
  "total_net_amount": 3161.23,
  "total_allowance_amount": 0,
  "total_charges_amount": 0,
  "total_tax_exclusive_amount": 3161.23,
  "total_tax_inclusive_amount": 3919.93,
  "total_prepaid_amount": 0,
  "total_rounding_amount": 0.07,
  "total_payable_amount": 3920,
  "created_at": "2026-01-13T09:03:21.000000Z",
  "updated_at": "2026-01-13T09:03:21.000000Z",
  "url": "https://sandbox-api.peppol.gr/api/v1/invoices/01kev9gvvrwggfmbjb3zg4qvb3/preview",
  "transmissions": [
    {
      "id": "01jzff43aa5hg4r1y8gd530eh",
      "response_code": "IP",
      "status_code": 200,
      "error_message": null,
      "created_at": "2026-01-13T09:03:21.000000Z",
      "responses": [
        {
          "response_code": "IP",
          "reason_code": "NON",
          "reason": "No issue",
          "created_at": "2026-01-13T012:11:05.000000Z"
        },
        {
          "response_code": "AB",
          "reason_code": "OTH",
          "reason": "OK",
          "created_at": "2026-01-13T011:43:25.000000Z"
        }
      ]
    }
  ]
}

Invoice properties

Field	BT	Type	Description
id		string	Unique identifier for the invoice.
is_locked		boolean	Whether or not the invoice is in a state that can be modified.
response_code		string	The last PEPPOL response code (state) associated with the invoice. See all the response codes
invoice_number	BT-1	string	The unique identification of the Invoice
issue_date	BT-2	string	The date the invoice was issued.
invoice_type	BT-3	int	A code specifying the functional type of the Invoice. Use 380 for Debit Invoices and 381 for Credit Invoices.
currency	BT-5	string	Invoice currency code
buyer_reference	BT-10	string	An identifier assigned by the Buyer used for internal routing purposes.
project_reference	BT-11	string	The identification of the project the invoice refers to.
contract_reference	BT-12	string	The identification of a contract.
billing_reference	BT-25	string	Information of the preceding Invoice.
seller_tin	BT-31	string	The Seller's VAT identifier.
seller_name	BT-27	string	The Seller's registration name.
seller_country	BT-40	string	The Seller's country code (ISO 3166-1:Alpha2).
buyer_id	BT-46	string	An identifier of the Buyer.
buyer_tin	BT-48	string	The Buyers's VAT identifier.
buyer_name	BT-44	string	The Buyers's registration name.
buyer_country	BT-55	string	The Buyers's country code (ISO 3166-1:Alpha2).
mark		string	The ΜARK identifier that was assigned by myDATA (for Greek sellers).
auth_code		string	The Authentication Code that was assigned by myDATA (for Greek sellers).
total_net_amount	BT-106	float	The total net amount of the Invoice.
total_allowance_amount	BT-107	float	The total allowance net amount of the Invoice.
total_charges_amount	BT-108	float	The total charges amount of the Invoice.
total_tax_exclusive_amount	BT-109	float	The total tax exclusive amount of the Invoice.
total_tax_inclusive_amount	BT-112	float	The total tax inclusive amount of the Invoice.
total_prepaid_amount	BT-113	float	The total prepaid amount of the Invoice.
total_rounding_amount	BT-114	float	The total rounding amount of the Invoice.
total_payable_amount	BT-115	float	The total payable amount of the Invoice.
url		string	The URL to preview the invoice PDF.
transmissions		array	An array of transmission objects associated with the invoice.
created_at		string	The timestamp when the invoice was created.
updated_at		string	The timestamp when the invoice was last updated.