# UK Public Contracts Award Notices (Contracts Finder OCDS)

> UK Public Contracts Award Notices (Contracts Finder OCDS) is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns the latest UK public contract award notices from Contracts Finder, including buyer, supplier, contract title, award date, and GBP value.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/ukcontracts-tenders?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-public-contracts-award-notices-contracts-finder-ocds-cbf163ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0qG7tkjxhlgiMgCAwOrNz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-public-contracts-award-notices-contracts-finder-ocds-cbf163ec
```

Example prompt: Can you pull the latest UK government contract award notices from Contracts Finder — give me the 5 most recent ones including buyer, supplier, contract title, and the award value in GBP?

## When to prefer this

Use this endpoint when you need structured, ready-parsed UK public contract award data without scraping Contracts Finder directly. Ideal for monitoring which suppliers win government contracts, tracking procurement activity by buyer, or enriching supplier profiles with public contract history. Prefer this over raw OCDS search when you want a clean JSON response with the newest awards page in a single $0.002 call.

## Known failure modes

- Contracts Finder API unavailable — upstream timeout or 5xx error
- limit parameter out of range (must be 1–10) — may return error or default
- Stale data if Contracts Finder has not published new notices recently
- Empty awards array if no recent notices are available
- Network error from Cloudflare Worker — transient 502/503

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing an array of award notices, each with: noticeId, date, buyer organisation name, contract title, supplier name, awardDate, and awardValueGBP. Also includes the source URL and a checkedAt timestamp indicating when the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Notices to return, 1 to 10 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "awards": [
   {
    "date": "2026-10-23",
    "buyer": "HAMPSHIRE COUNTY COUNCIL",
    "title": "L3 Data Technician",
    "noticeId": "9e2db520-6889-4afe-82b5-58950f0d7b6b-918916",
    "supplier": "Leep Talent Limited",
    "awardDate": "2026-09-21",
    "awardValueGBP": 64819
   },
   {
    "date": "2026-10-23",
    "buyer": "British Business Bank",
    "title": "GB-Sheffield: External Audit of British Growth Partnership (BGP) Fund",
    "noticeId": "1cb23380-9b46-49c9-a99a-e4e3bbba0091-918918",
    "supplier": "Grant Thornton UK LLP",
    "awardDate": "2026-02-20",
    "awardValueGBP": 350200
   }
  ],
  "source": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
  "checkedAt": "2026-10-23T09:37:29.087Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-public-contracts-award-notices-contracts-finder-ocds-cbf163ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)