Get an operator licence
get_licenceRead-onlyIdempotent
Full record of one GB operator licence by its number: holder (company name and number; never a sole trader's or partner's name), licence type, status, vehicles and trailers authorised, continuation date, operating centres, Companies House status, DVSA earned recognition, upcoming public inquiries, Traffic Commissioner decisions, Gazette insolvency notices and the change history between DVSA files. Licences no longer in the latest file are returned with in_current_file: false.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| licence_number | Yes | Operator licence number, e.g. OB1234567 (O = goods, P = PSV; second letter = traffic area) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| source | Yes | Data source(s) the result is built from | |
| licence | Yes | Licence of the source data | |
| file_date | Yes | Date of the DVSA operator licence file the data describes (null before the first import) | |
| source_url | Yes | Where the primary source dataset is published | |
| attribution | Yes | Attribution text to show with the data | |
| markdown_url | Yes | Markdown version of the canonical page | |
| retrieved_at | Yes | When this response was generated (ISO timestamp) | |
| canonical_url | Yes | The human-readable HaulierScope page for this result |