{"openapi":"3.1.0","info":{"title":"Camella Public Company Search API","version":"1.0.0","description":"Bilingual, official-source company identity lookup for Ecuador, Mexico, the United States, Brazil, Colombia, and Argentina. Public responses exclude exact streets, contacts, and financial values. For authenticated integrations (agentic search, entity lookup, financial history), see /docs/developer-api and GET /api/v1/openapi.json."},"servers":[{"url":"https://www.camella.app"}],"paths":{"/api/public/empresas/search":{"get":{"operationId":"searchCompanies","summary":"Search companies by legal name or official identifier","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":20,"default":8}}],"responses":{"200":{"description":"Matching public company teasers","content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"country":{"type":["string","null"]},"bestMatch":{"oneOf":[{"$ref":"#/components/schemas/CompanyTeaser"},{"type":"null"}],"description":"First result when confidence ≥ 0.85; otherwise null. Prefer this for agent citations."},"suggestedCountries":{"type":"array","items":{"type":"string","enum":["EC","MX","US","BR","CO","AR"]},"description":"Distinct countries among matches when country was omitted and ≥2 appear."},"matchHints":{"type":"array","items":{"type":"string"},"description":"Short tips e.g. pass country when known."},"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyTeaser"}}}}}}}}}},"/api/public/empresas/{country}/{identifier}":{"get":{"operationId":"getCompanyByOfficialId","summary":"Get one company by country and official identifier","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":"Official-source public company facts","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/CompanyRecord"}}}}}},"404":{"description":"Company not found"}}}},"/api/public/empresas/stats":{"get":{"operationId":"getCompanyCoverage","summary":"Get live public record counts by country","responses":{"200":{"description":"Coverage counts"}}}}},"components":{"schemas":{"CompanyTeaser":{"type":"object","required":["legalName","countryCode","scheme","identifier","financialsAvailable"],"properties":{"legalName":{"type":"string"},"tradeName":{"type":["string","null"]},"countryCode":{"type":"string"},"scheme":{"type":"string"},"identifier":{"type":"string"},"idLabel":{"type":"string"},"confidence":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Directory search rank (0–1)."},"status":{"type":["string","null"]},"classificationCode":{"type":["string","null"]},"classificationLabel":{"type":["string","null"]},"financialsAvailable":{"type":"boolean"},"canonicalUrls":{"type":"object","properties":{"es":{"type":"string","format":"uri"},"en":{"type":"string","format":"uri"}}}}},"CompanyRecord":{"allOf":[{"$ref":"#/components/schemas/CompanyTeaser"},{"type":"object","properties":{"idLabel":{"type":"string"},"source":{"type":["object","null"],"properties":{"sourceName":{"type":["string","null"]},"sourceUrl":{"type":["string","null"],"format":"uri"}}},"refreshedAt":{"type":["string","null"],"format":"date-time"}}}]}}},"externalDocs":{"description":"Human and agent documentation (public teaser + Developer API)","url":"https://www.camella.app/en/docs/agents"},"x-camella-developer-api":{"description":"Authenticated v1 API for integrations (Bearer cam_live_ keys)","openapi":"https://www.camella.app/api/v1/openapi.json","docs":"https://www.camella.app/en/docs/developer-api"}}