Search operator licences
search_operatorsRead-onlyIdempotent
Find GB goods vehicle and PSV operators by company name, operator licence number (e.g. OB1234567) or Companies House number. Returns up to limit matches with status, licence type, traffic area, town and the canonical page URL. Exact licence and company numbers rank first; names match companies and organisations only (sole traders and partnerships are found only by exact licence number and are never named). Optional filters narrow by traffic area, vehicle category, status, licence type or presence in the latest DVSA file.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results (1–50) | |
| query | Yes | Company name, licence number (two letters + seven digits) or company number | |
| filters | No |
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 |