{"openapi":"3.1.0","info":{"title":"BOAMP Opportunity Intelligence","version":"1.0.0","description":"Decision-intelligence API over official BOAMP data. Match companies to live French tenders, explain fit and disqualifiers, build actionable dossiers, monitor new opportunities, and produce deterministic BID / REVIEW / NO-BID recommendations without claiming win probability."},"servers":[{"url":"https://boamp-agent-x402.boamp-agent-x402-cloudflare.workers.dev"}],"tags":[{"name":"Free discovery","description":"No-payment discovery and sampling routes"},{"name":"Paid opportunity intelligence","description":"x402 v2 endpoints paid in USDC on Base Mainnet"},{"name":"Bid decisions","description":"Explainable deterministic bid/no-bid analysis using official BOAMP evidence"},{"name":"Operations","description":"Anonymous aggregate service usage"}],"externalDocs":{"description":"Machine-readable x402 service discovery","url":"https://boamp-agent-x402.boamp-agent-x402-cloudflare.workers.dev/.well-known/x402.json"},"paths":{"/health":{"get":{"operationId":"getServiceHealth","tags":["Free discovery"],"summary":"Check service health and production x402 mode","responses":{"200":{"description":"Healthy service"}}}},"/api/preview":{"get":{"operationId":"previewLiveFrenchTenders","tags":["Free discovery"],"summary":"Preview up to 3 live French BOAMP tenders for free","description":"Demonstrates current official BOAMP results. Premium scoring, match evidence, broader ranked sets, and action plans remain paid.","parameters":[{"name":"q","in":"query","required":true,"description":"Business activity, trade, capability, product, or tender keywords to match","schema":{"type":"string","minLength":2,"maxLength":200},"example":"plomberie"},{"name":"department","in":"query","required":false,"description":"Optional French department code for geographic filtering, for example 57, 67, 2A, or 971","schema":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"example":"57"},{"name":"geographic_area","in":"query","required":false,"schema":{"type":"string","maxLength":100},"example":"Grand Est"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000},"description":"Preference only; exact distance remains unknown without coordinates"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance,chauffage"},{"name":"capabilities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance préventive,astreinte"},{"name":"excluded_activities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"construction neuve"},{"name":"preferred_contract_characteristics","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"accord-cadre,procédure adaptée"},{"name":"source","in":"query","required":false,"description":"Official source selection; all deduplicates obvious cross-source duplicates","schema":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}}],"responses":{"200":{"description":"Limited live tender sample"},"400":{"description":"Missing q"}}}},"/api/company/resolve":{"get":{"operationId":"resolveFrenchCompanyForProcurement","tags":["Free discovery"],"summary":"Resolve a French company into a procurement-ready profile for free","description":"Accepts SIREN, SIRET, or company_name plus optional location. Returns public official identity fields, explicit unknowns, and deterministic broad procurement keyword/CPV inferences without persisting the profile.","parameters":[{"name":"siren","in":"query","schema":{"type":"string","pattern":"^[0-9]{9}$"}},{"name":"siret","in":"query","schema":{"type":"string","pattern":"^[0-9]{14}$"}},{"name":"company_name","in":"query","schema":{"type":"string","minLength":2,"maxLength":160}},{"name":"location","in":"query","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Resolved transient public company profile"},"400":{"description":"Missing or malformed identity"},"404":{"description":"Company not found"},"502":{"description":"Official company source unavailable"}}}},"/api/preflight":{"get":{"operationId":"preflightFrenchProcurementValue","tags":["Free discovery"],"summary":"Confirm matching opportunity value before payment","description":"Returns aggregate count, best fit, earliest deadline, coverage, newest timestamp, freshness and exact paid options. Does not reveal notice identity or detailed rationale. No relevant match means no payment request.","parameters":[{"name":"q","in":"query","required":false,"description":"Business activity, trade, capability, product, or tender keywords to match","schema":{"type":"string","minLength":2,"maxLength":200},"example":"plomberie"},{"name":"department","in":"query","required":false,"description":"Optional French department code for geographic filtering, for example 57, 67, 2A, or 971","schema":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"example":"57"},{"name":"geographic_area","in":"query","required":false,"schema":{"type":"string","maxLength":100},"example":"Grand Est"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000},"description":"Preference only; exact distance remains unknown without coordinates"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance,chauffage"},{"name":"capabilities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance préventive,astreinte"},{"name":"excluded_activities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"construction neuve"},{"name":"preferred_contract_characteristics","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"accord-cadre,procédure adaptée"},{"name":"source","in":"query","required":false,"description":"Official source selection; all deduplicates obvious cross-source duplicates","schema":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}},{"name":"siren","in":"query","schema":{"type":"string","pattern":"^[0-9]{9}$"}},{"name":"company_name","in":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Free aggregate value signal"},"400":{"description":"Missing company or activity"},"404":{"description":"Company not found"},"503":{"description":"Source unavailable or stale; no payment requested"}}}},"/api/premium/search":{"get":{"operationId":"findFrenchPublicTendersForCompany","tags":["Paid opportunity intelligence"],"summary":"Find French public tenders for my company","description":"Returns up to 30 active French public procurement opportunities with deterministic fit scores, match levels, exact reasons, possible disqualifiers, urgency, procedures, requirements detected, and official evidence. Searchable as BOAMP, French public procurement, France tenders, public tenders, marchés publics, procurement opportunities, business opportunity matching, and tender intelligence.","parameters":[{"name":"q","in":"query","required":true,"description":"Business activity, trade, capability, product, or tender keywords to match","schema":{"type":"string","minLength":2,"maxLength":200},"example":"plomberie"},{"name":"department","in":"query","required":false,"description":"Optional French department code for geographic filtering, for example 57, 67, 2A, or 971","schema":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"example":"57"},{"name":"geographic_area","in":"query","required":false,"schema":{"type":"string","maxLength":100},"example":"Grand Est"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000},"description":"Preference only; exact distance remains unknown without coordinates"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance,chauffage"},{"name":"capabilities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance préventive,astreinte"},{"name":"excluded_activities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"construction neuve"},{"name":"preferred_contract_characteristics","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"accord-cadre,procédure adaptée"},{"name":"source","in":"query","required":false,"description":"Official source selection; all deduplicates obvious cross-source duplicates","schema":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}}],"x-x402":{"version":2,"price":"$0.49","currency":"USDC","network":"eip155:8453","scheme":"exact"},"responses":{"200":{"description":"Ranked live tender matches","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"source":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"payment_mode":{"const":"x402"},"network":{"const":"eip155:8453"},"paid_feature":{"type":"boolean"},"company_profile":{"type":"object"},"scoring_method":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":30},"results":{"type":"array","maxItems":30,"items":{"type":"object","properties":{"id":{"type":"string","description":"Official BOAMP notice identifier"},"score":{"type":"integer","minimum":0,"maximum":100,"description":"Opportunity match score"},"fit_score":{"type":"integer","minimum":0,"maximum":100,"description":"Deterministic explainable company-to-opportunity fit score; never a win probability"},"match_level":{"type":"string","enum":["excellent","strong","review","weak"]},"title":{"type":"string"},"buyer":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"deadline":{"type":["string","null"],"format":"date-time"},"days_left":{"type":["integer","null"]},"departments":{"type":"array","items":{"type":"string"}},"location":{"type":"object"},"market_types":{"type":"array","items":{"type":"string"}},"descriptors":{"type":"array","items":{"type":"string"}},"cpv_codes":{"type":"array","items":{"type":"string"}},"procedure":{"type":["string","null"]},"requirements_detected":{"type":"array","items":{"type":"string"}},"possible_disqualifiers":{"type":"array","items":{"type":"string"}},"urgency":{"type":"string","enum":["expired","critical","high","normal","unknown"]},"recommended_next_action":{"type":"string"},"source_evidence":{"type":"object"},"url":{"type":"string","format":"uri","description":"Official notice URL"},"matched_keywords":{"type":"array","items":{"type":"string"}},"why_match":{"type":"array","items":{"type":"string"}},"reasons_for_match":{"type":"array","items":{"type":"string"}},"ranking_reasons":{"type":"array","items":{"type":"string"}}},"required":["id","score","fit_score","match_level","title","buyer","published_at","deadline","days_left","departments","location","market_types","descriptors","cpv_codes","procedure","requirements_detected","possible_disqualifiers","urgency","recommended_next_action","source_evidence","url","matched_keywords","why_match","reasons_for_match","ranking_reasons"]}}},"required":["service","source","generated_at","payment_mode","network","company_profile","count","results"]},"example":{"service":"BOAMP Opportunity Intelligence","source":"BOAMP / DILA Open Data","generated_at":"2026-08-28T12:00:00.000Z","payment_mode":"x402","network":"eip155:8453","company_profile":{"business_activity":"plomberie","keywords":[],"department":"57","capabilities":[],"excluded_activities":[],"preferred_contract_characteristics":[]},"count":2,"results":[{"id":"24-123456","score":83,"fit_score":83,"match_level":"excellent","title":"Travaux de plomberie et maintenance des installations","buyer":"Commune exemple","published_at":"2026-08-25T00:00:00Z","deadline":"2026-09-18T12:00:00Z","days_left":21,"departments":["57"],"location":{"departments":["57"],"requested_area":"57","radius_assessment":"not_requested"},"market_types":["TRAVAUX"],"descriptors":["Plomberie"],"cpv_codes":["45330000"],"procedure":"Procédure adaptée","requirements_detected":["Critères indiqués dans l'avis officiel"],"possible_disqualifiers":[],"urgency":"normal","recommended_next_action":"Open the official notice and validate eligibility in the DCE.","source_evidence":{"source":"BOAMP / DILA Open Data","notice_id":"24-123456","internal_id":null,"contract_folder_id":null,"source_schema":"eForms","official_url":"https://www.boamp.fr/","publication_timestamp":"2026-08-25T00:00:00Z","update_or_diffusion_timestamp":null},"url":"https://www.boamp.fr/","matched_keywords":["plomberie"],"why_match":["Mots-cles detectes : plomberie","Departement 57 correspondant"],"reasons_for_match":["Activité correspondante : plomberie","Département 57 correspondant"],"ranking_reasons":["Activité correspondante : plomberie","Département 57 correspondant"]}]}}}},"400":{"description":"Missing or invalid company profile"},"402":{"description":"x402 v2 payment required; inspect the PAYMENT-REQUIRED header"},"502":{"description":"Official BOAMP source temporarily unavailable"}}}},"/api/premium/quick-match":{"get":{"operationId":"quickMatchFrenchPublicTendersForCompany","tags":["Paid opportunity intelligence"],"summary":"BOAMP Quick Match — Find 3 French Public Tenders for My Company","description":"$0.05 Quick Match — try BOAMP Opportunity Intelligence with 3 ranked live opportunities before purchasing deeper analysis. Optimized for cheap French tender search, testing BOAMP matching, and finding public contracts for a company. Detailed rationale, risks, action plans, packs, and bid decisions are excluded.","parameters":[{"name":"q","in":"query","required":true,"description":"Business activity, trade, capability, product, or tender keywords to match","schema":{"type":"string","minLength":2,"maxLength":200},"example":"plomberie"},{"name":"department","in":"query","required":false,"description":"Optional French department code for geographic filtering, for example 57, 67, 2A, or 971","schema":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"example":"57"},{"name":"capabilities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance préventive,astreinte"},{"name":"source","in":"query","required":false,"description":"Official source selection; all deduplicates obvious cross-source duplicates","schema":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}}],"x-x402":{"version":2,"price":"$0.05","currency":"USDC","network":"eip155:8453","scheme":"exact"},"responses":{"200":{"description":"At most 3 essential ranked BOAMP matches plus premium upsell metadata","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"generated_at":{"type":"string","format":"date-time"},"opportunities":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"properties":{"notice_id":{"type":"string"},"title":{"type":"string"},"buyer":{"type":["string","null"]},"department_location":{"type":"object"},"deadline":{"type":["string","null"],"format":"date-time"},"fit_score":{"type":"integer","minimum":0,"maximum":100},"primary_match_reason":{"type":"string"},"official_boamp_reference":{"type":"object"}},"required":["notice_id","title","buyer","department_location","deadline","fit_score","primary_match_reason","official_boamp_reference"]}},"upsell":{"type":"object"}},"required":["generated_at","opportunities","upsell"]},"example":{"generated_at":"2026-08-28T12:00:00.000Z","opportunities":[{"notice_id":"24-123456","title":"Travaux de plomberie et maintenance des installations","buyer":"Commune exemple","department_location":{"departments":["57"]},"deadline":"2026-09-18T12:00:00Z","fit_score":83,"primary_match_reason":"Activité correspondante : plomberie","official_boamp_reference":{"notice_id":"24-123456","official_url":"https://www.boamp.fr/"}}],"upsell":{"full_company_match":{"price":"$0.49","route":"/api/premium/search"},"opportunity_pack_2_0":{"price":"$1.99","route":"/api/premium/pack"},"bid_no_bid_decision":{"price":"$4.99","route":"/api/premium/bid-decision"}}}}}},"400":{"description":"Missing business activity q"},"402":{"description":"x402 v2 payment required; exact amount 50000 USDC base units"},"502":{"description":"Official BOAMP source temporarily unavailable"}}}},"/api/premium/pack":{"get":{"operationId":"rankFrenchTenderOpportunities","tags":["Paid opportunity intelligence"],"summary":"Build BOAMP Opportunity Pack 2.0 decision dossier","description":"Returns an attention summary and up to 15 ranked live tenders with fit, rationale, urgency, requirements, risks, official evidence, and bid-response actions—not merely more raw records. Searchable as BOAMP, French public procurement, France tenders, public tenders, marchés publics, procurement opportunities, business opportunity matching, and tender intelligence.","parameters":[{"name":"q","in":"query","required":true,"description":"Business activity, trade, capability, product, or tender keywords to match","schema":{"type":"string","minLength":2,"maxLength":200},"example":"plomberie"},{"name":"department","in":"query","required":false,"description":"Optional French department code for geographic filtering, for example 57, 67, 2A, or 971","schema":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"example":"57"},{"name":"geographic_area","in":"query","required":false,"schema":{"type":"string","maxLength":100},"example":"Grand Est"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000},"description":"Preference only; exact distance remains unknown without coordinates"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance,chauffage"},{"name":"capabilities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"maintenance préventive,astreinte"},{"name":"excluded_activities","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"construction neuve"},{"name":"preferred_contract_characteristics","in":"query","required":false,"schema":{"type":"string","maxLength":500},"example":"accord-cadre,procédure adaptée"},{"name":"source","in":"query","required":false,"description":"Official source selection; all deduplicates obvious cross-source duplicates","schema":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}}],"x-x402":{"version":2,"price":"$1.99","currency":"USDC","network":"eip155:8453","scheme":"exact"},"responses":{"200":{"description":"Actionable opportunity intelligence","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"source":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"payment_mode":{"const":"x402"},"network":{"const":"eip155:8453"},"paid_feature":{"type":"boolean"},"company_profile":{"type":"object"},"scoring_method":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":15},"results":{"type":"array","maxItems":30,"items":{"type":"object","properties":{"id":{"type":"string","description":"Official BOAMP notice identifier"},"score":{"type":"integer","minimum":0,"maximum":100,"description":"Opportunity match score"},"fit_score":{"type":"integer","minimum":0,"maximum":100,"description":"Deterministic explainable company-to-opportunity fit score; never a win probability"},"match_level":{"type":"string","enum":["excellent","strong","review","weak"]},"title":{"type":"string"},"buyer":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"deadline":{"type":["string","null"],"format":"date-time"},"days_left":{"type":["integer","null"]},"departments":{"type":"array","items":{"type":"string"}},"location":{"type":"object"},"market_types":{"type":"array","items":{"type":"string"}},"descriptors":{"type":"array","items":{"type":"string"}},"cpv_codes":{"type":"array","items":{"type":"string"}},"procedure":{"type":["string","null"]},"requirements_detected":{"type":"array","items":{"type":"string"}},"possible_disqualifiers":{"type":"array","items":{"type":"string"}},"urgency":{"type":"string","enum":["expired","critical","high","normal","unknown"]},"recommended_next_action":{"type":"string"},"source_evidence":{"type":"object"},"url":{"type":"string","format":"uri","description":"Official notice URL"},"matched_keywords":{"type":"array","items":{"type":"string"}},"why_match":{"type":"array","items":{"type":"string"}},"reasons_for_match":{"type":"array","items":{"type":"string"}},"ranking_reasons":{"type":"array","items":{"type":"string"}}},"required":["id","score","fit_score","match_level","title","buyer","published_at","deadline","days_left","departments","location","market_types","descriptors","cpv_codes","procedure","requirements_detected","possible_disqualifiers","urgency","recommended_next_action","source_evidence","url","matched_keywords","why_match","reasons_for_match","ranking_reasons"]}},"attention_summary":{"type":"string"},"opportunities":{"type":"array","maxItems":15,"items":{"type":"object","properties":{"id":{"type":"string","description":"Official BOAMP notice identifier"},"score":{"type":"integer","minimum":0,"maximum":100,"description":"Opportunity match score"},"fit_score":{"type":"integer","minimum":0,"maximum":100,"description":"Deterministic explainable company-to-opportunity fit score; never a win probability"},"match_level":{"type":"string","enum":["excellent","strong","review","weak"]},"title":{"type":"string"},"buyer":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"deadline":{"type":["string","null"],"format":"date-time"},"days_left":{"type":["integer","null"]},"departments":{"type":"array","items":{"type":"string"}},"location":{"type":"object"},"market_types":{"type":"array","items":{"type":"string"}},"descriptors":{"type":"array","items":{"type":"string"}},"cpv_codes":{"type":"array","items":{"type":"string"}},"procedure":{"type":["string","null"]},"requirements_detected":{"type":"array","items":{"type":"string"}},"possible_disqualifiers":{"type":"array","items":{"type":"string"}},"urgency":{"type":"string","enum":["expired","critical","high","normal","unknown"]},"recommended_next_action":{"type":"string"},"source_evidence":{"type":"object"},"url":{"type":"string","format":"uri","description":"Official notice URL"},"matched_keywords":{"type":"array","items":{"type":"string"}},"why_match":{"type":"array","items":{"type":"string"}},"reasons_for_match":{"type":"array","items":{"type":"string"}},"ranking_reasons":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","items":{"type":"string"}},"important_requirements":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"caveat":{"type":"string"}},"required":["id","score","fit_score","match_level","title","buyer","published_at","deadline","days_left","departments","location","market_types","descriptors","cpv_codes","procedure","requirements_detected","possible_disqualifiers","urgency","recommended_next_action","source_evidence","url","matched_keywords","why_match","reasons_for_match","ranking_reasons","next_actions","important_requirements","risks","caveat"]}}},"required":["service","source","generated_at","payment_mode","network","company_profile","count","attention_summary","opportunities"]},"example":{"service":"BOAMP Opportunity Intelligence","source":"BOAMP / DILA Open Data","generated_at":"2026-08-28T12:00:00.000Z","payment_mode":"x402","network":"eip155:8453","company_profile":{"business_activity":"maintenance chauffage","keywords":[],"department":"67","capabilities":[],"excluded_activities":[],"preferred_contract_characteristics":[]},"count":1,"results":[{"id":"24-123456","score":83,"fit_score":83,"match_level":"excellent","title":"Travaux de plomberie et maintenance des installations","buyer":"Commune exemple","published_at":"2026-08-25T00:00:00Z","deadline":"2026-09-18T12:00:00Z","days_left":21,"departments":["57"],"location":{"departments":["57"],"requested_area":"57","radius_assessment":"not_requested"},"market_types":["TRAVAUX"],"descriptors":["Plomberie"],"cpv_codes":["45330000"],"procedure":"Procédure adaptée","requirements_detected":["Critères indiqués dans l'avis officiel"],"possible_disqualifiers":[],"urgency":"normal","recommended_next_action":"Open the official notice and validate eligibility in the DCE.","source_evidence":{"source":"BOAMP / DILA Open Data","notice_id":"24-123456","internal_id":null,"contract_folder_id":null,"source_schema":"eForms","official_url":"https://www.boamp.fr/","publication_timestamp":"2026-08-25T00:00:00Z","update_or_diffusion_timestamp":null},"url":"https://www.boamp.fr/","matched_keywords":["plomberie"],"why_match":["Mots-cles detectes : plomberie","Departement 57 correspondant"],"reasons_for_match":["Activité correspondante : plomberie","Département 57 correspondant"],"ranking_reasons":["Activité correspondante : plomberie","Département 57 correspondant"]}],"attention_summary":"One strong-fit live opportunity deserves immediate eligibility review.","opportunities":[{"id":"24-123456","score":91,"fit_score":83,"match_level":"excellent","title":"Travaux de plomberie et maintenance des installations","buyer":"Commune exemple","published_at":"2026-08-25T00:00:00Z","deadline":"2026-09-18T12:00:00Z","days_left":21,"departments":["57"],"location":{"departments":["57"],"requested_area":"57","radius_assessment":"not_requested"},"market_types":["TRAVAUX"],"descriptors":["Plomberie"],"cpv_codes":["45330000"],"procedure":"Procédure adaptée","requirements_detected":["Critères indiqués dans l'avis officiel"],"possible_disqualifiers":[],"urgency":"normal","recommended_next_action":"Open the official notice and validate eligibility in the DCE.","source_evidence":{"source":"BOAMP / DILA Open Data","notice_id":"24-123456","internal_id":null,"contract_folder_id":null,"source_schema":"eForms","official_url":"https://www.boamp.fr/","publication_timestamp":"2026-08-25T00:00:00Z","update_or_diffusion_timestamp":null},"url":"https://www.boamp.fr/","matched_keywords":["maintenance","chauffage"],"why_match":["Mots-cles detectes : maintenance, chauffage","Departement 67 correspondant"],"reasons_for_match":["Activité correspondante : plomberie","Département 57 correspondant"],"ranking_reasons":["Activité correspondante : plomberie","Département 57 correspondant"],"important_requirements":["Verify every criterion in the official DCE"],"risks":[],"next_actions":["Open the official BOAMP notice and verify the consultation rules.","Download the tender documents from the buyer profile."],"caveat":"Automated opportunity ranking; verify eligibility in the official documents."}]}}}},"400":{"description":"Missing or invalid company profile"},"402":{"description":"x402 v2 payment required; inspect the PAYMENT-REQUIRED header"},"502":{"description":"Official BOAMP source temporarily unavailable"}}}},"/api/premium/bid-decision":{"post":{"operationId":"analyzeFrenchTenderBidDecision","tags":["Bid decisions"],"summary":"Should my company bid on this French tender?","description":"Given an official BOAMP notice ID and transient company profile, returns an explainable BID, REVIEW, or NO-BID recommendation with risks, unknowns, evidence, and preparation checklist. No win probability and no hallucinated requirements.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"notice_id":{"type":"string","minLength":2,"maxLength":100,"description":"Official BOAMP idweb identifier"},"company_profile":{"type":"object","additionalProperties":false,"properties":{"business_activity":{"type":"string","minLength":2,"maxLength":500},"keywords":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"department":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"geographic_area":{"type":"string","maxLength":100},"radius_km":{"type":"number","minimum":0,"maximum":1000},"capabilities":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"excluded_activities":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"preferred_contract_characteristics":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}}},"required":["business_activity"]}},"required":["notice_id","company_profile"]},"example":{"notice_id":"24-123456","company_profile":{"business_activity":"maintenance chauffage","department":"67","capabilities":["maintenance préventive"]}}}}},"x-x402":{"version":2,"price":"$4.99","currency":"USDC","network":"eip155:8453","scheme":"exact"},"responses":{"200":{"description":"Explainable bid decision","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"decision":{"type":"string","enum":["BID","REVIEW","NO-BID"]},"decision_score":{"type":"integer","minimum":0,"maximum":100},"strongest_reasons_to_bid":{"type":"array","items":{"type":"string"}},"strongest_reasons_not_to_bid":{"type":"array","items":{"type":"string"}},"eligibility_risk_indicators":{"type":"array","items":{"type":"string"}},"deadline_risk":{"type":"object"},"geographic_fit":{"type":"object"},"activity_cpv_fit":{"type":"object"},"requirements_detected_in_notice":{"type":"array","items":{"type":"string"}},"missing_or_uncertain_information":{"type":"array","items":{"type":"string"}},"preparation_checklist":{"type":"array","items":{"type":"string"}},"recommended_next_actions":{"type":"array","items":{"type":"string"}},"official_boamp_evidence":{"type":"object"},"disclaimer":{"type":"string"}},"required":["service","generated_at","decision","decision_score","strongest_reasons_to_bid","strongest_reasons_not_to_bid","eligibility_risk_indicators","deadline_risk","geographic_fit","activity_cpv_fit","requirements_detected_in_notice","missing_or_uncertain_information","preparation_checklist","recommended_next_actions","official_boamp_evidence","disclaimer"]},"example":{"service":"BOAMP Opportunity Intelligence","generated_at":"2026-08-28T12:00:00.000Z","decision":"REVIEW","decision_score":68,"strongest_reasons_to_bid":["Activity match: maintenance, chauffage"],"strongest_reasons_not_to_bid":["Eligibility criteria require review in the official DCE"],"eligibility_risk_indicators":["Some eligibility information is unavailable in the indexed notice fields"],"deadline_risk":{"urgency":"high","days_left":10},"geographic_fit":{"requested_department":"67","notice_departments":["67"],"fit":"match"},"activity_cpv_fit":{"fit_score":68,"matched_terms":["maintenance","chauffage"],"cpv_codes":[]},"requirements_detected_in_notice":[],"missing_or_uncertain_information":["Detailed DCE eligibility requirements: unknown until the official documents are reviewed"],"preparation_checklist":["Open the official BOAMP notice","Download and review the DCE"],"recommended_next_actions":["Complete an eligibility review before committing bid resources"],"official_boamp_evidence":{"notice_id":"24-123456","official_url":"https://www.boamp.fr/"},"disclaimer":"Deterministic decision support, not a win probability or legal eligibility determination."}}}},"400":{"description":"Invalid notice ID or company profile"},"402":{"description":"x402 v2 payment required; inspect the PAYMENT-REQUIRED header"},"404":{"description":"BOAMP notice not found"},"502":{"description":"Official BOAMP source temporarily unavailable"}}}},"/api/premium/delta":{"post":{"operationId":"findNewFrenchTenderOpportunities","tags":["Paid opportunity intelligence"],"summary":"Find new French government procurement opportunities since a timestamp","description":"Machine-friendly delta tool for scheduled agents. Returns only newer official BOAMP notices ranked against a company profile; the profile is not stored.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"since":{"type":"string","format":"date-time"},"company_profile":{"type":"object","additionalProperties":false,"properties":{"business_activity":{"type":"string","minLength":2,"maxLength":500},"keywords":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"department":{"type":"string","pattern":"^[0-9A-Za-z]{2,3}$"},"geographic_area":{"type":"string","maxLength":100},"radius_km":{"type":"number","minimum":0,"maximum":1000},"capabilities":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"excluded_activities":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"preferred_contract_characteristics":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}}},"required":["business_activity"]},"limit":{"type":"integer","minimum":1,"maximum":30},"source":{"type":"string","enum":["boamp","ted","all"],"default":"boamp"}},"required":["since","company_profile"]},"example":{"since":"2026-08-27T00:00:00Z","company_profile":{"business_activity":"cybersécurité","keywords":["audit","SOC"]},"limit":10}}}},"x-x402":{"version":2,"price":"$0.49","currency":"USDC","network":"eip155:8453","scheme":"exact"},"responses":{"200":{"description":"New matched opportunities and next cursor"},"400":{"description":"Invalid timestamp or company profile"},"402":{"description":"x402 v2 payment required; inspect the PAYMENT-REQUIRED header"},"502":{"description":"Official BOAMP source temporarily unavailable"}}}},"/api/usage":{"get":{"operationId":"getAnonymousUsageMetrics","tags":["Operations"],"summary":"Read aggregate monthly usage and settlement allowance","description":"Stores no IP, wallet, query, user-agent, or personal identifier data.","responses":{"200":{"description":"Aggregate UTC-month counters and revenue estimate"}}}}}}