area_stats

Statistics for one of the eight GB traffic areas: licences, operators, vehicles and trailers authorised, the mix by licence type and status, the largest operators by vehicles authorised, and towns with at least five company licences (with links).

read-only

Argument	Type	Description
area*	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "area"
  ],
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    }
  }
}

biggest_operators

Ranking of companies by vehicles authorised in the latest DVSA file: 'haulage-companies' (Standard goods licences, top 100 nationally) or 'coach-and-bus-operators' (PSV licences), or the top 50 in one traffic area. Each row: rank, company, company number, vehicles and trailers, licences, main traffic area, earned recognition, Companies House status and share of all vehicles in scope. Companies only.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
kind	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "kind": {
      "enum": [
        "haulage-companies",
        "coach-and-bus-operators"
      ],
      "type": "string",
      "default": "haulage-companies"
    }
  }
}

data_status

Date and age of every source behind HaulierScope (DVSA operator licence file, Companies House register, DVSA earned recognition list, Traffic Commissioner notices and decisions, The Gazette), when we last checked for a newer DVSA file, and every DVSA file held (usable as `release` in recent_changes).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

fetch

Full text (Markdown) of a result from search: an id like 'licence:OB1234567', 'company:02155951' or 'guide:vet-a-haulier', or a HaulierScope page URL. The text carries the DVSA file date, sources and the canonical URL.

read-only

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "minLength": 3
    }
  }
}

filing_watch

Companies holding operator licences whose accounts were overdue at the Companies House register date, largest fleets first, with totals by traffic area. Optionally for one traffic area. Companies only. A filing fact, not a sign of insolvency.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1
    }
  }
}

get_company

All operator licences held by one company or organisation, by Companies House number (e.g. 02155951 or SC096849): totals of licences, vehicles, trailers and operating centres, each licence with its status and continuation date, Companies House status (liquidation, administration, receivership, accounts overdue; dissolved only when verified by number and name), earned recognition, public inquiries, Traffic Commissioner decisions and Gazette notices.

read-only

Argument	Type	Description
company_number*	string	Companies House number, e.g. 02155951 or SC096849

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "company_number"
  ],
  "properties": {
    "company_number": {
      "type": "string",
      "maxLength": 10,
      "minLength": 5,
      "description": "Companies House number, e.g. 02155951 or SC096849"
    }
  }
}

get_licence

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.

read-only

Argument	Type	Description
licence_number*	string	Operator licence number, e.g. OB1234567 (O = goods, P = PSV; second letter = traffic area)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "licence_number"
  ],
  "properties": {
    "licence_number": {
      "type": "string",
      "maxLength": 12,
      "minLength": 9,
      "description": "Operator licence number, e.g. OB1234567 (O = goods, P = PSV; second letter = traffic area)"
    }
  }
}

insolvency_watch

Companies holding operator licences that the Companies House register shows in liquidation, administration or receivership, largest fleets first, with totals by traffic area and recent Gazette insolvency notices. Optionally for one traffic area. Companies only. Accounts overdue is not insolvency: use filing_watch. Each fact is dated to the register; whether a licence continues is a matter for the Traffic Commissioner.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1
    }
  }
}

licences_ended

Operator licences the Traffic Commissioners published in one month as revoked, surrendered or terminated, each with the heading it was printed under (official wording), the date with effect from, the bulletin and its GOV.UK link, and where the company can add a statement. Optionally for one traffic area. Companies and organisations are named; sole traders and partnerships are counted only. Quote the official heading; do not restate a surrender or termination as a revocation.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer
month	string	Publication month, YYYY-MM (default: the latest month)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "maximum": 1000,
      "minimum": 1
    },
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Publication month, YYYY-MM (default: the latest month)"
    }
  }
}

new_licences

New goods vehicle and PSV operator licences granted in one publication month, from the Traffic Commissioners' weekly Applications and Decisions and Notices and Proceedings: company, licence number, licence class, traffic area, bulletin and GOV.UK link. Optionally for one traffic area. Companies and organisations are named; sole traders and partnerships are counted only.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer
month	string	Publication month, YYYY-MM (default: the latest month)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "maximum": 1000,
      "minimum": 1
    },
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Publication month, YYYY-MM (default: the latest month)"
    }
  }
}

recent_changes

What changed between one DVSA operator licence file and the one before: licences new to the file, no longer in the file, back in the file, status changes, licence type, vehicle and trailer authorisation, operating centre and continuation date changes. Companies are listed with before/after values; sole trader and partnership changes are counted only. Defaults to the latest file; pass `release` (YYYY-MM-DD) for an earlier one (data_status lists them).

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer
offset	integer
release	string	DVSA file date, YYYY-MM-DD (default: latest)
change_type	string	Only this kind of change

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 100000,
      "minimum": 0
    },
    "release": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "DVSA file date, YYYY-MM-DD (default: latest)"
    },
    "change_type": {
      "enum": [
        "first_seen",
        "not_in_release",
        "reappeared",
        "status_changed",
        "type_changed",
        "name_changed",
        "vehicles_changed",
        "trailers_changed",
        "oc_added",
        "oc_removed",
        "continuation_changed",
        "company_number_changed",
        "operator_type_changed"
      ],
      "type": "string",
      "description": "Only this kind of change"
    }
  }
}

search

Search HaulierScope for operators (company name, licence number or company number) and guides. Returns ids to pass to fetch. Prefer search_operators for structured operator results.

read-only

Argument	Type	Description
query*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  }
}

search_operators

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.

read-only

Argument	Type	Description
limit	integer	Maximum results (1–50)
query*	string	Company name, licence number (two letters + seven digits) or company number
filters	object

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results (1–50)"
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Company name, licence number (two letters + seven digits) or company number"
    },
    "filters": {
      "type": "object",
      "properties": {
        "area": {
          "type": "string",
          "maxLength": 60,
          "minLength": 1,
          "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
        },
        "status": {
          "enum": [
            "valid",
            "curtailed",
            "suspended",
            "unmapped"
          ],
          "type": "string"
        },
        "category": {
          "enum": [
            "goods",
            "psv"
          ],
          "type": "string",
          "description": "goods = HGV operators; psv = bus and coach operators"
        },
        "licence_type": {
          "enum": [
            "standard_international",
            "standard_national",
            "restricted",
            "special_restricted"
          ],
          "type": "string"
        },
        "in_current_file": {
          "type": "boolean",
          "description": "true = only licences in the latest DVSA file"
        }
      }
    }
  }
}

tc_decisions

Written regulatory decisions the Traffic Commissioners published on GOV.UK (revocations, suspensions, curtailments, refusals, warnings and more): company, licences, outcome, decision date, appeal status and the decision document, with counts by outcome and traffic area. Optionally for one traffic area and/or one outcome code (from by_outcome, e.g. 'revocation'). Companies are named; decisions about sole traders, partnerships or people are counted only.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name
limit	integer
outcome	string	Outcome code from by_outcome, e.g. revocation

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1
    },
    "outcome": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "maxLength": 60,
      "minLength": 2,
      "description": "Outcome code from by_outcome, e.g. revocation"
    }
  }
}

upcoming_public_inquiries

Traffic Commissioner public inquiries listed for companies (date, time, venue, legal grounds and the official notice), from the weekly Applications and Decisions and Notices and Proceedings, optionally for one traffic area. Inquiries for sole traders and partnerships are counted, not named. Being called to an inquiry is not a finding against the operator.

read-only

Argument	Type	Description
area	string	Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Traffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name"
    }
  }
}

HaulierScope

Try it

area_stats Read-only

HaulierScope

Try it

area_stats Read-only

Tools (15)