Verafy API

Build on Verafy

A REST API for UK company search, compliance scoring, and adverse media — wire due diligence directly into your own supplier onboarding, CRM, or underwriting workflow. Included with every subscription.

Getting started

  1. 1

    Generate an API key from Settings → API Keys. It's shown once — copy it somewhere safe.

  2. 2

    Send it as a bearer token on every request:Authorization: Bearer vfy_your_key_here

  3. 3

    Call an endpoint. For example, searching for active pubs in Manchester:

curl "https://api.verafy.uk/api/v1/public/companies/search?sic_code=56302&location=Manchester" \
  -H "Authorization: Bearer vfy_your_key_here"

Endpoints

GET/api/v1/public/companies/search

Search UK companies by name, SIC code, location, director, status, and type.

params: company_name, sic_code, location, officer_name, company_status, company_type, size, incorporated_from, incorporated_to

GET/api/v1/public/companies/{company_number}

Full Companies House profile for a single company.

GET/api/v1/public/companies/{company_number}/risk

Verafy Compliance Score (0–100), risk level, and the flags behind it.

GET/api/v1/public/companies/{company_number}/adverse-media

Adverse press, FCA warnings, and insolvency history for a company.

params: company_name (optional)

Rate limits

Search is limited to 30 requests/minute, company profile lookups to 60/minute, risk scoring to 30/minute, and adverse media to 20/minute — generous for real workflows, and in place to keep the underlying Companies House data source available for everyone. Need higher limits for a production integration? Contact us about Enterprise.