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

# /ean

`GET /v1/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`
- Auth: HTTP bearer

Find EAN numbers and other e-invoicing endpoints by CVR number or name.

A municipality or a large company often has hundreds of EAN numbers, one
per department or location; the name on each card tells them apart.
EAN endpoints come first, then CVR endpoints.

## Query parameters

- `cvr` string, nullable: All endpoints of this CVR number
- `name` string, nullable: Part of the name on the business card
- `active` boolean: Only endpoints currently in the Peppol Directory
- `include` string, nullable: Set to document_types to include the raw Peppol document type identifiers
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- EanSearchResponse
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `endpoints` EInvoicingEndpoint[], required
    - `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

## 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)