# Is there an API for Find a Tender and Contracts Finder?

> Is there an API for UK public procurement data from Find a Tender and Contracts Finder?

Yes: [Find a Tender](https://www.find-tender.service.gov.uk/apidocumentation/1.0/GET-ocdsReleasePackages) serves its notices as Open Contracting Data Standard (OCDS) release packages, up to 100 per request with a cursor, and [Contracts Finder](https://www.contractsfinder.service.gov.uk/apidocumentation) has its own OCDS search; both are free to read, but they are two services with separate APIs, filtered by publication date and stage rather than by supplier or value. The Olympus UK Public Procurement API serves notices and contract awards from both in one schema: `GET /v1/uk-procurement/awards` searches awards by buyer, supplier name or Companies House number, CPV code, value and date.

## The official route, and what it lacks

- **Find a Tender.** The central digital platform for notices under the Procurement Act 2023, which took effect on 24 February 2025. Its OCDS API "retrieves Find a Tender notice data as an Open Contracting Data Standard (OCDS) release package", filtered by update date and stage (planning, tender, award), at most 100 releases a request, paged with a `cursor`. On a 429 or 503 it asks clients to wait for the `Retry-After` header. "Notice data is available under the Open Government Licence."
- **Contracts Finder.** Its API offers an OCDS notice search by publication date and stage. Since 24 February 2025 new procurements, above and below threshold, are advertised on Find a Tender; Contracts Finder is kept for award notices of procurements started under the earlier regulations and awards under their framework agreements (PPN 019).

What that leaves to you: two APIs to harvest, OCDS releases to merge into notices and awards, and your own index to answer questions like "every award to this company" or "IT contracts over £100,000 this year". Their OCDS endpoints filter by date and stage, not by supplier, Companies House number, CPV code or value.

## What the UK Public Procurement API serves

Notices and contract awards from Find a Tender and Contracts Finder in one schema: search by buyer, supplier, Companies House number, CPV code, value and date, with supplier and buyer summaries.

### Limits

- Values are as published: many awards carry no value, framework awards list many suppliers with one total, and some values are not in GBP.
- A procurement published on both services appears twice; nothing is deduplicated and names are not matched.
- Supplier summaries are by Companies House number only; suppliers without one are searchable by name prefix on /awards.
- A notice the service later removes stays until its day window is fetched again.

**Not included:** notices before 1 October 2025; tender documents or bids; lot detail and contract milestones beyond the notice; devolved portals (Public Contracts Scotland, Sell2Wales, eTendersNI).

## Example request and response

IT services awards (CPV 72) of £100,000 or more since April 2026:

Request:

```sh
curl -s "https://api.olympus.new-odyssey.com/v1/uk-procurement/awards?cpv=72&value_min=100000&date_from=2026-04-01&limit=1" \
  -H "X-API-Key: $OLYMPUS_API_KEY"
```

200 OK (abridged):

```json
{
  "data": [
    {
      "award_id": "…",
      "source": "fts",
      "ocid": "…",
      "notice_url": "…",
      "title": "…",
      "status": "…",
      "award_date": "…",
      "award_sort_date": "…",
      "value": { "amount": "…", "amount_gross": null, "currency": "GBP", "source": "award" },
      "buyer": { "buyer_id": "…", "name": "…", "company_number": null, "buyer_path": "…" },
      "cpv_codes": ["…"],
      "supplier_count": 1,
      "suppliers": [
        { "name": "…", "company_number": "…", "ppon": "…", "supplier_path": "…" }
      ],
      "provenance": { "source_id": "cabinet_office.find_a_tender_ocds", "source_url": "…" }
    }
  ],
  "meta": {
    "datasets": [{ "dataset_id": "…", "freshness": "fresh" }],
    "notices": [{ "code": "as_published", "message": "…" }],
    "pagination": { "limit": 1, "has_more": true, "next_cursor": "…" }
  }
}
```

`cpv=72` matches CPV codes starting 72 (IT services). `source` says which service published the award: `fts` (Find a Tender) or `cf` (Contracts Finder). `GET /v1/uk-procurement/suppliers/{company_number}` summarises one supplier's awards by Companies House number, and `GET /v1/uk-procurement/notices` searches tender and planning notices.

## Coverage and refresh

**Coverage:** UK public bodies' notices on Find a Tender (all Procurement Act 2023 notices since 24 February 2025, plus above-threshold notices under the earlier regulations) and Contracts Finder.

- Notices published or updated from 1 October 2025, by day window per source; GET /v1/uk-procurement/coverage lists the windows loaded, gaps and incomplete days.
- Each release is kept as the service published it, with its OCDS release id and the day window it came from.

**Refresh:** Daily (07:00 UK), re-fetching the last three days; supplier identifiers weekly and after every load. `GET /v1/uk-procurement/coverage` lists exactly what is loaded right now.

## Price

Every Olympus plan includes the UK Public Procurement API and every other live API. The Free plan (no card) gives 1,000 requests a month to each live API at 10 requests a minute. Paid plans: Developer $79 a month (50,000 requests per API), Growth $299 a month (250,000 requests per API), Business $999 a month (1,000,000 requests per API); Enterprise from $2,500 a month on request. Prices in USD; see [pricing](https://olympus.new-odyssey.com/pricing) for rate limits and what counts as a request.

## Docs

- [UK Public Procurement API](https://olympus.new-odyssey.com/apis/uk-procurement): what it serves and its endpoints
- [API reference](https://olympus.new-odyssey.com/docs/uk-procurement); OpenAPI contract at `/openapi/uk-procurement.yaml`
- [Coverage and known limits](https://olympus.new-odyssey.com/coverage#uk-procurement)
- [Contracts Finder vs Find a Tender](https://olympus.new-odyssey.com/answers/contracts-finder-vs-find-a-tender)
- [How to find out who won a public tender](https://olympus.new-odyssey.com/answers/who-won-a-public-tender-uk)
- [Get a free API key](https://olympus.new-odyssey.com/signup), then send it in the `X-API-Key` header
- From an AI agent: the [MCP server](https://olympus.new-odyssey.com/agents) describes this API's coverage with `get_product_coverage`; data calls go through the REST API

> Contains public sector information licensed under the Open Government Licence v3.0. Olympus is not affiliated with or endorsed by the Cabinet Office or the UK government.

## Questions

### Does Find a Tender have an API?

Yes. Find a Tender's OCDS API returns notice data as OCDS release packages, filtered by update date and stage, up to 100 per request with a cursor for the next page.

### Does Contracts Finder have an API?

Yes. Contracts Finder's API includes an OCDS notice search by publication date and stage. Since 24 February 2025 new procurements are published on Find a Tender instead.

### Can I search contract awards by supplier?

Not through the official OCDS endpoints, which filter by date and stage. The Olympus API searches awards by supplier name prefix or Companies House number, and `GET /v1/uk-procurement/suppliers/{company_number}` summarises a supplier's awards.

### Are Scottish, Welsh and Northern Irish portals included?

No. Public Contracts Scotland, Sell2Wales and eTendersNI are not included; notices those bodies publish on Find a Tender are.

## Sources

- Find a Tender (Cabinet Office): [GET ocdsReleasePackages: API documentation](https://www.find-tender.service.gov.uk/apidocumentation/1.0/GET-ocdsReleasePackages)
- Find a Tender (Cabinet Office): [Data and API documentation](https://www.find-tender.service.gov.uk/Developer/Documentation)
- Find a Tender (Cabinet Office): [Search notices](https://www.find-tender.service.gov.uk/Search)
- Contracts Finder (Cabinet Office): [API documentation](https://www.contractsfinder.service.gov.uk/apidocumentation)
- GOV.UK: [PPN 019: requirements to publish on Contracts Finder](https://www.gov.uk/government/publications/ppn-019-requirements-to-publish-on-contracts-finder/update-to-legal-requirements-to-publish-procurement-information-on-contracts-finder)

## Related

- [UK Public Procurement API](https://olympus.new-odyssey.com/apis/uk-procurement)
- [UK Public Procurement API reference](https://olympus.new-odyssey.com/docs/uk-procurement)
- [Contracts Finder vs Find a Tender](https://olympus.new-odyssey.com/answers/contracts-finder-vs-find-a-tender)
- [How to find out who won a public tender](https://olympus.new-odyssey.com/answers/who-won-a-public-tender-uk)

---
Published 2026-10-24, updated 2026-10-24 by New Odyssey. Canonical: https://olympus.new-odyssey.com/answers/find-a-tender-api
