# Fevio developer documentation

> REST API and MCP server for company data. Base URL: https://www.fevio.co.uk/api/v1. Authentication: X-API-Key header. Every response carries cost, credits and data.

## Getting started
- [Fevio API documentation](https://docs.fevio.co.uk/): REST API and MCP server for UK company data from Companies House: profiles, filed accounts, Fevio scores, directors, owners and filings.
- [Quickstart](https://docs.fevio.co.uk/quickstart): Create a Fevio API key and make your first call in a few minutes.
- [Authentication](https://docs.fevio.co.uk/authentication): How to send your Fevio API key and keep it safe.
- [Credits and pricing](https://docs.fevio.co.uk/credits): What each Fevio API request costs and how free and bought credits work.
- [Errors](https://docs.fevio.co.uk/errors): The Fevio API status and error codes and what each one means.

## Companies
- [Search companies](https://docs.fevio.co.uk/reference/search): GET /api/v1/companies/search: Search UK companies by name or company number. The query matches the start of every word. Results are paginated and credits are spent only when there are results.
- [Company profile](https://docs.fevio.co.uk/reference/company): GET /api/v1/companies/{number}: The register profile of one company: status, type, registered office, SIC codes and the accounts and confirmation statement deadlines.
- [Batch profiles](https://docs.fevio.co.uk/reference/batch): POST /api/v1/companies/batch: Up to 100 company numbers in one call, each with the same profile as a single company. You pay only for the companies found.

## Financial and risk
- [Financials](https://docs.fevio.co.uk/reference/financials): GET /api/v1/companies/{number}/financials: Figures from the accounts filed at Companies House, one entry per accounting period: turnover, profit, assets, liabilities, cash and staff, with the Fevio score of each period.
- [Fevio score](https://docs.fevio.co.uk/reference/score): GET /api/v1/companies/{number}/score: The Fevio score of the latest accounts, from 0 to 10, with the grade, the risk band and the five pillars it is built from.

## People and filings
- [Officers](https://docs.fevio.co.uk/reference/officers): GET /api/v1/companies/{number}/officers: The active directors and secretaries of the company, with appointment dates.
- [Owners (PSC)](https://docs.fevio.co.uk/reference/owners): GET /api/v1/companies/{number}/owners: The persons with significant control of the company and the nature of their control.
- [Filing history](https://docs.fevio.co.uk/reference/filings): GET /api/v1/companies/{number}/filings: The 20 latest filings Fevio holds for the company, with the Companies House form type.

## Account
- [Credit balance](https://docs.fevio.co.uk/reference/credits): GET /api/v1/credits: Your current balance and active credit packages. It costs nothing.

## AI assistants
- [MCP server](https://docs.fevio.co.uk/mcp): Connect Claude, Cursor and other MCP clients to UK company data through the Fevio MCP server.
- [MCP tools](https://docs.fevio.co.uk/mcp/tools): The tools of the Fevio MCP server and the price of each.