Look up barcodes

When to use this. Barcodes are the pool of EAN barcode values held for your organisation and assigned to SKUs and style assortments elsewhere in the product lifecycle. This endpoint is a read-only lookup: use it to list those barcodes and check which are already linked. Assigning a barcode to a SKU is done on the style’s SKUs, not here.

The workflow

A barcode is an organisation-level value. The usual path is to look the pool up, filter by whether a barcode is already linked, and then reference the ones you need when working with a style’s SKUs.

List barcodes

GET /api/barcodes to read the organisation’s barcodes, one page at a time.

Filter by linkage

Narrow the list with linkedToSku and linkedToStyleAssortment to find barcodes that are already assigned or still free.

Page through the results

Follow pagination.cursor (or increment pageNumber) until hasMore is false.

Walkthrough

List the organisation’s barcodes and read the linkage flags off each row. The response wraps the barcodes in the standard paginated envelope.

curl "https://service.my.delogue.com/api/barcodes" \
  -H "Accept: application/json" \
  -H "X-Auth-Token: Bearer YOUR_API_KEY"

const res = await fetch("https://service.my.delogue.com/api/barcodes", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-Auth-Token": "Bearer YOUR_API_KEY",
  },
});
const { data } = await res.json();

{
  "status": "success",
  "code": "barcodes_retrieved",
  "data": [
    {
      "id": 10432,
      "barcode": "5710000000015",
      "properties": [
        "linkedToSku"
      ]
    },
    {
      "id": 10433,
      "barcode": "5710000000022",
      "properties": [
        "linkedToSku",
        "linkedToStyleAssortment"
      ]
    },
    {
      "id": 10434,
      "barcode": "5710000000039",
      "properties": []
    }
  ],
  "pagination": {
    "hasMore": true,
    "cursor": "eyJJZCI6MTA0MzR9"
  }
}

Each row carries a properties array: linkedToSku appears when the barcode is linked to a SKU, and linkedToStyleAssortment when it is linked to a style assortment. An empty array means the barcode is not yet linked to either.

Field reference

The fields on a barcode:

Field	What it means at Delogue
`barcode`	The barcode value, e.g. an EAN-13 number.
`id`	Unique identifier of the barcode.
`properties`	Linkage flags present on the barcode. Contains linkedToSku when the barcode is linked to a SKU and linkedToStyleAssortment when it is linked to a style assortment.

Roles & permissions

Reading barcodes requires the barcodes permission on a designer (brand) account with the Barcodes module enabled — typically a user holding the SKU/Barcodes role. Supplier accounts cannot read the barcode pool and receive a 403. Results are always scoped to your own organisation.

When things go wrong

Errors use the standard envelope (status: "error", a code, and error.details[]). Supplying cursor together with a filter or pageSize/pageNumber is a 400, and pageSize above 100 is rejected. See Errors & responses for the full list of codes and how to resolve them.

What to call next

Style SKUs

See the SKUs barcodes are assigned to: GET /api/skus.

Styles

Work with the styles whose SKUs and assortments barcodes attach to.

Authentication

How to get and send your X-Auth-Token API key.

Getting Started

Concepts

Guides

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next

Style SKUs

Styles

Authentication

​The workflow

​Walkthrough

​Field reference

​Roles & permissions

​When things go wrong

​What to call next

Style SKUs

Styles

Authentication

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next