Sponsor Finder

Check whether a company holds a UK or Netherlands work-visa sponsorship licence. The register lists official registered legal entity names, not brand, product, or trading names. If the user provides a brand name, product name, or website, first determine the company's registered legal name (via web search, the company's own website, or the relevant companies register) and pass that. Tolerates minor typos but not brand-vs-legal-name mismatches. Returns licence routes, ratings, locations and register dates. If results are ambiguous or none are found, refine the legal name and try again. For exploring or filtering many companies, use search_sponsors instead.

{
  "type": "object",
  "properties": {
    "company_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "The company's registered legal entity name — not a brand, product, or trading name, and not a URL. If the user gave a brand name or website, resolve the official registered legal name first, then pass it here."
    },
    "country": {
      "default": "both",
      "description": "Which register to check: uk, nl, or both",
      "type": "string",
      "enum": [
        "uk",
        "nl",
        "both"
      ]
    }
  },
  "required": [
    "company_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Exploratory list search of the sponsor register with optional filters (city/route for UK, sponsor type for NL). Returns a compact list with a total count. For checking one specific company, prefer check_sponsor_license.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Substring to match in the company name",
      "type": "string",
      "maxLength": 100
    },
    "country": {
      "default": "uk",
      "description": "Which register to search",
      "type": "string",
      "enum": [
        "uk",
        "nl"
      ]
    },
    "city": {
      "description": "Filter by city (UK only)",
      "type": "string",
      "maxLength": 100
    },
    "route": {
      "description": "Filter by visa route, e.g. \"Skilled Worker\" (UK only)",
      "type": "string",
      "maxLength": 100
    },
    "sponsor_type": {
      "description": "Filter by sponsor type (NL only)",
      "type": "string",
      "enum": [
        "WORK",
        "EXCHANGE",
        "STUDY",
        "RESEARCH"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Max results (1–20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full record for one organization by id: routes, ratings, locations and register dates (UK), or sponsor type and KvK number (NL). Optionally include register change history.

{
  "type": "object",
  "properties": {
    "org_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Organization id (from a search or check result)"
    },
    "country": {
      "default": "uk",
      "description": "Which register the id belongs to",
      "type": "string",
      "enum": [
        "uk",
        "nl"
      ]
    },
    "include_history": {
      "default": false,
      "description": "Also include register change history (ADDED / REMOVED / REACTIVATED events)",
      "type": "boolean"
    }
  },
  "required": [
    "org_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register statistics, data freshness, and terminology for the UK and Netherlands sponsor registers. Use this to explain what a licence, route, rating, or sponsor type means.

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

Check a UK job offer against the Skilled Worker visa salary thresholds and occupation going rates. Takes a job title (or SOC 2020 code), the annual salary, and the contracted weekly hours — hours matter, because going rates pro-rate. Returns a three-state verdict: eligible, not_eligible, or uncertain with the reason. Covers the standard Skilled Worker route only (not Health & Care or Global Business Mobility).

{
  "type": "object",
  "properties": {
    "job_title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The job title, e.g. \"software developer\" or \"civil engineer\". A 4-digit SOC 2020 code also works."
    },
    "salary_gbp_per_year": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000,
      "description": "Gross annual salary of the offer, in pounds. Decimals allowed."
    },
    "weekly_hours": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Contracted weekly hours. Required: going rates are published for a 37.5-hour week and pro-rate with actual hours, so the same salary can pass at 37.5 hours and fail at 45."
    },
    "new_entrant": {
      "description": "Applicant is a new entrant at the start of their career.",
      "type": "boolean"
    },
    "phd_relevant": {
      "description": "Applicant holds a PhD in a subject relevant to the job.",
      "type": "boolean"
    },
    "phd_stem": {
      "description": "Applicant holds a PhD in a STEM subject relevant to the job.",
      "type": "boolean"
    },
    "on_immigration_salary_list": {
      "description": "The job is on the Immigration Salary List (asserted by the user — the list itself is not modelled).",
      "type": "boolean"
    }
  },
  "required": [
    "job_title",
    "salary_gbp_per_year",
    "weekly_hours"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}