Search past awards and re-tenders
search_contract_awardsRead-only
Use this to find who won public contracts in the UK, Canada, the United States, Germany, France and the rest of the EU, what a buyer paid last time, and which contracts end soon and may be re-tendered. Searches the user's own countries unless they name one. Answers give the total, pass nextCursor back as cursor for more, and summarise says who won most across every match. Not for tenders open now (use search_tenders) or a public body's total spending. Example: {"buyer":"Leeds City Council","query":"cleaning","summarise":"supplier"}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buyer | No | Public body that awarded the contract, e.g. "Leeds City Council". | |
| codes | No | Only contracts with one of these classification codes, or a code under one: CPV in the UK and EU, e.g. "90910000" for cleaning or "909" for all cleaning and sanitation; NAICS or PSC on SAM.gov; UNSPSC or GSIN on CanadaBuys. | |
| limit | No | How many to show, up to 50. Defaults to 10. | |
| query | No | What the contract covers, e.g. "IT support" or "school cleaning". | |
| cursor | No | The nextCursor from an earlier answer, with the same search, for its next page. | |
| detail | No | "short" for just each result's IDs, title, buyer, value, dates and link, e.g. to go through many pages; "full", the default, for everything. | |
| region | No | Where the work or delivery happens: a UK nation or English region, e.g. "North West" for Manchester or Liverpool; a Canadian province or territory, e.g. "Ontario" for Toronto; a US state, e.g. "Virginia"; a German Land by its German name, e.g. "Bayern" for Munich; a French region, e.g. "Île-de-France" for Paris; or another EU member state, e.g. "Poland". Omit for nationwide contracts or when the user names no place. | |
| country | No | The country to look in, when the user names one, e.g. "Canada", "UK" or "Spain" (an EU member state searches the rest of the EU there). Omit to use the user's own countries (the UK when they aren't signed in). Tenda covers the UK, Canada, the United States, Germany, France and the rest of the EU. | |
| supplier | No | Company that holds or won the contract, e.g. a competitor's name. | |
| summarise | No | Adds overview, a summary of every matching award, not just this page: "buyer" for who wins a buyer's contracts, "supplier" for what a supplier wins and from which buyers. | |
| awarded_since | No | Only contracts awarded on or after this date, e.g. "2026-01-01". | |
| ending_within_months | No | Only contracts ending within this many months, e.g. 12 for "coming up for renewal next year". |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | How many awards match in all, across every page. | |
| credit | No | ||
| results | Yes | ||
| summary | Yes | ||
| overview | No | With summarise: a summary of every matching award, not just this page. | |
| countries | No | ||
| nextCursor | No | Pass it back as cursor, with the same search, for the next page. Absent on the last page. |