Finding UK Government Contracts: A Developer's Guide to Procurement Data

£300 Billion in Annual Spending, Hidden in Plain Sight

The UK government is the largest buyer in the country. Central government, local authorities, NHS trusts, police forces, universities, and arms-length bodies collectively spend roughly £300 billion per year on goods, services, and works. Every significant contract must be publicly advertised. Every award must be published. The data is there — but it's split across two separate portals with different interfaces, different search capabilities, and different data formats.

Contracts Finder covers lower-value opportunities (above £12,000 for central government, £30,000 for the wider public sector). Find a Tender covers higher-value contracts above international thresholds — roughly £140,000 for goods and services, £5.4 million for works. Neither portal was designed for developers or for systematic monitoring. Both assume a human user who will search manually, set up basic email alerts, and check back periodically.

For developers building procurement intelligence tools, bid management platforms, or supply chain analysis systems, the lack of a unified API has been a persistent frustration. You either scrape two websites (fragile, rate-limited, and against terms of service) or pay for commercial procurement databases that charge thousands per year and still ultimately source their data from the same government portals.

What the Tenders Endpoint Returns

The Tenders endpoint at /api/v1/tenders unifies both Contracts Finder and Find a Tender into a single JSON response. It accepts optional sector and region query parameters, so you can filter to the opportunities that actually matter for your application.

The response includes open_tenders (currently accepting bids) with title, description, buyer organisation, value range, deadline, publication date, CPV codes, procedure type, and a URL to the original notice. It also returns awarded_contracts showing who won recent contracts, at what value, and from which buyer. Buyer profiles list actively procuring organisations with their tender counts. Statistics provide sector breakdowns, average contract values, and total open opportunity counts.

The endpoint costs 10 credits per call. For a bid management platform querying daily with different sector filters, that's a trivial operating cost compared to the value of the structured data. For an individual SME checking weekly for opportunities in their sector, it's even less.

The data structure is consistent regardless of whether the underlying source is Contracts Finder or Find a Tender. CPV codes are included for precise classification, value ranges are normalised, and dates use ISO format. This consistency makes the data immediately usable without the parsing and normalisation work that scraping two different government portals would require.

Building a Bid Pipeline Monitor

The simplest useful application of the API is a daily or weekly job that queries for new opportunities matching your criteria. Here's the flow:

1. Query /api/v1/tenders?sector=technology&region=London 2. Compare results against previously seen opportunity IDs 3. For new opportunities, extract title, buyer, value range, and deadline 4. Route to the appropriate team member via Slack, email, or your CRM

This turns procurement monitoring from a manual task (someone remembering to check two government websites) into an automated pipeline. The sector and region parameters do the heavy filtering, so you only see relevant opportunities rather than scrolling through thousands of construction contracts when you're an IT services company.

For more sophisticated implementations, you can enrich each opportunity with additional data. Query the Entity endpoint for the buyer organisation to assess their financial health and contract history. Check awarded_contracts for the same buyer to see what they've paid for similar work in the past. This context helps bid teams make go/no-go decisions based on data rather than gut feel.

The deadline field enables automated urgency management. Opportunities closing within 7 days can be flagged as urgent. Those with 4+ weeks remaining go into the pipeline for evaluation. This systematic approach prevents the scramble-to-bid pattern where teams discover opportunities days before the deadline.

Awarded Contracts: The Intelligence Most People Miss

Open tenders tell you what the government wants to buy. Awarded contracts tell you what they actually bought, from whom, and for how much. This backward-looking data is often more valuable than the forward-looking opportunities.

Award data reveals pricing benchmarks. If the Ministry of Justice awarded a £500,000 contract for translation services, you now know what that buyer pays for that service. This directly informs your pricing strategy for similar opportunities — bid too high and you lose on value for money, bid too low and you raise quality concerns.

Award patterns reveal buyer behaviour. A local authority that has awarded 5 IT contracts in 12 months is actively modernising its IT estate. Tracking their awards tells you what they're buying, at what price points, and which suppliers they trust. This intelligence helps you position for their next procurement before the tender is even published.

Competitor analysis becomes systematic. Over months of tracking awards in your sector, you build a picture of who wins what, at what price, and from which buyers. You learn which competitors are strongest in which regions, which price points they target, and where your differentiation might give you an edge.

The API returns awarded contracts alongside open tenders in every response. Building a database of awards over time creates a procurement intelligence asset that grows more valuable with each query.

Practical Integration Patterns

For developers building procurement tools, the API enables several useful patterns. A Slack bot that posts new opportunities matching team criteria each morning. A CRM integration that creates pipeline entries for each relevant tender. A dashboard showing open opportunities, upcoming deadlines, and recent awards in a unified view.

The simplest integration is a cron job:

curl -H "Authorization: Bearer ukd_live_YOUR_KEY" "https://www.ukdatapi.com/api/v1/tenders?sector=construction"

This returns all open construction tenders and recent construction contract awards. Parse the JSON response, filter for opportunities above your minimum contract value, and push to whatever notification or tracking system your team uses.

For marketplace platforms connecting suppliers with buyers, the API provides the underlying data for a matchmaking engine. Index opportunities by CPV code and region, match against supplier capabilities, and surface relevant opportunities to the right suppliers automatically.

For economic research and journalism, the aggregate statistics reveal spending patterns. Which sectors are seeing increased government investment? Which regions are getting the most contract awards? How has procurement spending shifted since policy changes? These questions are answerable by querying the API over time and tracking the statistical trends.