{"uid":"cap_UY-FZyhexIp-_1I3tCfLD","slug":"find-a-tender-notice-search-api-40624190","name":"Find a Tender Notice Search API","description":"UK tenders and public procurement search for apps, automations and AI agents. Search UK government contract notices from Find a Tender by keyword, CPV, delivery region, deadline and value. Returns up to 25 structured notices with buyers, deadlines, values and official source links where available. Bounded ingestion window, not all UK contracts; check free /status. Successful empty searches are chargeable.","url":"https://api.alexstokes.com/v1/tenders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","maxLength":200,"description":"Literal case-insensitive AND keyword terms across title, description, buyer and CPV descriptions."},"cpv":{"type":"string","pattern":"^\\d{2,8}$","description":"CPV code prefix."},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1},"offset":{"type":"integer","default":0,"maximum":1000,"minimum":0},"region":{"type":"string","maxLength":12,"description":"Published delivery region code prefix, e.g. UKG for West Midlands. Not buyer office location; national-only and missing locations may be omitted."},"status":{"enum":["open","closed","cancelled","planned","unknown","all"],"type":"string","default":"open","description":"Derived from the latest ingested notice. Open does not establish supplier eligibility."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Required with value filters; no currency conversion."},"snapshot":{"type":"string","maxLength":80,"description":"Copy meta.snapshot from page one when offset > 0; changed dataset returns 409."},"max_value":{"type":"number","minimum":0},"min_value":{"type":"number","minimum":0},"deadline_to":{"type":"string"},"deadline_from":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[],"meta":{"fresh":true,"limit":10,"total":0,"offset":0,"source":"Find a Tender","coverage":"Notices in the ingested update window only.","next_offset":null}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wHE68P8d8uwHWzjHHXklE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search UK Find a Tender Service (FTS) notices by keywords, CPV codes, delivery region, status, value range, and deadline — paginated, with snapshot-consistent pagination.","exampleAgentPrompt":"Search Find a Tender for up to 10 open IT services contracts in the West Midlands — filter to CPV code 72 and only show notices with a minimum value of £50,000 GBP.","exampleUseCases":[{"title":"Finding open construction tenders by region","prompt":"Can you search Find a Tender for open construction contracts in the Yorkshire region — use CPV code 45 and return up to 15 results?"},{"title":"Monitoring high-value healthcare procurement","prompt":"Look up any open UK public procurement notices for medical equipment worth at least £100,000 GBP — search for 'medical devices' and show me the first 10 results."},{"title":"Tracking upcoming planned IT tenders","prompt":"Search Find a Tender for planned IT consultancy tenders using the keyword 'digital transformation' — status planned, limit to 10 results, and show deadlines if available."}],"resultDescription":"A paginated list of tender notices matching the query, each including title, description, buyer, CPV descriptions, delivery region, contract value, status, and deadline. Also returns pagination metadata including a snapshot token (meta.snapshot) required to maintain consistent pagination across pages.","failureModes":["Empty result set still incurs a $0.01 charge — check /status before querying to assess ingestion window coverage","409 Conflict returned if the dataset changes between pages and snapshot token is stale or missing — re-fetch from page one","Invalid CPV code pattern (not 2–8 digits) causes a validation error","Invalid region code prefix returns no results without error","currency parameter required when using min_value or max_value filters; omitting it causes a validation error","offset exceeding 1000 is rejected","limit outside 1–25 range is rejected"],"whenToPreferThis":"Use this endpoint when you need to search live UK Find a Tender Service notices programmatically — especially when filtering by CPV code, delivery region, contract value, or status. Prefer it over scraping the FTS website directly. Always call the free /status endpoint first to confirm the ingestion window is fresh enough for your use case, since empty searches are still chargeable. Best suited for procurement intelligence workflows, supplier opportunity discovery, and contract monitoring agents operating in the UK public sector.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:30:46.721Z","isFirstParty":false,"canonicalSlug":"find-a-tender-notice-search-api-40624190"}