{"openapi":"3.1.0","info":{"title":"Procurement Intelligence API","version":"1.0.0","description":"Independent API for procurement intelligence: UK, EU, and US procurement opportunities, opportunity details, buyer history, awards, and company matching using UK Contracts Finder, UK Find a Tender, TED, and USAspending. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/procurement-intelligence/search":{"post":{"operationId":"search_procurement_opportunities","summary":"Search procurement opportunities","description":"Search UK procurement opportunities from Contracts Finder and Find a Tender with filtering by date, stage, keyword, CPV, location, and value.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publishedFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"publishedTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"stages":{"type":"array","items":{"type":"string"}},"keyword":{"type":"string","maxLength":200},"cpvCode":{"type":"string","maxLength":20},"location":{"type":"string","maxLength":100},"minValue":{"type":"number","minimum":0},"maxValue":{"type":"number","minimum":0},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","maxLength":200}},"required":["limit"],"additionalProperties":false},"example":{"publishedFrom":"2026-01-01","limit":10}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"query":{"type":"object","properties":{"publishedFrom":{"type":"string"},"publishedTo":{"type":"null"},"stages":{"type":"null"},"keyword":{"type":"null"},"cpvCode":{"type":"null"},"location":{"type":"null"},"minValue":{"type":"null"},"maxValue":{"type":"null"}},"additionalProperties":true},"results":{"type":"array","items":{"type":"object","properties":{"ocid":{"type":"string"},"noticeId":{"type":"string"},"buyerId":{"type":"string"},"buyerName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"publishedDate":{"type":"string"},"modifiedDate":{"type":"string"},"submissionDeadline":{"type":"string"},"value":{"type":"number"},"currency":{"type":"string"},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"procedure":{"type":"string"},"smeSuitable":{"type":"boolean"},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"sourceUrl":{"type":"null"},"awardedSupplier":{"type":"null"},"awardValue":{"type":"null"},"awardDate":{"type":"null"},"contractDetails":{"type":"null"}},"additionalProperties":true}},"resultCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","query":{"publishedFrom":"2026-01-01","publishedTo":null,"stages":null,"keyword":null,"cpvCode":null,"location":null,"minValue":null,"maxValue":null},"results":[{"ocid":"ocds-abc123-def456","noticeId":"notice-123","buyerId":"GB-ORG-123","buyerName":"Department for Digital, Culture, Media and Sport","title":"IT Services Contract","description":"Provision of IT support services.","stage":"tender","status":"active","publishedDate":"2026-01-15T00:00:00.000Z","modifiedDate":"2026-01-20T00:00:00.000Z","submissionDeadline":"2026-02-15T00:00:00.000Z","value":500000,"currency":"GBP","cpvCodes":["72000000"],"locations":["London"],"category":"IT services","procedure":"Open","smeSuitable":true,"documents":[{"type":"notice","url":"https://example.com/document.pdf"}],"sourceUrl":null,"awardedSupplier":null,"awardValue":null,"awardDate":null,"contractDetails":null}],"resultCount":1,"sources":[{"source":"UK Contracts Finder","status":"OK","url":"https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search","retrievedAt":"2026-10-29T12:00:00.000Z"},{"source":"UK Find a Tender","status":"OK","url":"https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["UK Contracts Finder and Find a Tender APIs filter by date, stage, and identifiers only.","Keyword, CPV, location, and value filtering is performed locally against returned records."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/opportunity":{"post":{"operationId":"get_opportunity_details","summary":"Get opportunity details","description":"Retrieve full details of a procurement opportunity by OCID from UK Contracts Finder or Find a Tender.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ocid":{"type":"string","minLength":1,"maxLength":100}},"required":["ocid"],"additionalProperties":false},"example":{"ocid":"ocds-abc123-def456"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"ocid":{"type":"string"},"found":{"type":"boolean"},"opportunity":{"type":"object","properties":{"ocid":{"type":"string"},"noticeId":{"type":"string"},"buyerId":{"type":"string"},"buyerName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"publishedDate":{"type":"string"},"modifiedDate":{"type":"string"},"submissionDeadline":{"type":"string"},"value":{"type":"number"},"currency":{"type":"string"},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"procedure":{"type":"string"},"smeSuitable":{"type":"boolean"},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"sourceUrl":{"type":"null"},"awardedSupplier":{"type":"null"},"awardValue":{"type":"null"},"awardDate":{"type":"null"},"contractDetails":{"type":"null"}},"additionalProperties":true},"source":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","ocid":"ocds-abc123-def456","found":true,"opportunity":{"ocid":"ocds-abc123-def456","noticeId":"notice-123","buyerId":"GB-ORG-123","buyerName":"Department for Digital, Culture, Media and Sport","title":"IT Services Contract","description":"Provision of IT support services.","stage":"tender","status":"active","publishedDate":"2026-01-15T00:00:00.000Z","modifiedDate":"2026-01-20T00:00:00.000Z","submissionDeadline":"2026-02-15T00:00:00.000Z","value":500000,"currency":"GBP","cpvCodes":["72000000"],"locations":["London"],"category":"IT services","procedure":"Open","smeSuitable":true,"documents":[{"type":"notice","url":"https://example.com/document.pdf"}],"sourceUrl":null,"awardedSupplier":null,"awardValue":null,"awardDate":null,"contractDetails":null},"source":"UK Contracts Finder","sources":[{"source":"UK Contracts Finder","status":"OK","url":"https://www.contractsfinder.service.gov.uk/Published/OCDS/Record/ocds-abc123-def456","retrievedAt":"2026-10-29T12:00:00.000Z"},{"source":"UK Find a Tender","status":"OK","url":"https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages/ocds-abc123-def456","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["Opportunity details are from the source that first returned data.","Some fields may be missing depending on what the buyer has published."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/buyer":{"post":{"operationId":"get_buyer_procurement_history","summary":"Get buyer procurement history","description":"Retrieve procurement history for a buyer from UK Contracts Finder and Find a Tender.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"buyerId":{"type":"string","minLength":1,"maxLength":100},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["buyerId","limit"],"additionalProperties":false},"example":{"buyerId":"GB-ORG-123","limit":10}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"buyerId":{"type":"string"},"opportunities":{"type":"array","items":{"type":"object","properties":{"ocid":{"type":"string"},"noticeId":{"type":"string"},"buyerId":{"type":"string"},"buyerName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"publishedDate":{"type":"string"},"modifiedDate":{"type":"string"},"submissionDeadline":{"type":"string"},"value":{"type":"number"},"currency":{"type":"string"},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"procedure":{"type":"string"},"smeSuitable":{"type":"boolean"},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"sourceUrl":{"type":"null"},"awardedSupplier":{"type":"null"},"awardValue":{"type":"null"},"awardDate":{"type":"null"},"contractDetails":{"type":"null"}},"additionalProperties":true}},"opportunityCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","buyerId":"GB-ORG-123","opportunities":[{"ocid":"ocds-abc123-def456","noticeId":"notice-123","buyerId":"GB-ORG-123","buyerName":"Department for Digital, Culture, Media and Sport","title":"IT Services Contract","description":"Provision of IT support services.","stage":"tender","status":"active","publishedDate":"2026-01-15T00:00:00.000Z","modifiedDate":"2026-01-20T00:00:00.000Z","submissionDeadline":"2026-02-15T00:00:00.000Z","value":500000,"currency":"GBP","cpvCodes":["72000000"],"locations":["London"],"category":"IT services","procedure":"Open","smeSuitable":true,"documents":[{"type":"notice","url":"https://example.com/document.pdf"}],"sourceUrl":null,"awardedSupplier":null,"awardValue":null,"awardDate":null,"contractDetails":null}],"opportunityCount":1,"sources":[{"source":"UK Contracts Finder","status":"OK","url":"https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search","retrievedAt":"2026-10-29T12:00:00.000Z"},{"source":"UK Find a Tender","status":"OK","url":"https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["Buyer history is retrieved by filtering all recent records for the buyer ID.","History may not include all historical opportunities due to API limitations."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/awards":{"post":{"operationId":"get_awarded_contracts","summary":"Get awarded contracts","description":"Retrieve awarded contracts and suppliers from UK Contracts Finder and Find a Tender by OCID or buyer ID.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ocid":{"type":"string","minLength":1,"maxLength":100},"buyerId":{"type":"string","minLength":1,"maxLength":100},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["limit"],"additionalProperties":false},"example":{"buyerId":"GB-ORG-123","limit":10}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"ocid":{"type":"null"},"buyerId":{"type":"string"},"awards":{"type":"array","items":{"type":"object","properties":{"ocid":{"type":"string"},"noticeId":{"type":"string"},"buyerId":{"type":"string"},"buyerName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"publishedDate":{"type":"string"},"modifiedDate":{"type":"string"},"submissionDeadline":{"type":"null"},"value":{"type":"number"},"currency":{"type":"string"},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"procedure":{"type":"string"},"smeSuitable":{"type":"boolean"},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"sourceUrl":{"type":"null"},"awardedSupplier":{"type":"string"},"awardValue":{"type":"number"},"awardDate":{"type":"string"},"contractDetails":{"type":"object","properties":{"startDate":{"type":"string"},"endDate":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}},"awardCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","ocid":null,"buyerId":"GB-ORG-123","awards":[{"ocid":"ocds-xyz789-uvw012","noticeId":"award-456","buyerId":"GB-ORG-123","buyerName":"Department for Digital, Culture, Media and Sport","title":"IT Services Contract","description":"Provision of IT support services.","stage":"award","status":"complete","publishedDate":"2026-01-15T00:00:00.000Z","modifiedDate":"2026-03-01T00:00:00.000Z","submissionDeadline":null,"value":500000,"currency":"GBP","cpvCodes":["72000000"],"locations":["London"],"category":"IT services","procedure":"Open","smeSuitable":true,"documents":[{"type":"award","url":"https://example.com/award.pdf"}],"sourceUrl":null,"awardedSupplier":"Example IT Solutions Ltd","awardValue":480000,"awardDate":"2026-03-01T00:00:00.000Z","contractDetails":{"startDate":"2026-04-01","endDate":"2027-03-31"}}],"awardCount":1,"sources":[{"source":"UK Contracts Finder","status":"OK","url":"https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search","retrievedAt":"2026-10-29T12:00:00.000Z"},{"source":"UK Find a Tender","status":"OK","url":"https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["Awards are retrieved by filtering for award-stage notices.","Not all awarded contracts may be available through these public APIs."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/match":{"post":{"operationId":"match_company_to_opportunities","summary":"Match company to opportunities","description":"Match a company profile against available procurement opportunities from UK Contracts Finder and Find a Tender with transparent scoring.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companyProfile":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"industries":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"minValue":{"type":"number","minimum":0},"maxValue":{"type":"number","minimum":0},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["name"],"additionalProperties":false},"publishedFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"publishedTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["companyProfile","limit"],"additionalProperties":false},"example":{"companyProfile":{"name":"Example Ltd","industries":["IT Services"],"keywords":["software"]},"limit":10}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"companyProfile":{"type":"object","properties":{"name":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"minValue":{"type":"number"},"maxValue":{"type":"number"}},"additionalProperties":true},"matches":{"type":"array","items":{"type":"object","properties":{"ocid":{"type":"string"},"noticeId":{"type":"string"},"buyerId":{"type":"string"},"buyerName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"publishedDate":{"type":"string"},"modifiedDate":{"type":"string"},"submissionDeadline":{"type":"string"},"value":{"type":"number"},"currency":{"type":"string"},"cpvCodes":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"procedure":{"type":"string"},"smeSuitable":{"type":"boolean"},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"sourceUrl":{"type":"null"},"awardedSupplier":{"type":"null"},"awardValue":{"type":"null"},"awardDate":{"type":"null"},"contractDetails":{"type":"null"},"matchExplanation":{"type":"array","items":{"type":"string"}},"matchScore":{"type":"number"}},"additionalProperties":true}},"matchCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","companyProfile":{"name":"Example Ltd","industries":["IT Services"],"keywords":["software"],"locations":["London"],"minValue":100000,"maxValue":1000000},"matches":[{"ocid":"ocds-abc123-def456","noticeId":"notice-123","buyerId":"GB-ORG-123","buyerName":"Department for Digital, Culture, Media and Sport","title":"IT Services Contract","description":"Provision of IT support services.","stage":"tender","status":"active","publishedDate":"2026-01-15T00:00:00.000Z","modifiedDate":"2026-01-20T00:00:00.000Z","submissionDeadline":"2026-02-15T00:00:00.000Z","value":500000,"currency":"GBP","cpvCodes":["72000000"],"locations":["London"],"category":"IT services","procedure":"Open","smeSuitable":true,"documents":[{"type":"notice","url":"https://example.com/document.pdf"}],"sourceUrl":null,"awardedSupplier":null,"awardValue":null,"awardDate":null,"contractDetails":null,"matchExplanation":["Industry match found in opportunity title, description, or category.","Keywords match found in opportunity title or description.","Location match found.","Value meets minimum threshold.","Value within maximum threshold."],"matchScore":75}],"matchCount":1,"sources":[{"source":"UK Contracts Finder","status":"OK","url":"https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search","retrievedAt":"2026-10-29T12:00:00.000Z"},{"source":"UK Find a Tender","status":"OK","url":"https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["Matching is based on published opportunity data and may not reflect all eligibility requirements.","Match scores are heuristic indicators and do not guarantee a chance of winning."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/eu/notices/search":{"post":{"operationId":"search_eu_notices","summary":"Search EU notices","description":"Search published EU procurement notices from TED with filtering by keyword, CPV code, NUTS code, and date range.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keyword":{"type":"string"},"cpvCode":{"type":"string"},"nutsCode":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["limit"],"additionalProperties":false},"example":{"keyword":"software","limit":20}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"keyword":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"notices":{"type":"array","items":{}},"total":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"keyword":"software","limit":20},"notices":[],"total":0,"sources":[{"source":"TED API","url":"https://api.ted.europa.eu/v3/notices/search","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["TED API provides EU procurement notices.","CPV and NUTS codes are hierarchical; consult official documentation."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/eu/notices/resolve":{"post":{"operationId":"resolve_eu_notice","summary":"Resolve EU notice","description":"Retrieve full details of an EU procurement notice from TED by notice ID.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"noticeId":{"type":"string"}},"required":["noticeId"],"additionalProperties":false},"example":{"noticeId":"123456-2024"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"noticeId":{"type":"string"}},"additionalProperties":true},"notice":{"type":"null"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"noticeId":"123456-2024"},"notice":null,"sources":[{"source":"TED API","url":"https://api.ted.europa.eu/v3/notices/123456-2024","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["TED API provides full notice details in XML/JSON format.","Award details may not be available for all notice types."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/us/awards/search":{"post":{"operationId":"search_us_awards","summary":"Search US awards","description":"Search federal contract awards from USAspending with filtering by keyword, recipient, agency, and fiscal year.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keyword":{"type":"string"},"recipientId":{"type":"string"},"agencyId":{"type":"string"},"fiscalYear":{"type":"integer","minimum":2000,"maximum":2099},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["limit"],"additionalProperties":false},"example":{"keyword":"software","fiscalYear":2024,"limit":20}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"keyword":{"type":"string"},"fiscalYear":{"type":"number"},"limit":{"type":"number"}},"additionalProperties":true},"awards":{"type":"array","items":{}},"total":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"keyword":"software","fiscalYear":2024,"limit":20},"awards":[],"total":0,"sources":[{"source":"USAspending API","url":"https://api.usaspending.gov/api/v2/search/spending_by_award/","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["USAspending API provides federal contract awards.","Data is limited to federal spending; state and local spending not included."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/us/recipients/profile":{"post":{"operationId":"get_us_recipient_profile","summary":"Get US recipient profile","description":"Retrieve recipient details from USAspending by recipient ID.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"recipientId":{"type":"string"}},"required":["recipientId"],"additionalProperties":false},"example":{"recipientId":"123456"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"recipientId":{"type":"string"}},"additionalProperties":true},"profile":{"type":"null"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"recipientId":"123456"},"profile":null,"sources":[{"source":"USAspending API","url":"https://api.usaspending.gov/api/v2/recipient/123456","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["USAspending API provides recipient details for federal awards.","Business names may vary across awards."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/us/recipients/awards":{"post":{"operationId":"get_us_recipient_awards","summary":"Get US recipient awards","description":"Retrieve award history for a US recipient from USAspending by recipient ID.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"recipientId":{"type":"string"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["recipientId","limit"],"additionalProperties":false},"example":{"recipientId":"123456","limit":20}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"recipientId":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"awards":{"type":"array","items":{}},"total":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"recipientId":"123456","limit":20},"awards":[],"total":0,"sources":[{"source":"USAspending API","url":"https://api.usaspending.gov/api/v2/recipient/123456/awards","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["USAspending API provides award history for recipients.","Data is limited to federal awards."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/procurement-intelligence/us/agency-spend":{"post":{"operationId":"get_us_agency_spend","summary":"Get US agency spend","description":"Retrieve award spending data for a US federal agency from USAspending by agency ID.","tags":["procurement-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"agencyId":{"type":"string"},"fiscalYear":{"type":"integer","minimum":2000,"maximum":2099}},"required":["agencyId"],"additionalProperties":false},"example":{"agencyId":"0970","fiscalYear":2024}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"input":{"type":"object","properties":{"agencyId":{"type":"string"},"fiscalYear":{"type":"number"}},"additionalProperties":true},"agencySpend":{"type":"null"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"retrievedAt":"2026-10-29T12:00:00.000Z","input":{"agencyId":"0970","fiscalYear":2024},"agencySpend":null,"sources":[{"source":"USAspending API","url":"https://api.usaspending.gov/api/v2/agency/0970/awards/","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["USAspending API provides agency award spending data.","Data is limited to federal agencies."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}