---
title: "Tenders matched and scored for your organisation"
method: GET
path: "/matches"
---

# Tenders matched and scored for your organisation

`GET /matches`

## Request

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

Open tenders from your daily digests, oldest first from `since` (default: 30 days ago). Strong and possible matches unless `band` narrows it. Every field is as the tender last appeared in a digest; `status` says whether your organisation is tracking it or has marked it as not for you.

## Query parameters

- `since` string
- `band` 'strong' | 'possible'
- `limit` integer
- `cursor` string
- `format` 'json' | 'csv'

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string: The OCDS id (ocid). Stable: use it as the external ID in your CRM.
    - `title` string
    - `buyer` string
    - `value_gbp` number, nullable
    - `closes` string, date, nullable
    - `published` string, date, nullable
    - `stage` string, nullable
    - `score` integer, nullable
    - `band` 'strong' | 'possible'
    - `why` string, nullable
    - `cpv_codes` string[]: CPV codes as published.
    - `portal` string, nullable
    - `notice_url` string
    - `first_sent` string, date-time
    - `last_sent` string, date-time
    - `status` 'new' | 'tracked' | 'not_for_us': What your organisation has said about this match in Tender Radar: nothing yet, tracking it, or not for us.
  - `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).
  - `since` string

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