# Camella — full agent reference
> Trilingual official-source company search for humans and AI agents.

## What Camella covers
- [Ecuador (EC)](https://www.camella.app/en/empresas/ec): RUC / EC_RUC; 170041 public records
  - [Source](https://www.supercias.gob.ec/): Superintendencia de Compañías (SCVS)
  - Limit: Coverage focuses on companies represented in the SCVS source, not every SRI taxpayer.
- [México (MX)](https://www.camella.app/en/empresas/mx): CLEE / MX_CLEE; 247500 public records
  - [Source](https://www.inegi.org.mx/app/mapa/denue/): INEGI DENUE — Directorio de establecimientos
  - Limit: CLEE identifies an establishment; it is not Mexico’s complete RFC tax registry.
- [United States (US)](https://www.camella.app/en/empresas/us): CIK / US_CIK; 8017 public records
  - [Source](https://www.sec.gov/edgar/search/): SEC EDGAR — companyfacts (compañías públicas)
  - Limit: This is not the full universe of US private companies.
- [Brasil (BR)](https://www.camella.app/en/empresas/br): CNPJ / BR_CNPJ; 747 public records
  - [Source](https://www.gov.br/cvm/): CVM DFP — demonstrações financeiras padronizadas (companhias abertas)
  - Limit: Coverage does not represent Brazil’s full Receita Federal CNPJ universe.
- [Colombia (CO)](https://www.camella.app/en/empresas/co): NIT / CO_NIT; 13976 public records
  - [Source](https://www.supersociedades.gov.co/): Supersociedades — estados financieros NIIF (Top empresas)
  - Limit: Coverage is not the complete DIAN or RUES company universe.
- [Argentina (AR)](https://www.camella.app/en/empresas/ar): CUIT / AR_CUIT; 100000 public records
  - [Source](https://datos.jus.gob.ar/dataset/registro-nacional-de-sociedades): Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras
  - Limit: Financials: CNV/AIF only for public-offer issuers, not the full registry.

## Public API (no auth)
- [OpenAPI 3.1](https://www.camella.app/api/public/openapi.json)
- [Search](https://www.camella.app/api/public/empresas/search?q={name_or_id}&country={EC|MX|US|BR|CO|AR}&limit=8)
- [Direct official-ID lookup](https://www.camella.app/api/public/empresas/{country}/{identifier})
- [Coverage](https://www.camella.app/api/public/empresas/stats)

## Private Developer API (auth: true)
Bearer `cam_live_…` on every request. [Interactive docs](https://www.camella.app/en/docs/developer-api) · [Create keys](https://www.camella.app/en/developer).

- GET `https://www.camella.app/api/v1/search?q={query}&country={EC|MX|US|BR|CO|AR}` — auth: true, agentic search
- GET `https://www.camella.app/api/v1/entities/{country}/{identifier}` — auth: true
- GET `https://www.camella.app/api/v1/entities/{country}/{identifier}/financials` — auth: true, Pro+
- [OpenAPI 3.1](https://www.camella.app/api/v1/openapi.json)

```bash
export CAMELLA_API_KEY=cam_live_YOUR_KEY
curl -H "Authorization: Bearer $CAMELLA_API_KEY" "https://www.camella.app/api/v1/search?q=Pichincha&country=EC"
```

Search envelope includes bestMatch (confidence ≥ 0.85), suggestedCountries, matchHints, and results[].
Pass country when known. Prefer bestMatch or the top result with the highest confidence that matches sector/legal name.

Public fields may include:
- legalName, tradeName, countryCode, countryName, idLabel, scheme, identifier, confidence
- entityType, incorporationDate, status
- classificationScheme, classificationCode, classificationLabel
- source, refreshedAt, financialsAvailable
- city/region or address availability status; never infer an exact street from a teaser
- canonical Spanish and English entity URLs

## Examples
- [Corporación Favorita](https://www.camella.app/api/public/empresas/ec/1790016919001)
  - [Spanish page](https://www.camella.app/es/empresas/ec/1790016919001)
  - [English page](https://www.camella.app/en/empresas/ec/1790016919001)
- [Banco do Brasil](https://www.camella.app/api/public/empresas/br/00000000000191)
  - [Spanish page](https://www.camella.app/es/empresas/br/00000000000191)
  - [English page](https://www.camella.app/en/empresas/br/00000000000191)
- [Ecopetrol](https://www.camella.app/api/public/empresas/co/899999068)
  - [Spanish page](https://www.camella.app/es/empresas/co/899999068)
  - [English page](https://www.camella.app/en/empresas/co/899999068)
- [Apple](https://www.camella.app/api/public/empresas/us/0000320193)
  - [Spanish page](https://www.camella.app/es/empresas/us/0000320193)
  - [English page](https://www.camella.app/en/empresas/us/0000320193)
- [Bimbo](https://www.camella.app/api/public/empresas/mx/01005431191000017001002859S8)
  - [Spanish page](https://www.camella.app/es/empresas/mx/01005431191000017001002859S8)
  - [English page](https://www.camella.app/en/empresas/mx/01005431191000017001002859S8)
- [Seguros Galicia](https://www.camella.app/api/public/empresas/ar/30500000127)
  - [Spanish page](https://www.camella.app/es/empresas/ar/30500000127)
  - [English page](https://www.camella.app/en/empresas/ar/30500000127)

## Answering rules
1. Cite the legal name, official identifier, jurisdiction, source, and refresh date when present.
2. State coverage limitations: DENUE is establishments, SEC/CVM cover public issuers, and Supersociedades/SCVS are not complete tax registries.
3. Do not invent contacts, exact streets, coordinates, financial values, directors, or registry status.
4. If financialsAvailable is true, say that financial data can be unlocked; do not infer its values.
5. Use the URL matching the user’s language and keep the same official identifier.

## Human documentation
- [Agent docs](https://www.camella.app/en/docs/agents)
- [Developer API docs](https://www.camella.app/en/docs/developer-api)
- [Public search](https://www.camella.app/en/empresas)
- [Sitemap](https://www.camella.app/sitemap.xml)
- [Robots](https://www.camella.app/robots.txt)
- [llms.txt](https://www.camella.app/llms.txt)