Documentation

Fetch products

These endpoints require an API key when keys are enabled. Successful JSON includes status: 200, base status fields, then the requested data. Missing products return HTTP 404.

Selected fields

GET /api/details/{productId}

curl -sS -H "X-Api-Key: YOUR_KEY" \
  "https://{instance}.fmcgproducts.dk/api/details/01234567890123.208?fields=D8258_1,D8259_1"

Query parameters:

  • fields - comma-separated field ids (grid fields may include _n)
  • displayValues - if true, keyword fields return display text
  • activeVersion - if true, returns the active version from grid X9200 where X9202 is yes

Every details response includes at least:

Property Meaning
productId {GTIN}.{country}
unitType GS1 unit type
lastModified Last change
fmcgProductsStatus SENT, FAILED, OK or PENDING
gs1Status Status as returned for the API
gs1LastSendDate Last send to GS1
validationErrors Current GS1 validation errors
epdNumber / epdStatus Set for Norwegian top products (country 578)

These GET responses also send ETag and Last-Modified headers. See Caching.

Export profile

GET /api/details/{productId}/{exportProfileId}

The export profile on the instance names the field list and whether to use display values. Unknown profile ids return HTTP 400.

Internal item number

GET /api/details/{unitType}/{targetMarket}/{itemId}/{exportProfileId}

Looks up the active product for unit type, target market and internal product number D8256.

All visible fields

GET /api/details/{productId}/allfields

Returns every visible field for that unit type. Supports displayValues and activeVersion.

History

GET /api/history/{productId}

Returns productId, unitType, lastModified and history (document log events).

To list many products at once, use views or status.