---
title: "/ean/{ean}"
method: GET
path: "/v1/ean/{ean}"
tags: ["E-invoicing"]
---

# /ean/{ean}

`GET /v1/ean/{ean}`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/ean/{ean}`
- Auth: HTTP bearer

Look up an EAN number (GLN location number) used for electronic invoicing.

Returns who receives documents on that EAN, the CVR number behind it,
which document kinds and invoice formats it accepts (OIOUBL, Peppol BIS
Billing 3.0 and others), and the company as we hold it. Endpoints that
have left the Peppol Directory are still returned with `active: false`.

## Path parameters

- `ean` string, required: EAN (GLN) number, usually 13 digits

## Query parameters

- `include` string, nullable: Set to document_types to include the raw Peppol document type identifiers

## Response `200`

Successful Response

- EanLookupResponse
  - `ean` string, required
  - `endpoint` EInvoicingEndpoint, required: One electronic address (Peppol participant) that can receive documents.
    - `endpoint_id` string, required: Scheme and value, e.g. 0088:5790000000000
    - `participant_id` string, required: Full Peppol participant identifier
    - `scheme` string, required: ISO 6523 scheme code: 0088 EAN/GLN, 0184 CVR, 0096 P-number, 0198 SE-number
    - `scheme_name` string, required: gln, cvr, p_number, se_number or other
    - `ean` string, nullable: The EAN (GLN) number when the endpoint is an EAN address
    - `cvr` string, nullable: CVR number of the receiving company, when stated or derivable
    - `cvr_source` string, nullable: Where the CVR came from: participant, identifier, vat, p_number or se_number
    - `p_number` string, nullable
    - `se_number` string, nullable
    - `name` string, nullable: Name on the business card
    - `names` EndpointName[]
      - `name` string, required
      - `lang` string, nullable: Language code when the card states one
    - `country_code` string, nullable
    - `geo_info` string, nullable
    - `identifiers` EndpointIdentifier[]
      - `scheme` string, required: Identifier scheme as published, e.g. OrgNr or VAT
      - `value` string, required
    - `websites` string[]
    - `contacts` EndpointContact[]: Contacts on the card, often the access point provider
      - `type` string, nullable
      - `name` string, nullable
      - `phone` string, nullable
      - `email` string, nullable
    - `additional_info` string, nullable
    - `registration_date` string, nullable: Business card registration date (YYYY-MM-DD)
    - `can_receive_invoice` boolean, required: True when the endpoint accepts at least one invoice format
    - `accepts` string[]: Document kinds accepted: invoice, credit_note, reminder, order, order_response, ...
    - `invoice_formats` string[]: Invoice formats accepted: oioubl_2.1, oioubl_2.02, peppol_bis_3_ubl, peppol_bis_3_cii, peppol_pint, peppol_selfbilling, en16931
    - `document_types` string[], nullable: Raw Peppol document type identifiers (only with include=document_types)
    - `active` boolean: False when the endpoint has disappeared from the Peppol Directory
    - `first_seen_at` string, date-time, nullable
    - `last_seen_at` string, date-time, nullable
    - `removed_at` string, date-time, nullable
  - `company` CompanyRef
    - `cvr` string, required
    - `name` string, nullable
    - `status` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)
