[Developer platform](/en/developers)

# 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.

| Endpoint                        | Permission         | What it does                                           |
| ------------------------------- | ------------------ | ------------------------------------------------------ |
| GET /adr/un-numbers             | Public             | Search ADR Table A. Public, no key needed.             |
| GET /adr/un-numbers/{unNumber}  | Public             | One UN number, optionally translated.                  |
| POST /tachograph/convert/binary | convert:tachograph | Parse a driver or vehicle tachograph file (multipart). |
| POST /file/toMatrix             | toMatrix:file      | A PDF or Excel file as rows and cells (multipart).     |
| POST /file/toHtml               | toMatrix:file      | A 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.

[Create a developer account](https://portal.otms.transportial.com/auth/developer/register)[Read the guide](https://docs.transportial.com/examples/adr-and-tachograph)[How it works](/en/blog/adr-un-number-tachograph-file-api)

---
Canonical page: https://transportial.com/en/developers/algorithms/compliance-and-documents