JSON API

The fmcgProducts API is a JSON web API on each customer instance. Other systems can create and update product master data, check GS1 status, and fetch the same validated data that you send to GS1 and EPD.

GET /api

A GET to the API root is public. It returns the product name, build version, and links to the live OpenAPI description:

{
  "status": 200,
  "product": "fmcgProducts",
  "version": "…",
  "documentation": "/api/openapi",
  "documentationAsJson": "/api/openapi.json"
}

If you call it while logged in, the response also includes username.

Base URL

Replace {instance} with the company host:

https://{instance}.fmcgproducts.dk/api

Each instance has its own products, views, export profiles, API keys and templates.

What you can do

• Update a product, or several products, as JSON. Send only the fields that changed (a delta) or a fuller set of fields. The same request can create a product when the GTIN and target market do not exist yet.
• Validate a draft in memory (test: true or POST /api/validate) without saving.
• Check status after an update: accepted, in progress, rejected, and GS1 validation errors.
• Fetch selected fields, a view, Excel, PDF or HTML product sheets, and the company logo.
• Send a hierarchy to GS1, or withdraw it, when the data is ready.

Field names in JSON are fmcgProducts field ids such as D8165 (GTIN) and D8255 (target market country number). Identifiers and fields explains the keys. Authentication explains X-Api-Key.

Live OpenAPI

Each instance serves the OpenAPI UI at /api/openapi and the document at /api/openapi.json. Use that when you need the exact description for that build. These pages are the human-readable guide and stay in sync with the source; they do not list hidden or internal endpoints.

Typical flow

1. Create or update units with POST /api.
2. Read validationErrors and fmcgProductsStatus (or call GET /api/status/{productId}).
3. When the hierarchy is valid, POST /api/sendToGS1 or use POST /api/update-and-sendToGS1.
4. Website, webshop or intranet fetch JSON, images and product sheets from the same source.

Need a key or an instance URL? Contact us or use the helpdesk.