{"openapi":"3.1.0","info":{"title":"Camella Developer API","version":"1.0.0","description":"Authenticated company search and entity lookup for EC, MX, US, BR, CO, AR. Requires Bearer API key (cam_live_…) — keys are Enterprise-only. Field redaction still follows the plan ladder: Free identity; Pro financials + basic export; Pro+ contacts + enrichment domains (tax/legal/SME/credit/procurement); Enterprise full export + API access. domainPresence flags may appear on all entitled responses; enrichmentUnlocked is true only for Pro+/Enterprise."},"servers":[{"url":"https://www.camella.app"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/search":{"get":{"operationId":"agenticSearch","summary":"Agentic multi-country company search","x-auth-required":true,"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"country","in":"query","schema":{"type":"string","enum":["EC","MX","US","BR","CO","AR"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":8}},{"name":"hasPerson","in":"query","description":"Enterprise presence filter: only entities with a warehouse contact person name. AND with hasEmail / hasPhone. Ignored on non-Enterprise.","schema":{"type":"boolean"}},{"name":"hasEmail","in":"query","description":"Enterprise presence filter: only entities with a warehouse email. AND with other has* flags. Ignored on non-Enterprise.","schema":{"type":"boolean"}},{"name":"hasPhone","in":"query","description":"Enterprise presence filter: only entities with a warehouse phone. AND with other has* flags. Ignored on non-Enterprise.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Search results with bestMatch and matchHints"},"401":{"description":"Invalid or missing API key"},"429":{"description":"Rate limit or monthly quota exceeded"}}}},"/api/v1/entities/{country}/{identifier}":{"get":{"operationId":"getEntity","summary":"Lookup one legal entity by country and identifier","x-auth-required":true,"security":[{"bearerAuth":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","enum":["EC","MX","US","BR","CO","AR"]}},{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entity record with plan-gated fields"},"404":{"description":"Entity not found"}}}},"/api/v1/entities/{country}/{identifier}/financials":{"get":{"operationId":"getFinancialHistory","summary":"Financial history for an entity (Enterprise API key; financial field gate ≥ Pro)","x-auth-required":true,"x-plan-required":"ENTERPRISE","x-field-gate":"financials>=PRO","security":[{"bearerAuth":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","enum":["EC","MX","US","BR","CO","AR"]}},{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Financial history rows"},"403":{"description":"Plan does not include financial export"},"404":{"description":"Entity not found"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key prefixed with cam_live_"}}}}