# Tenders (United Kingdom) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and access UK government public procurement notices, tenders, and contract opportunities in real-time, with the ability to retrieve detailed notice information and browse standardized classification codes. Get comprehensive procurement data in structured formats to analyze tender patterns and find relevant contracting opportunities.

**Category:** Government & Public Data | **Website:** [tenders.gov.uk/](https://tenders.gov.uk/) | **Docs:** [parse.bot/marketplace/da56b01f-8a97-4fcd-8df8-e840eeb894e4/tenders-gov-uk-api](https://parse.bot/marketplace/da56b01f-8a97-4fcd-8df8-e840eeb894e4/tenders-gov-uk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_cpv_codes

Returns the list of top-level Common Procurement Vocabulary (CPV) codes used to classify procurement categories in UK government tenders. Each entry includes the CPV code number and its description. These codes appear in tender notices to categorize the goods, services, or works being procured.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/browse_cpv_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_notice_detail

Retrieve the full OCDS release package for a specific notice. Returns complete Open Contracting Data Standard (OCDS) data including parties, tender information, awards, contracts, and procurement metadata. The notice_id is available from search_notices results or get_ocds_release_packages releases. Not all notices have OCDS release packages; those that do not will return input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `notice_id` | string | Yes | Notice ID in the format NNNNNN-YYYY (e.g. '055564-2026'). Obtainable from search_notices results or get_ocds_release_packages releases. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/get_notice_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notice_id":"<string>"}'
```

### get_notice_ocds_record

Retrieve the full procurement record for a notice in OCDS record package format. Includes all related releases, a compiled release merging all releases into a single view, and a versioned release tracking field-level changes across the procurement lifecycle. Useful for seeing the complete history of a procurement from planning through award. Not all notices have OCDS record data; those that do not will return input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `notice_id` | string | Yes | Notice ID in the format NNNNNN-YYYY (e.g. '055564-2026'). Obtainable from search_notices results or get_ocds_release_packages releases. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/get_notice_ocds_record \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notice_id":"<string>"}'
```

### get_ocds_release_packages

Bulk extraction of notices in OCDS release package format via the native API. Supports cursor-based pagination and date-range filtering. The response includes a links.next URL containing the cursor for the next page. Each release contains full OCDS data including parties, tender, awards, and contracts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Cursor for pagination, obtained from links.next in the previous response. |
| `limit` | integer | No | Number of results per page (1-100). |
| `updated_from` | string | No | Filter by update date from (ISO format, e.g. '2026-06-01T00:00:00'). |
| `updated_to` | string | No | Filter by update date to (ISO format, e.g. '2026-06-10T23:59:59'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/get_ocds_release_packages \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","limit":"<integer>","updated_from":"<string>","updated_to":"<string>"}'
```

### search_notices

Full-text search over UK government tender notices on the Find a Tender service. Returns a paginated list of notice summaries with metadata including organisation, notice type, contract value, location, and publication date. Supports filtering by procurement stage (status), notice type, and contract value range. Each page returns up to ~20 results; use the page parameter to advance. The total_results count reflects the full matching set across all pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_value` | string | No | Maximum contract value filter. |
| `min_value` | string | No | Minimum contract value filter. |
| `notice_types` | string | No | Comma-separated notice type filter values. |
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | No | Search keywords to match against notice titles and descriptions. |
| `sort_by` | string | No | Sort order for results. |
| `statuses` | string | No | Comma-separated statuses to filter by. Accepted values: planning, tender, contract, pipeline, award, termination. If omitted, all statuses are included. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tenders-gov-uk-api-da56b01f/search_notices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_value":"<string>","min_value":"<string>","notice_types":"<string>","page":"<integer>","query":"<string>","sort_by":"<string>","statuses":"<string>"}'
```