Developer platform

Compliance data and documents

Reference data and file parsers that transport software keeps having to rebuild: ADR lookups, tachograph files, and PDF or Excel files turned into rows.

Runs on: Transportial's own ADR table and tachograph parser.

EndpointPermissionWhat it does
GET /adr/un-numbersPublicSearch ADR Table A. Public, no key needed.
GET /adr/un-numbers/{unNumber}PublicOne UN number, optionally translated.
POST /tachograph/convert/binaryconvert:tachographParse a driver or vehicle tachograph file (multipart).
POST /file/toMatrixtoMatrix:fileA PDF or Excel file as rows and cells (multipart).
POST /file/toHtmltoMatrix:fileA PDF or Excel file as HTML (multipart).

Base URL https://api.app.transportial.com/api. Send x-api-key and x-api-secret, from an API access integration holding the permission above. Note that a missing permission answers 401 and missing authentication answers 403.

ADR by UN number

Search by number or name and filter by class. Each entry carries the classification code, packing group, tunnel code and transport category, so you can validate a dangerous goods line without maintaining the table yourself.

Parsing in memory

Tachograph and file conversion happen in memory, and nothing is kept. These endpoints answer HTTP 200 with success: false when a file cannot be read, so check that field.

Example

Look up UN 1203

This one needs no key. Try it from your terminal.

Call
curl "https://api.app.transportial.com/api/adr/un-numbers?search=1203&max=1"
Response
{
  "success": true,
  "adrUnNumbers": [
    {
      "unNumber": "1203",
      "name": "MOTOR SPIRIT or GASOLINE or PETROL",
      "adrClass": "3",
      "classificationCode": "F1",
      "packingGroup": "II",
      "dangerLabels": "3",
      "limitedQuantities": "1 L",
      "transportCategory": "2",
      "tunnelCode": "D/E",
      "hazardIdentificationNumber": "33",
      "carriageRestrictions": "Carriage in BULK is not permitted"
    }
  ],
  "totalResults": 1
}

Trimmed to the main fields.

Limits worth knowing

  • Translating an ADR entry with language may store that translation for reuse.

Questions

Do I need an account for the ADR lookup?
No. GET /adr/un-numbers is public.