UK and Ireland tender data API

curl -H "Authorization: Bearer $TENDERSIGNAL_API_KEY" \
  "https://tendersignal.co.uk/api/v1/tenders?hard_to_find=true&limit=5"

const res = await fetch("https://tendersignal.co.uk/api/v1/tenders?hard_to_find=true&limit=5", {
  headers: { Authorization: `Bearer ${process.env.TENDERSIGNAL_API_KEY}` },
});
const { data, next_cursor } = await res.json();

import os, requests

r = requests.get(
    "https://tendersignal.co.uk/api/v1/tenders",
    params={"hard_to_find": "true", "limit": 5},
    headers={"Authorization": f"Bearer {os.environ['TENDERSIGNAL_API_KEY']}"},
)
data = r.json()["data"]

GET /usage

Your plan, allowance, usage, what your plan includes and the terms version you accepted. Free. contacts is all, national_portal_tenders or "none"; when it is "none", contacts_withheld_reason says billing_country_unknown or billing_country_not_eligible. (Every plan)

GET /tenders

Tenders in the UK and Ireland, live by default, oldest id first. (Every plan)

• status: live (default), closed or all.
• notice_type: tender, amendment or pin. PINs (early market notices) only appear when you ask for them.
• q: Words in the title or description. Separate phrases with commas to match any of them.
• sector: Comma list of sector slugs, for example construction,it-software. Every slug is listed under Sector slugs below.
• cpv: Comma list of CPV codes. 45000000 matches every code that starts 45.
• region: Comma list from: london, south-east, south-west, east-of-england, east-midlands, west-midlands, yorkshire, north-west, north-east, wales, scotland, northern-ireland, ireland. uk-wide is not accepted: leave region out for no region filter. ireland adds Irish tenders; use nation=ireland for Ireland only.
• buyer: A buyer slug from /buyers.
• buyer_name: Part of the buyer's name.
• buyer_type: Comma list: local-council, nhs, central-gov, housing-association, university, education, emergency-services, utility, public-body.
• value_min: Minimum value in the notice's own currency, for example 25000.
• value_max: Maximum value in the notice's own currency.
• limit: Records per page, 1 to 100. Default 20.
• cursor: next_cursor or resume_cursor from an earlier response.
• nation: Comma list: england, scotland, wales, northern-ireland, ireland.
• closing_after: Deadline on or after this date or time. A date alone means midnight UK time.
• closing_before: Deadline before this date or time.
• published_since: Published on or after this date or time.
• hard_to_find: hard_to_find=true returns only tenders not on the national portals; hard_to_find=false returns every other tender, including ones not yet checked.

GET /tenders/:id

One tender by id. A merged record answers 404 with canonical_id. (Every plan)

GET /awards

Award notices: who won, for how much and when. (Every plan)

• q: Words in the title or description. Separate phrases with commas to match any of them.
• sector: Comma list of sector slugs, for example construction,it-software. Every slug is listed under Sector slugs below.
• cpv: Comma list of CPV codes. 45000000 matches every code that starts 45.
• region: Comma list from: london, south-east, south-west, east-of-england, east-midlands, west-midlands, yorkshire, north-west, north-east, wales, scotland, northern-ireland, ireland. uk-wide is not accepted: leave region out for no region filter. ireland adds Irish tenders; use nation=ireland for Ireland only.
• buyer: A buyer slug from /buyers.
• buyer_name: Part of the buyer's name.
• buyer_type: Comma list: local-council, nhs, central-gov, housing-association, university, education, emergency-services, utility, public-body.
• value_min: Minimum value in the notice's own currency, for example 25000.
• value_max: Maximum value in the notice's own currency.
• limit: Records per page, 1 to 100. Default 20.
• cursor: next_cursor or resume_cursor from an earlier response.
• nation: Comma list: england, scotland, wales, northern-ireland, ireland.
• supplier: Part of a winning supplier's name.
• awarded_since: Awarded on or after this date.
• awarded_before: Awarded before this date.
• published_since: Published on or after this date or time.

GET /buyers

UK and Irish buyers, by slug. (API Starter and API Pro)

• q: Part of the buyer's name.
• buyer_type: Comma list of buyer type groups, as on /tenders.
• nation: Comma list: england, scotland, wales, northern-ireland, ireland.
• has_live: true for buyers with live tenders now.
• limit: Records per page, 1 to 100. Default 20.
• cursor: next_cursor or resume_cursor from an earlier response.

GET /buyers/:slug

One buyer by slug. (API Starter and API Pro)

GET /renewals

Contracts due back on the market, with the month we expect each to return. (API Pro)

• q: Words in the title.
• sector: Comma list of sector slugs, for example construction,it-software. Every slug is listed under Sector slugs below.
• cpv: Comma list of CPV codes. 45000000 matches every code that starts 45.
• region: Comma list from: london, south-east, south-west, east-of-england, east-midlands, west-midlands, yorkshire, north-west, north-east, wales, scotland, northern-ireland, ireland. uk-wide is not accepted: leave region out for no region filter. ireland adds Irish tenders; use nation=ireland for Ireland only.
• buyer: A buyer slug from /buyers.
• buyer_name: Part of the buyer's name.
• buyer_type: Comma list: local-council, nhs, central-gov, housing-association, university, education, emergency-services, utility, public-body.
• value_min: Minimum value in the notice's own currency, for example 25000.
• value_max: Maximum value in the notice's own currency.
• limit: Records per page, 1 to 100. Default 20.
• cursor: next_cursor or resume_cursor from an earlier response.
• incumbent: Part of the current supplier's name.
• retender_from: Expected back on the market in or after this month, YYYY-MM.
• retender_to: Expected back on the market in or before this month, YYYY-MM.