Contracts Finder

Returns an OCDS release package of award-stage notices: who won each contract, the awarded value and dates, the supplier organisation in parties, and the original tender details it was awarded against.

Returns the four UK home nations with their three-letter codes - the only country values the publishing API accepts.

Returns the immediate children of one CPV code, one level down the taxonomy.

Resolves a batch of CPV codes to their official descriptions in one call.

Returns the single ancestor CPV code the service records above the one supplied, with its own parentCode so you can keep walking up.

Returns CPV codes whose description CONTAINS the term as a substring, or whose code starts with it when the term is numeric, each with description, parentCode and hasChildren.

Returns the 15 top-level sector groupings Contracts Finder browses CPV by - Construction and Real Estate, Computer and Related Services, Transport and Related Services, Defence and security and so on - each a 2 or 3 digit id with a null parentCode and a hasChildren flag.

Returns Contracts Finder's own (non-OCDS) notice document: notice.contactDetails with the buyer's name, email, phone and address, the publisher's reference, status, deadline, region, sector and CPV list, plus the inlined cpvCodes, awards, additionalDetails, view count and any withdrawal reason - the contact and audit fields the OCDS projection drops.

Returns the additional-detail items a buyer attached to a notice: external links to their own tender portal, free-text blocks and file attachments with mime type and filename.

Returns the full list of CPV codes attached to one notice, each with its description, parent code and whether it has children.

Returns one row per published version of a notice: version number, the timestamp it changed, the notice status and type at that point, the account that changed it and any withdrawal reason.

Returns an OCDS release package of planning-stage notices - future opportunities and early market engagement - each carrying a planning.budget block and the documents inviting supplier discussion before any tender exists.

Returns the list of valid UK postcodes beginning with a given prefix, as a flat array of space-free strings.

Returns the OCDS record package for one contracting process: records[0] carries every release published under that ocid, one per notice version, plus the merged compiledRelease and a field-by-field versionedRelease history, so tender, award and amendments arrive in a single document.

Returns every region and country value Contracts Finder recognises as a delivery location, with its numeric id and exact accepted spelling.

Returns the OCDS release package for exactly one published notice version - the same object the search feed emits, fetched on its own.

Returns an OCDS release package of UK public-sector procurement notices published in a date window, mixing every procurement stage, with links.next carrying the cursor for the following page.

Returns an OCDS release package containing only tender-stage notices - live invitations to tender plus their amendments - with title, description, CPV classification, value, deadline and buyer for each.