Catalog / Tenders & public contracts
TENDERS & PUBLIC CONTRACTS · UNITED KINGDOM
UK Tenders - Find a Tender & Contracts Finder
Scrape UK public procurement from Find a Tender (above threshold) and Contracts Finder (below threshold).
About this data
Scrape UK public procurement from Find a Tender (above threshold) and Contracts Finder (below threshold). One row per procurement joins tender, award and contract notices - buyer, CPV codes, procedure, deadline, value, lots, suppliers, documents and notice link. Daily changes feed, JSON/CSV/Excel.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/uk/procurement/tenders
UK public procurement from Find a Tender or Contracts Finder: buyer, CPV codes, procedure, status, deadline and value.
Input
Send a JSON body to POST https://api.ssh.autos/v1/uk/procurement/tenders.
| Field | Type | Required | Notes |
|---|---|---|---|
sources | array of strings | optional | each one of fts, cf; exactly 1 item; default ["fts"] |
keyword | string | optional | up to 200 characters |
maxItems | integer | optional | 1–5; default 3 |
Returned fields
The answer is JSON: records, a list of up to 5, and summary, the run status and counts. Each record has these 42 fields; a field the source does not publish comes back null.
42 fields per record
| Field | Type | Notes |
|---|---|---|
recordId | string | Stable record id: the source label and OCID, for example FTS:ocds-h6vhtk-0323a9. Use it to identify a procurement across runs. |
ocid | string | Open Contracting ID of the procurement, shared by its tender, award and contract notices on that source. |
source | string | FTS for Find a Tender (above threshold) or CF for Contracts Finder (below threshold). one of FTS, CF |
buyerName | string | Buyer (contracting authority) name as published, verbatim. |
buyerId | string | Buyer identifier as published, for example GB-FTS-9129. |
buyerIdentifierScheme | string | Scheme of the buyer identifier, for example GB-SRS or GB-COH, when published. |
buyerIdentifierId | string | Identifier of the buyer within its scheme, when published. |
cpvCodes | array of objects | CPV codes the procurement is classified under. |
procedure | string | Procurement procedure as published, for example 'Open procedure'. |
procedureCode | string | Procedure code as published, for example open or selective. |
status | string | Procurement status as published, for example active, complete, cancelled or unsuccessful. |
isOpen | boolean | Whether bids can still be submitted: the status is not a closed one and the submission deadline is still ahead at the run start. |
tenderPeriodStart | string | Start of the tender period, ISO 8601 with the source's zone, when published. |
tenderPeriodEnd | string | Submission deadline, ISO 8601 with the source's zone, when published. |
valueAmount | number | Procurement value as published, in valueCurrency. |
valueCurrency | string | Currency of valueAmount, for example GBP. |
lots | array of objects | Lots the procurement is divided into. |
awards | array of objects | Awards published for the procurement, newest version of each award. |
contracts | array of objects | Contracts published for the procurement, newest version of each contract. |
documents | array of objects | Documents published with the notices, one entry per document. |
releases | array of objects | Every release of this procurement that the source published, in date order. |
releaseIds | array of strings | Release ids in date order. |
releaseDates | array of strings | Release dates in date order, ISO 8601 with the source's zone. |
latestReleaseId | string | Id of the latest release. |
latestReleaseDate | string | Date of the latest release, ISO 8601 with the source's zone. |
latestReleaseTag | string | Primary tag of the latest release, for example tender, award or tenderAmendment. |
latestReleaseTags | array of strings | All tags of the latest release. |
releaseTags | array of strings | Every tag seen across the procurement's releases. |
amendments | array of objects | Amendments the source itself records on the tender. |
noticeUrl | string | URL of the official notice page for the latest release. |
joinedFrom | string | Where the row's notices came from: the source's full record for this procurement (Find a Tender with awards on), only the notices this run read (Contracts Finder, or Find a Tender with awards off), o… one of full record, scanned notices, earlier runs |
historyComplete | boolean | True when the row was joined from the source's full record. False means older notices of this procurement may be missing from the row. |
recordIssue | string | Why this Find a Tender row has no full record, for example the record was not found, its body was empty, or record reads stopped after repeated failures. Null when the full record was read, and on Co… |
fieldsNotInScan | array of strings | In Changes mode, tracked fields the notices read this run did not carry. They never count as a change; single values show the value delivered earlier, lists show what this run read. Null in Full mode. |
crossServiceCandidates | array of objects | Possible matches on the other UK service: same buyer, similar title and plausible dates. A hint only; the procurements are never merged. |
observedAt | string | When the run read this procurement, ISO 8601 in UTC. |
changeType | string | In Changes mode: new, amended or closed. Null in Full mode. one of new, amended, closed |
changedFields | array of strings | In Changes mode, the row fields that differ from the previous version. |
previous | object | In Changes mode, the earlier value of each changed single-value field. For a changed text or list field (description, CPV codes, lots, awards, contracts, documents, amendments) the earlier content is… |
firstSeenAt | string | In Changes mode, when this procurement was first delivered for this state. |
lastSeenAt | string | In Changes mode, when this procurement was last delivered for this state. |
contentHash | string | In Changes mode, a hash of the tracked row values used to detect amendments. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/uk/procurement/tenders -m POST -b '{"sources": ["fts"], "maxItems": 2}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: UK Tenders Scraper - Find a Tender & Contracts Finder. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt