---
title: "Public-sector contracts a UK company has been awarded"
method: GET
path: "/api/v1/contracts-won"
---

# Public-sector contracts a UK company has been awarded

`GET /api/v1/contracts-won`

## Request

- Base URL: `https://meetkatalis.com`
- URL: `https://meetkatalis.com/api/v1/contracts-won`
- Auth: API key in header `x-api-key`

From Contracts Finder and Find a Tender award notices — count, notified value (contracts and framework ceilings apart; `contracts.withoutValue` counts awards with no published value), top buyers and the latest awards (the lots of one notice as one line with `lots`; a notice published on both feeds once, the other under `alsoNotified`). Matched by company number where a notice gives one (both feeds' numbers read since 10 Oct 2026), else by exact registered name. 1 credit.

## Query parameters

- `company` string, required
- `months` integer

## Response `200`

company, awards, contracts { count, notifiedValueGBP, withoutValue }, frameworks { count, ceilingValueGBP }, topBuyers[], reading, latest[] (lots?, alsoNotified?)

## Other responses

- `400`: Missing company
- `401`: Missing or wrong x-api-key
- `404`: No registered company found

---

[API](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis.md) · [All operations](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/revisions/214b13088f95?raw)