Download the EAN registry

curl --request GET \
  --url https://app.buylo.ai/api/external/ean-registry \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": 42,
      "ean": "8591234567890",
      "name": {
        "en": "Brazil Santos Coffee",
        "cs": "Brazilská káva Santos"
      },
      "description": {
        "en": "Roasted Arabica coffee beans from Brazil",
        "cs": "Pražená arabica z Brazílie"
      },
      "prices": [
        {
          "currency": "CZK",
          "price": 249.9
        }
      ],
      "status": "active",
      "category": "Coffee",
      "brand": "Santos",
      "vat_rate": 21,
      "unit": "kg"
    }
  ],
  "total": 137,
  "truncated": false
}

EAN Registry

Download the EAN registry

Returns the full EAN registry available to the company behind the bearer token.

Privacy is controlled by the tenant-level private_ean_registry feature flag:

When the flag is enabled, only the tenant’s own EAN records are returned.
When the flag is disabled, the shared/global EAN pool is returned.

The endpoint returns the full registry in a single response (no pagination). A hard cap of 5000 records per response protects the server. If the registry exceeds 5000 entries, only the first 5000 are returned and truncated is set to true.

GET

api

external

ean-registry

Download the EAN registry

curl --request GET \
  --url https://app.buylo.ai/api/external/ean-registry \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": 42,
      "ean": "8591234567890",
      "name": {
        "en": "Brazil Santos Coffee",
        "cs": "Brazilská káva Santos"
      },
      "description": {
        "en": "Roasted Arabica coffee beans from Brazil",
        "cs": "Pražená arabica z Brazílie"
      },
      "prices": [
        {
          "currency": "CZK",
          "price": 249.9
        }
      ],
      "status": "active",
      "category": "Coffee",
      "brand": "Santos",
      "vat_rate": 21,
      "unit": "kg"
    }
  ],
  "total": 137,
  "truncated": false
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

items

object[]

required

Show child attributes

total

integer

required

Number of entries returned in this response (equals items.length).

Example:

137

truncated

boolean

required

True if the registry exceeded the 5000-record cap and the response was truncated.

Example:

false

List all locations