---
title: "Search awarded contracts"
method: GET
path: "/contracts"
---

# Search awarded contracts

`GET /contracts`

## Request

- Base URL: `https://tender-radar.co.uk/api/v1`
- URL: `https://tender-radar.co.uk/api/v1/contracts`
- Auth: HTTP bearer

## Query parameters

- `q` string, required
- `buyer` string
- `supplier` string
- `awarded_after` string, date
- `min_value` number
- `limit` integer
- `cursor` string
- `format` 'json' | 'csv'

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string: ocid:award_id, stable.
    - `ocid` string
    - `title` string
    - `buyer` string
    - `supplier` string, nullable
    - `supplier_count` integer
    - `value_gbp` number, nullable
    - `awarded` string, date, nullable
    - `ends` string, date, nullable
    - `cpv_codes` string[]: CPV codes as published.
    - `notice_url` string
  - `has_more` boolean, required
  - `next_cursor` string, nullable: Pass as cursor to get the next page. null on the last page.
  - `counting_rule` string, required: How the records were counted. Quote it with any figure.
  - `source` string
  - `as_of` string, date-time, required: When the data was last copied from the live database (hourly).

## Other responses

- `400`: A parameter was wrong; the message says which.
- `401`: No key, or not a valid one.
- `402`: The organisation's trial has ended and it is not subscribed.
- `429`: Over 60 requests a minute, or 5,000 a day, for this key.

---

[API](https://skmtc.dev/the-professor-ai-cloud/apis/tender-radar-api.md) - [All operations](https://skmtc.dev/the-professor-ai-cloud/apis/tender-radar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-professor-ai-cloud/apis/tender-radar-api/revisions/608b892a86af?raw)
