WYOCS UK company intelligence

Official product identity

Official company data.
Ready for software and agents.

Search Companies House, verify a company and retrieve practical due-diligence signals through one focused REST API or MCP server.

Request API access View endpoints

Official public source Server-side credentials Pay per usable result

company-report.json

{
  "ok": true,
  "data": {
    "company_number": "12345678",
    "report": {
      "profile": {
        "company_status": "active"
      },
      "compliance": {
        "accounts_overdue": false,
        "insolvency_history": false
      }
    }
  },
  "meta": {
    "source": "Companies House",
    "billing": "x402"
  }
}

Payment settled · result released

One integration

From company search to operational confidence.

The API keeps Companies House authentication, rate limiting, caching and data normalization behind a stable interface.

Company search

Find UK companies by name with official number, status, type, incorporation date and registered-office summary.

Company profile

Retrieve official identity, status, jurisdiction, SIC codes, accounts and confirmation-statement deadlines.

Officers and PSC

Understand active officers and persons with significant control while minimizing unnecessary personal data.

Filing history

Review recent filing events with dates, categories and descriptions for onboarding or supplier workflows.

Risk signals

Surface overdue accounts, overdue statements, address disputes, registered charges and insolvency history.

Agent-ready MCP

Let approved AI clients discover and call paid tools using prepaid access or x402 payment authorization.

Choose the route

One verification service.
Three controlled ways to use it.

Start privately, issue prepaid access to customers, or enable machine-native settlement for compatible agents.

Internal

Private server-to-server

Use a revocable internal API key for WYOCS and IVO Courier workflows without per-call billing.

Controlled by the WYOCS admin

Prepaid

WYOCS Verify credits

Fund an API balance directly on wyocs.org through Stripe-hosted Checkout, then pay the configured price after each successful result.

Failed upstream calls are refunded

x402 v2

Per-request settlement

Compatible clients receive HTTP 402 requirements, authorize USDC on Base and retry the same API or MCP call.

Machine payments available

REST API v1

Clear endpoints and predictable prices.

Pricing is returned by the public pricing endpoint and can be changed from the WYOCS admin without a deployment.

GET /api/verify/v1/search?q=...$0.05

GET /api/verify/v1/company/{number}$0.15

GET /api/verify/v1/company/{number}/report$0.75

GET /api/verify/v1/company/{number}/officers$0.20

GET /api/verify/v1/company/{number}/psc$0.25

POST /api/verify/v1/topupPrepaid

REST company report

curl --fail-with-body \
  -H "Authorization: Bearer WYV_API_KEY" \
  "https://wyocs.org/api/verify/v1/company/12345678/report"

MCP initialize request

curl --fail-with-body -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer WYV_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0.0"}}}' \
  "https://wyocs.org/verify/mcp"

MCP endpoint

This endpoint uses JSON-RPC over HTTP POST. Initialization and tool discovery are free; protected tool calls use an API key or PAYMENT-SIGNATURE.

Public registry data, not a legal conclusion.

WYOCS Verify retrieves and structures information from the Companies House Public Data API. It does not replace legal, credit, AML, sanctions, identity or professional due diligence. Applications must decide how the data fits their own obligations.

Start with one workflow

Bring the onboarding step.
We will bring the verification layer.

Request a pilot key Explore WYOCS ecosystems

Official company data.Ready for software and agents.