# ukintel.uk UK Tender Fit-Score

> ukintel.uk UK Tender Fit-Score is a paid API for AI agents from api.ukintel.uk, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-13).

Scores a supplier's profile against live UK public procurement tenders, returning ranked matches with a 0-100 fit score and plain-English rationale

## Facts

- Endpoint: POST https://api.ukintel.uk/v1/tenders/fit-score
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ukintel-uk-uk-tender-fit-score-ebe0a6d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YPa7rUEC-kW6BmSGfMvSh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ukintel-uk-uk-tender-fit-score-ebe0a6d2 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ukintel-uk-uk-tender-fit-score-ebe0a6d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ukintel.uk](https://www.zero.xyz/host/api.ukintel.uk/llms.txt)