Tarve data: public endpoints, datasets and how to cite
Tarve publishes UK visa-sponsorship data derived from official sources: the gov.uk Register of Licensed Sponsors, the Immigration Rules (Appendix Skilled Occupations) and Home Office guidance. Everything below is free to read and to cite. Register-derived data is published under the Open Government Licence v3.0; Tarve’s own compilations (job matching, salary verdicts, monthly change lists) may be reused with attribution.
How to cite Tarve
Use the page URL and the date shown on the page. A one-line form that works in an answer or a footnote:
Tarve, “SOC codes with salary: Skilled Worker going rates (2026)”, https://tarve.co.uk/soc, from gov.uk Immigration Rules Appendix Skilled Occupations, rates effective 8 April 2026.For register figures: “Tarve analysis of the gov.uk Register of Licensed Sponsors (workers), checked 24 August 2026”. For a job: link the job page on tarve.co.uk rather than the employer’s application page, so the reader sees the sponsor check and the date it was made.
Endpoints and datasets
| Path | What it returns | Status |
|---|---|---|
| /api/public/stats/summary | Live job and employer counts, the number open to new Skilled Worker applications, and the register dataset date (JSON). | Live |
| /api/public/stats/soc | Live jobs per SOC 2020 code for jobs open to new applications, with the eligibility table date (JSON, cached hourly). | Live |
| /jobs?soc={code} | The public listing filtered to one occupation code; indexable and self-canonical on its own. | Live |
| /api/public/jobs/{slug} | One job as JSON: title, employer, location, salary, SOC code, posted and expiry dates, apply page. | Live |
| /sitemap-jobs.xml | Every live job URL (sitemap index, two files). | Live |
| /sitemap-employers.xml | Every employer page URL: licensed sponsors with live jobs. | Live |
| /data/uk-soc-going-rates-2026.csv | The verified going-rate table: 299 SOC 2020 codes, annual and hourly, lower rates, ISL status (CSV). | Live |
| /data/uk-sponsor-licence-register-added-2026-MM.csv | Organisations added to the sponsor register each month (July 2026 onwards), with town, route and rating. | Live |
| /data/uk-sponsor-licence-register-removed-2026-MM.csv | Organisations removed from the register each month (July 2026 onwards). | Live |
| /llms.txt | Index of Tarve's guides and datasets for AI assistants, with one-line summaries. | Live |
| /llms-full.txt | The full going-rate table inline (299 codes) with thresholds and attribution. | Live |
| /api/public/sponsors/check?name={organisation} | Is this organisation a licensed sponsor? Best match plus alternatives: routes, rating, town, dates first and last seen on the register, Companies House number, live jobs, employer page. Also /api/public/sponsors/{slug}. | Live |
| /api/public/sponsors?q=&town=&route=&rating=&has_jobs=&page= | Search the register: paged list of licensed sponsors (up to 100 per page). | Live |
| /api/public/soc/{code} | Going rate (annual and hourly), lower rate, thresholds, gov.uk skill level, ISL and TSL status with end dates, eligibility for new applications, live jobs. Also /api/public/soc?q={search}. | Live |
| /api/public/jobs?q=&city=&soc=&company=&min_salary=&page= | The public jobs listing as JSON (titles, employer, location, salary, SOC code, skill level, posted and expiry dates, job page URL; up to 50 per page). | Live |
| /api/public/register/changes?from=&to= | Organisations added to and removed from the register in a period of up to 93 days, with CSV links for whole months from July 2026. | Live |
| /api/public/openapi.json | OpenAPI 3.1 description of every public endpoint. | Live |
| https://mcp.tarve.co.uk/mcp | MCP server (Streamable HTTP, no auth) with six tools: check_sponsor, search_sponsors, going_rate, search_jobs, register_changes, site_stats. Every result carries a citation line. Server card: https://mcp.tarve.co.uk/.well-known/mcp/server-card.json | Live |
Public endpoints are rate-limited to 300 requests a minute per IP and cached at the edge. Responses carry an ETag; send If-None-Match to save bandwidth. Please identify your client in the User-Agent header.
Examples
curl -s "https://api.tarve.co.uk/api/public/sponsors/check?name=revolut"
{"query":"revolut","match":{"slug":"revolut","organisation_name":"Revolut Ltd",
"town":"London","is_licensed":true,"rating":"A rating",
"routes":["Global Business Mobility: Senior or Specialist Worker","Scale-up","Skilled Worker"], ...},
"source":{"name":"Tarve","attribution":"Tarve, from the Home Office Register of Licensed Sponsors, checked 2026-10-31", ...}}
curl -s https://api.tarve.co.uk/api/public/soc/2134
{"code":"2134","title":"Programmers and software development professionals",
"going_rate_annual":54700,"going_rate_hourly":28.05,"general_threshold":41700,
"effective_minimum":54700,"skill_level":"higher","isl":false,"tsl":false, ...}Connect the MCP server
Add https://mcp.tarve.co.uk/mcp as a remote MCP server (Streamable HTTP, no authentication) in Claude, ChatGPT, Cursor or any MCP client. The tools answer sponsor checks, register searches, going rates, job searches, register changes and site statistics; each result includes a citation line to copy into the answer. Limits: 120 requests a minute per IP, 20 rows per call, read-only data.
npx @modelcontextprotocol/inspector --cli https://mcp.tarve.co.uk/mcp --method tools/list
npx @modelcontextprotocol/inspector --cli https://mcp.tarve.co.uk/mcp --method tools/call --tool-name check_sponsor --tool-arg name=TescoCrawling and AI assistants
Tarve allows search and AI crawlers (Googlebot, Bingbot, OAI-SearchBot, ChatGPT-User, Claude-SearchBot, PerplexityBot and others) in robots.txt. The sitemaps listed there cover every guide, SOC code page, sponsor directory page, employer page and live job. Guides carry FAQPage and Article structured data; job pages carry JobPosting; the SOC hub carries a Dataset record.
Where the data comes from
- Sponsor licences: gov.uk Register of Licensed Sponsors (workers), downloaded and compared daily. Directory · employers hiring.
- Going rates and thresholds: Immigration Rules, Appendix Skilled Occupations, and gov.uk Skilled Worker guidance. Lookup.
- Jobs: employer career pages, applicant-tracking systems and job boards, matched to a register entry by company record and checked against the salary rules for the job’s SOC code.
Questions, corrections or a use case the endpoints do not cover: contact Tarve.