{"components":{"securitySchemes":{"ApiKeyAuth":{"in":"header","name":"X-API-Key","type":"apiKey"}}},"info":{"description":"Agent-ready Corsican legal & economic intelligence.","title":"BIS Platinum data API","version":"1.0"},"openapi":"3.0.3","paths":{"/data/api/economic_signal":{"get":{"operationId":"economic_signal","parameters":[{"description":"Indicator name, e.g. company_creations.","in":"query","name":"indicator","required":false,"schema":{"type":"string"}},{"description":"NAF/APE activity code.","in":"query","name":"naf","required":false,"schema":{"type":"string"}},{"description":"Period, e.g. 2025-Q1 or 2025-03.","in":"query","name":"period","required":false,"schema":{"type":"string"}},{"description":"Max rows to return (1\u20131000).","in":"query","name":"limit","required":false,"schema":{"maximum":1000,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[{"ApiKeyAuth":[]}],"summary":"Per-NAF / per-territory economic indicators aggregated from BODACC, INSEE BDM, Banque de France, DARES."}},"/data/api/get_company":{"get":{"operationId":"get_company","parameters":[{"description":"9-digit SIREN.","in":"query","name":"siren","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[{"ApiKeyAuth":[]}],"summary":"Fetch one company by SIREN plus its most recent legal notices."}},"/data/api/list_datasets":{"get":{"operationId":"list_datasets","parameters":[],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[],"summary":"List the available BIS data products (name, tier, fields, licence)."}},"/data/api/list_notices":{"get":{"operationId":"list_notices","parameters":[{"description":"Only notices published on/after this ISO date (YYYY-MM-DD).","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"Department.","in":"query","name":"dept","required":false,"schema":{"enum":["2A","2B"],"type":"string"}},{"description":"Notice family (familleavis), e.g. collective, vente.","in":"query","name":"type","required":false,"schema":{"type":"string"}},{"description":"Filter to one company SIREN.","in":"query","name":"siren","required":false,"schema":{"type":"string"}},{"description":"Max rows to return (1\u20131000).","in":"query","name":"limit","required":false,"schema":{"maximum":1000,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[{"ApiKeyAuth":[]}],"summary":"List legal notices (BODACC/BOAMP/Pr\u00e9fectures) filtered by date, department, type (familleavis), or company SIREN."}},"/data/api/search_companies":{"get":{"operationId":"search_companies","parameters":[{"description":"Commune name, e.g. AJACCIO.","in":"query","name":"commune","required":false,"schema":{"type":"string"}},{"description":"NAF/APE activity code, e.g. 56.10A.","in":"query","name":"naf","required":false,"schema":{"type":"string"}},{"description":"Headcount band.","in":"query","name":"size_band","required":false,"schema":{"enum":["small","medium","large"],"type":"string"}},{"description":"Administrative status.","in":"query","name":"status","required":false,"schema":{"enum":["A","C"],"type":"string"}},{"description":"Max rows to return (1\u20131000).","in":"query","name":"limit","required":false,"schema":{"maximum":1000,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search the Corsican company universe (SIRENE) by commune, NAF code, size band (small/medium/large), and status."}},"/data/api/sector_vitality":{"get":{"operationId":"sector_vitality","parameters":[{"description":"NAF/APE activity code (required), e.g. 56.10A.","in":"query","name":"naf","required":true,"schema":{"type":"string"}},{"description":"Commune name.","in":"query","name":"commune","required":false,"schema":{"type":"string"}},{"description":"Quarter, e.g. 2025-Q1.","in":"query","name":"period","required":false,"schema":{"type":"string"}},{"description":"Max rows to return (1\u20131000).","in":"query","name":"limit","required":false,"schema":{"maximum":1000,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Envelope with data + meta"}},"security":[{"ApiKeyAuth":[]}],"summary":"Per-NAF sector vitality (creations, dissolutions, net flow, 5-year survival) by commune and quarter."}}},"servers":[{"url":"https://corseannonceslegales.com"}]}