{"uid":"cap_YPa7rUEC-kW6BmSGfMvSh","slug":"ukintel-uk-uk-tender-fit-score-ebe0a6d2","name":"ukintel.uk UK Tender Fit-Score","description":"Send a supplier profile (what you do, keywords, regions, value band, certifications) and get the best-fitting live UK tenders, each scored 0-100 by deterministic published rules across five factors - relevance, value fit, geography, timeline, buyer history - each with its numerator AND denominator so you can re-weight client-side, plus a what-to-emphasise note on the top matches. Rules score; a model never does.","url":"https://api.ukintel.uk/v1/tenders/fit-score","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"top":{"type":"integer","default":5,"maximum":10,"minimum":1},"filters":{"type":"object","description":"Optional pre-filters (same fields as /v1/tenders/search)."},"supplier":{"type":"object","required":["what_we_do"],"properties":{"cpv":{"type":"array","items":{"type":"string"},"description":"CPV code prefixes you deliver against"},"regions":{"type":"array","items":{"type":"string"},"description":"UK nations/regions served"},"keywords":{"type":"array","items":{"type":"string"}},"value_band":{"type":"array","items":{"type":"integer"},"maxItems":2,"minItems":2,"description":"[min, max] comfortable contract value in GBP"},"what_we_do":{"type":"string","description":"Plain-English capability statement"},"certifications":{"type":"array","items":{"type":"string"}}},"description":"The supplier profile to match against live tenders."}}},"responseSchema":{"type":"json","example":{"query":{"supplier":{"what_we_do":"industrial tank and vessel cleaning…"}},"notice":"Information, not advice.","result":{"matches":[{"fit":{"band":"strong","score":76,"factors":{"of":40,"of_b":15,"of_g":15,"of_t":10,"of_v":20,"timeline":10,"geography":8,"relevance":30,"value_fit":20,"buyer_history":8}},"ocid":"ocds-b5fd17-9c92b21e-…","title":"Internal Chemical Cleaning of Glycol Expansion Drums","emphasise":"Confined-space certification and tank-cleaning experience directly answer the stated drum-cleaning requirement."}],"considered":4211},"confidence":"high"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fQNDPWsYEINrYaRHc8lCv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores a supplier's profile against live UK public procurement tenders, returning ranked matches with a 0-100 fit score and plain-English rationale","exampleAgentPrompt":"Score my company against live UK public tenders — we specialise in confined-space industrial tank and vessel cleaning, chemical cleaning, and pressure washing for petrochemical clients. Give me the strongest matches with fit scores and explain why each tender fits us.","exampleUseCases":[{"title":"SME finding first government contract","prompt":"We're a small scaffolding and access services company based in the Midlands — can you run our supplier profile against live UK government tenders and show me the top matches with fit scores so we know which ones are worth bidding on?"},{"title":"Procurement consultant shortlisting bids","prompt":"My client provides specialist HVAC maintenance and air-handling services. Run their profile against everything currently open on Find a Tender and Contracts Finder, and give me a ranked shortlist of opportunities with scores and the key factors driving each match."},{"title":"Agency checking tender pipeline for a new supplier","prompt":"We've just onboarded a new supplier that does ground investigation and geotechnical drilling. Can you score them against live UK public procurement opportunities and tell me which tenders are a strong fit and why, including how many total tenders were considered?"}],"resultDescription":"A JSON object containing: an array of tender matches each with a 0-100 numeric fit score, a qualitative band (e.g. 'strong'), granular scoring sub-factors (relevance, value fit, geography, timeline, buyer history, etc.), the tender's OCID reference, title, and a plain-English 'emphasise' tip explaining what to highlight in the bid. Also includes the total count of tenders considered and an overall confidence rating.","failureModes":["Vague or very short supplier description produces low-confidence or zero matches","No live tenders currently match the niche — returns empty matches array","Malformed request body returns a 400-level error","Upstream Find a Tender / Contracts Finder data temporarily unavailable causing degraded results","Supplier operating outside UK geography may score poorly on geography sub-factor"],"whenToPreferThis":"Use this endpoint when you need to match a UK supplier profile against live public procurement opportunities and want a ranked, scored shortlist with human-readable rationale — especially useful for SMEs, procurement consultants, or AI agents managing bid pipelines. Prefer this over manual tender portal browsing when you need a programmatic fit score rather than raw search results. It covers both Find a Tender and Contracts Finder in one call, with no signup or API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:45.039Z","isFirstParty":false}