# Rotuli

> Rotuli is the UK Entity Intelligence API: Companies House, Insolvency Service, and HM Land Registry data unified behind a single normalised JSON endpoint. Built for KYB workflows, due-diligence pipelines, and AI agents.

Rotuli aggregates official UK public registers into one consistent response. Every field is always present (null or empty rather than omitted), enum values are stable and only ever added to, and every response reports exactly which sources were consulted via `sources_checked` and `sources_failed`.

Primary customers are AI agents performing KYB and due-diligence checks on UK companies. The API is designed for reliable machine consumption: stable schemas, machine-readable risk-signal codes, and an MCP server for native agent integration.

## Docs

- [Documentation](https://rotuli.co.uk/docs): product documentation index
- [Quickstart](https://rotuli.co.uk/docs/quickstart): signup to first successful API call
- [API Reference](https://rotuli.co.uk/docs/api-reference): every endpoint, parameter, response schema, and curl example
- [MCP Server](https://rotuli.co.uk/docs/mcp): native integration for AI agents (Claude, custom connectors) with copy-paste config
- [Error Codes](https://rotuli.co.uk/docs/errors): machine-readable error codes and retry semantics
- [Risk Signals](https://rotuli.co.uk/docs/risk-signals): every risk flag code, severity, and scoring semantics
- [Rate Limits](https://rotuli.co.uk/docs/rate-limits): monthly quotas per tier
- [Data Sources](https://rotuli.co.uk/data-sources): source registers, licences, attribution, and update cadence
- [Pricing](https://rotuli.co.uk/pricing): Free, Growth, and Enterprise tiers

## Machine-readable

- [OpenAPI spec](https://rotuli.co.uk/openapi.json): OpenAPI 3 JSON, in sync with the deployed API
- [MCP endpoint](https://api.rotuli.co.uk/mcp): Model Context Protocol server (auth-gated; see the MCP docs page for agent configuration)

## Authentication

All API requests use a bearer API key:

```
Authorization: Bearer uk_live_***
```

Keys are prefixed `uk_live_` (production) or `uk_test_` (sandbox). Get a key by signing up at https://rotuli.co.uk/signup — the free tier includes 500 requests per month, no card required.

The MCP endpoint uses OAuth: agents authorize through the connector flow and grants are managed at https://rotuli.co.uk/dashboard/connections.

## Endpoints

- `GET /v1/entity/{company_number}` — full entity profile with risk signals
- `GET /v1/entity/{company_number}/risk` — risk signals only (score, flags, indeterminate)
- `GET /v1/search?q=...` — company search by name

Base URL: `https://api.rotuli.co.uk/v1`

## Pricing

- Free: £0 forever — 500 requests/month, entity profiles, basic search
- Growth: £29/month — 10,000 requests/month, entity profiles and risk signals, priority support
- Enterprise: £149/month — 50,000 requests/month, full API access, bulk operations, dedicated support

Details: https://rotuli.co.uk/pricing

## Data

All data comes from official UK public sources: Companies House (Open Government Licence v3.0), The Insolvency Service (OGL v3.0), and HM Land Registry CCOD (Crown copyright, licensed for value-added use). Source freshness, caching, and republication obligations: https://rotuli.co.uk/data-sources