About this endpoint
What it does
Searches the UK Home Office register of licensed sponsors (the employers allowed to sponsor Worker and Temporary Worker visas) and returns up to maxItems matching sponsors. Filter by town, county, visa route, rating and words in the sponsor's name. Filters combine, so a sponsor has to match all of them.
Send at least one filter: a request with no filters returns only London Skilled Worker sponsors, not the whole register.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| towns | String Array | No | Towns or cities to keep, as written in the register; not case-sensitive (london matches LONDON). Empty keeps all towns. |
| counties | String Array | No | Counties to keep, as written in the register, e.g. Greater London, West Midlands. Many entries have no county, so this filter skips them; use towns for those. |
| routes | String Array | No | Visa routes to keep (contains match), e.g. Skilled Worker, Global Business Mobility, Scale-up, Creative Worker, Seasonal Worker. Empty keeps all routes. |
| ratings | String Array | No | Ratings to keep: A rating (fully meets sponsor duties), B rating (downgraded, on an action plan) or Provisional. Empty keeps all ratings. |
| companyNames | String Array | No | Words to look for in the sponsor's name (contains match), e.g. bank, NHS, software. Empty keeps all names. |
| maxItems | Integer | No | Maximum number of sponsors to return, 1–100. Default 20. |
Response
Returns how many sponsors came back and one record per sponsor, with the values exactly as the register publishes them.
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| count | Integer | Yes | Number of sponsors returned in items (at most maxItems). It is not the total number of matches in the register. |
| billed | Integer | Yes | Number of results the provider counted for this request; always equals count. |
| items | Object Array | Yes | One record per matching sponsor. Empty when nothing matches. |
| items[].organisationName | String | Yes | Sponsor's name exactly as published in the register. |
| items[].townCity | String | Yes | Town or city as published, including the register's own spelling and case (e.g. London, LONDON, Birmingham.). |
| items[].county | String | Yes | County as published; an empty string when the register leaves it blank, which is common. |
| items[].typeAndRating | String | Yes | Licence type and rating as one string, as published, e.g. Worker (A rating). |
| items[].licenceType | String | Yes | Licence type: Worker (long-term work routes such as Skilled Worker) or Temporary Worker (short-term routes such as Creative Worker). |
| items[].rating | String | Yes | Sponsor rating: A (fully meets sponsor duties) or B (downgraded by the Home Office and on an action plan). |
| items[].route | String | Yes | Visa route the licence covers, e.g. Skilled Worker, Creative Worker, Global Business Mobility: Senior or Specialist Worker. |
| items[].registerDate | String | Yes | Date (YYYY-MM-DD) of the GOV.UK register edition the record was read from, not the date the licence was granted. |
| items[].source | String | Yes | URL of the GOV.UK register CSV the record came from. Published under the Open Government Licence v3.0: wherever you display or pass on this data, include "Contains public sector information licensed under the Open Government Licence v3.0." |
| items[].companiesHouseSearchUrl | String | Yes | Companies House search for the sponsor's name. It is a name search, not a matched company record. |
| items[].scrapedAt | String | Yes | UTC time (ISO 8601) the provider read the record. |
The register is published by the Home Office under the Open Government Licence v3.0. Wherever you display or pass on this data, include: "Contains public sector information licensed under the Open Government Licence v3.0."
Errors
| Status | Code | When |
|---|---|---|
| 400 | invalid_input | maxItems is outside 1–100. |



