---
title: "Contracts coming up for renewal"
method: GET
path: "/renewals"
---

# Contracts coming up for renewal

`GET /renewals`

## Request

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

scope=mine (default): the renewals chosen for your digests from your profile, oldest first from `since`. scope=all: every published contract ending in the next `months` months, soonest first, narrowed by q, buyer, cpv or min_value.

## Query parameters

- `scope` 'mine' | 'all'
- `since` string
- `months` integer
- `q` string
- `buyer` string
- `cpv` string
- `min_value` number
- `limit` integer
- `cursor` string
- `format` 'json' | 'csv'

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string: Stable external ID. scope=mine: the ocid. scope=all: ocid:award_id.
    - `ocid` string
    - `title` string
    - `buyer` string
    - `incumbent` string, nullable: The supplier holding it; null where several share the award.
    - `incumbent_count` integer, nullable
    - `value_gbp` number, nullable
    - `awarded` string, date, nullable
    - `ends` string, date, nullable
    - `latest_possible_end` string, date, nullable
    - `cpv_codes` string[]: CPV codes as published.
    - `notice_url` string
    - `first_sent` string, date-time: scope=mine only.
    - `last_sent` string, date-time: scope=mine only.
  - `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).
  - `scope` string
  - `total` integer: scope=all, first page only.

## 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)
