# Find a Tender API > Find a Tender provides UK public-sector tender notices and opportunity details as a workflow and API. Find a Tender searches open UK public-sector tender notices using required keywords and optional region, value, and closing-date filters. - Page: https://fous.com/workflows/find-a-tender - Handle: `@find-a-tender` - Category: [Government](https://fous.com/workflows/category/government) - Source website: https://find-tender.service.gov.uk - Last verified: Sep 29, 2026 - Fous is not affiliated with Find a Tender. ## Methods ### Search tenders Operation `search_tenders`, version 1. 1 credit per call. Find open UK public-sector tender notices matching keywords, optionally filtered by contract region, estimated value and closing date. Results are ordered by publication date, newest first. Estimated values use GBP excluding VAT when available, otherwise the listed GBP amount. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `region` | string | no | `"London"` | UK contract region in words, for example London or Scotland. Defaults to all regions. | | `keywords` | string | yes | `"IT support"` | Words to find in tender notices, for example social care. | | `max_results` | integer | no | `5` | Maximum tender notices to return, for example 25; maximum 100. | | `closing_after` | string | no | `"2026-10-01"` | Earliest closing date (inclusive), YYYY-MM-DD, for example 2026-10-01. Defaults to today in the UK. | | `max_value_gbp` | number | no | `2000000` | Maximum estimated contract value in GBP, for example 5000000. Leave blank for no maximum. | | `min_value_gbp` | number | no | `100000` | Minimum estimated contract value in GBP, for example 100000. Defaults to no minimum. | **Input schema** ```json { "type": "object", "required": [ "keywords" ], "properties": { "region": { "type": "string", "default": "all", "description": "UK contract region in words, for example London or Scotland. Defaults to all regions.", "examples": [ "London", "Wales" ] }, "keywords": { "type": "string", "minLength": 1, "description": "Words to find in tender notices, for example social care.", "examples": [ "IT support", "social care" ] }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum tender notices to return, for example 25; maximum 100.", "x-fous-developer": true, "examples": [ 5, 21, 1 ] }, "closing_after": { "type": "string", "format": "date", "description": "Earliest closing date (inclusive), YYYY-MM-DD, for example 2026-10-01. Defaults to today in the UK.", "examples": [ "2026-10-01" ] }, "max_value_gbp": { "type": "number", "minimum": 0, "description": "Maximum estimated contract value in GBP, for example 5000000. Leave blank for no maximum.", "examples": [ 2000000 ] }, "min_value_gbp": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum estimated contract value in GBP, for example 100000. Defaults to no minimum.", "examples": [ 100000 ] } }, "additionalProperties": false, "examples": [ { "region": "London", "keywords": "IT support", "max_results": 5, "min_value_gbp": 100000 }, { "keywords": "social care", "max_results": 21 }, { "region": "Wales", "keywords": "social care", "max_results": 1, "closing_after": "2026-10-01", "max_value_gbp": 2000000 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `tenders` | array | | | | `tenders[].title` | string | `"Cirrus Consortium Materials Supply Framework"` | | | `tenders[].cpv_codes` | array | | | | `tenders[].notice_id` | string | `"091589-2026"` | | | `tenders[].notice_link` | string | `"https://www.find-tender.service.gov.uk/Notice/091589-2026"` | | | `tenders[].procedure_type` | string or null | `"Open procedure"` | | | `tenders[].publication_date` | string | `"2026-09-28"` | | | `tenders[].closing_date_time` | string or null | `"2026-11-09T12:00:00+00:00"` | ISO 8601 time with offset; null when the notice has no published deadline. | | `tenders[].short_description` | string or null | `"The Cirrus Consortium is a procurement consortium with members including Registered Providers of Social Housing, Local ` | | | `tenders[].suitable_for_smes` | boolean or null | `true` | | | `tenders[].buyer_organisation` | string or null | `"Cirrus Consortium c/o Coastline Housing Limited"` | | | `tenders[].location_or_region` | string or null | `"UKC - North East (England); UKD - North West (England); UKE - Yorkshire and the Humber; UKF - East Midlands (England); ` | | | `tenders[].estimated_value_gbp` | number or null | `1200000000` | | | `tenders[].suitable_for_voluntary_and_community_organisations` | boolean or null | `true` | | **Example input** ```json { "region": "London", "keywords": "IT support", "max_results": 5, "min_value_gbp": 100000 } ``` **Example output** ```json { "tenders": [ { "title": "Cirrus Consortium Materials Supply Framework", "cpv_codes": [ "44100000" ], "notice_id": "091589-2026", "notice_link": "https://www.find-tender.service.gov.uk/Notice/091589-2026", "procedure_type": "Open procedure", "publication_date": "2026-09-28", "closing_date_time": "2026-11-09T12:00:00+00:00", "short_description": "The Cirrus Consortium is a procurement consortium with members including Registered Providers of Social Housing, Local Authorities, ALMOs and NHS Trusts. The Consortium is seeking bids for the followi…", "suitable_for_smes": null, "buyer_organisation": "Cirrus Consortium c/o Coastline Housing Limited", "location_or_region": "UKC - North East (England); UKD - North West (England); UKE - Yorkshire and the Humber; UKF - East Midlands (England); UKG - West Midlands (England); UKH - East of England; UKI - London; UKJ - South E…", "estimated_value_gbp": 1200000000, "suitable_for_voluntary_and_community_organisations": null } ] } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@find-a-tender", "visibility": "public", "operation": "search_tenders", "version": 1, "input": { "region": "London", "keywords": "IT support", "max_results": 5, "min_value_gbp": 100000 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@find-a-tender\",\n \"visibility\": \"public\",\n \"operation\": \"search_tenders\",\n \"version\": 1,\n \"input\": {\n \"region\": \"London\",\n \"keywords\": \"IT support\",\n \"max_results\": 5,\n \"min_value_gbp\": 100000\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@find-a-tender", "visibility": "public", "operation": "search_tenders", "version": 1, "input": { "region": "London", "keywords": "IT support", "max_results": 5, "min_value_gbp": 100000 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@find-a-tender","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## Use cases - Find open tenders matching your services - Identify opportunities in a specific region - Filter opportunities by estimated contract value - Track tender deadlines and publication dates - Review opportunities suitable for small businesses ## FAQ ### Is Fous affiliated with Find a Tender? No. Fous is not affiliated with Find a Tender. This workflow reads the public find-tender.service.gov.uk website and returns its data. ### How much does it cost? Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit. ### Do I need a Find a Tender account? No. You only need a Fous account. ### How current is the data? Fous gets the data from find-tender.service.gov.uk when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026. ### Which open tenders match my keywords? Search tenders returns matching open notices when you provide keywords. ### What tenders are available in a particular region? Search tenders can filter notices by a region such as London or Scotland. ### Which tenders close after a given date? Search tenders can filter notices by their earliest closing date. ## Related - [Tenders Electronic Daily API](https://fous.com/workflows/tenders-electronic-daily.md): Tenders Electronic Daily provides recently published EU procurement notices, open tenders with future deadlines, and newest-first contract awards; values and deadlines may be absent. - [SAM.gov API](https://fous.com/workflows/sam-gov.md): U.S. federal contract opportunities and government notices. - [Grants.gov API](https://fous.com/workflows/grants-gov.md): U.S. federal grant opportunities and application information. - [Find Case Law API](https://fous.com/workflows/find-case-law.md): Search official UK court judgments and tribunal decisions from The National Archives. - [Companies House API](https://fous.com/workflows/companies-house.md): Companies House returns UK public-register company details, officers, people with significant control and recent filings; records may be incomplete, and ceased entries are optional. - [GOV.UK API](https://fous.com/workflows/gov-uk.md): GOV.UK provides summarized current travel advice with linked details, published regional holidays (none for unpublished years), and possible matches on the current UK Sanctions List. - [NHS API](https://fous.com/workflows/nhs.md): NHS provides condition and medicine guidance, with condition dates reflecting the latest pages used, and nearby England service listings ordered by distance; availability details may be missing. - [USAspending API](https://fous.com/workflows/usaspending.md): USAspending provides official federal spending data and searchable awards from October 1, 2007 onward; figures and agency account reports may be revised or lag published award updates. - [All Government workflows](https://fous.com/workflows/category/government)