{
  "name": "Tender & Procurement Intelligence API",
  "version": "v1",
  "basePath": "/tenders",
  "free": true,
  "generatedAt": "2026-09-15T09:45:41.765Z",
  "static": {
    "base": "/tenders/api/v1",
    "note": "Public, free, not rate limited.",
    "endpoints": [
      {
        "method": "GET",
        "path": "/tenders/api/v1/index.json",
        "description": "This catalogue."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/meta.json",
        "description": "Dataset versions, coverage, licensing and the disclaimer."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/sources.json",
        "description": "What is ingested, from where, under what licence, and what is NOT covered."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/cpv.json",
        "description": "The full CPV tree."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/cpv-divisions.json",
        "description": "The 45 CPV divisions only."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/naics.json",
        "description": "The full NAICS 2022 tree."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/naics-sectors.json",
        "description": "The 20 NAICS sectors only."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/crosswalk.json",
        "description": "CPV to NAICS crosswalk — derived and unofficial, confidence-scored."
      },
      {
        "method": "GET",
        "path": "/tenders/api/v1/schemas/source.schema.json",
        "description": "JSON Schemas."
      }
    ]
  },
  "compute": {
    "note": "Free. Search and code expansion are anonymous. Saved searches, webhooks and organisation history need a free API key. Rate limited per client.",
    "endpoints": [
      {
        "method": "GET",
        "path": "/tenders/v1/notices",
        "description": "Search, deduplicated by default."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/notices/{noticeId}",
        "description": "One source notice with provenance."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/tenders/{tenderId}",
        "description": "A tender cluster: members, roles, link confidence."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/organisations",
        "description": "Search organisations."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/organisations/{orgId}",
        "description": "Identity, identifiers, name variants, merge candidates."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/organisations/{orgId}/history",
        "description": "Procurement history (key required)."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/codes/expand",
        "description": "Expand a CPV or NAICS code through the tree and the crosswalk."
      },
      {
        "method": "POST",
        "path": "/tenders/v1/saved-searches",
        "description": "Create a saved search (key required)."
      },
      {
        "method": "POST",
        "path": "/tenders/v1/subscriptions",
        "description": "Subscribe a webhook to a saved search (key required)."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/subscriptions/{id}/deliveries",
        "description": "Recent delivery attempts (key required)."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/ingest/runs",
        "description": "Per-source coverage and freshness."
      },
      {
        "method": "GET",
        "path": "/tenders/v1/usage",
        "description": "Your quota usage."
      }
    ]
  }
}