Developers · ADR 2025

DGMind API & embed

A read-only JSON API over the verified ADR 2025 dataset and rule engine. Every response carries its ADR citation and a decision-support disclaimer. This is decision-support, not legal authorisation — your named DGSA signs off before dispatch.

Authentication

Send your key in the x-api-key header on every request. Keys are issued per partner — contact us to get one. A missing or invalid key returns 401.

curl https://dgmind.co.uk/api/v1/un?un=1203 \
  -H "x-api-key: YOUR_API_KEY"

Rate limited per key/IP (fixed window, default 60 requests/minute). CORS is enabled for browser calls from partner sites (GET/POST).

Endpoints

GET/api/v1/un?un=1203
Classification for a UN number — class, name, packing group, labels, tunnel code, limited & excepted quantities. Also available as /api/v1/un/1203. Unknown UN → 404 { "error": "UN not found in ADR 2025 dataset" }.
{
  "un": "1203",
  "count": 1,
  "entries": [
    {
      "unNumber": "1203",
      "name": "MOTOR SPIRIT or GASOLINE or PETROL",
      "class": "3",
      "packingGroup": "II",
      "primaryLabel": "3",
      "tunnelRestrictionCode": "(D/E)",
      "limited": { "value": "1 L", "permitted": true, "explanation": "..." },
      "excepted": { "code": "E3", "permitted": true, "explanation": "..." }
    }
  ],
  "citation": "ADR 2025 · 3.2.1 Table A — Dangerous Goods List (entry for UN1203)",
  "disclaimer": "Decision-support only — verify against the cited ADR clause before dispatch. Not legal advice.",
  "adrEdition": "ADR 2025"
}
POST/api/v1/segregation
Mixed-loading outcome for two UN numbers (ADR 7.5.2.1). A missing matrix cell defaults to prohibited per ADR — never assumed safe.
curl -X POST https://dgmind.co.uk/api/v1/segregation \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "unA": "1203", "unB": "1789" }'
POST/api/v1/transport-document
The ADR 5.4.1.1.1 consignment line + structured fields + the 5.2 marking checklist for a UN number. Output is a draft to verify and sign.
curl -X POST https://dgmind.co.uk/api/v1/transport-document \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "un": "1203" }'
POST/api/v1/check
The full Ship-This-Safely aggregate: classification, 1.1.3.6 threshold, all segregation pairs and per-item tunnel checks, combined into one traffic-light verdict.
curl -X POST https://dgmind.co.uk/api/v1/check \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "items": [{ "un": "1203", "qty": 100 }, { "un": "1789", "qty": 50 }], "tunnel": "E" }'

Embeddable UN-lookup widget

Drop the UN lookup into your own site with an iframe. Add ?brand=<slug> to show your name, accent colour and a “Powered by DGMind” footer.

<iframe
  src="https://dgmind.co.uk/embed/un-lookup?brand=xeagle"
  width="100%" height="640" style="border:0;border-radius:12px"
  title="UN number lookup — ADR 2025"></iframe>

Preview the branded widget →

White-label & enterprise

Single sign-on (SSO)

SAML / OIDC SSO is available on enterprise onboarding — it is wired to your identity provider as part of setup, so it is not a self-serve toggle here. Contact us to start enterprise onboarding (SSO, white-label branding, and a dedicated API key).

All endpoints are read-only and return decision-support information cited to ADR 2025. They do not authorise carriage — the named DGSA / consignor verifies and signs off before dispatch.