Base URL: https://api.orbioapi.com.br
Exemplo — Account discovery
Cenário
“Quero empresas de software B2B em SP com email.”
Requisição (spec)
json
{
"spec": {
"kind": "account_query",
"spec_version": "2.0",
"entity": "company",
"limit": 1000,
"filters": {
"industry": {
"cnae_any_of": ["6201-5/00"],
"cnae_exclude": [],
"secondary_cnae_mode": "off",
"text_hints": ["software", "b2b"]
},
"geo": {
"uf_any_of": ["SP"],
"municipality_ibge_any_of": [],
"municipality_tom_any_of": []
},
"company": {
"registration_status_any_of": [],
"company_size_code_any_of": [],
"headquarters_only": true,
"simples_opt_in": null,
"mei_opt_in": null,
"started_after": null,
"started_before": null
},
"contact": {
"require_email": true,
"require_phone": false,
"require_any_contact": false
}
},
"sort": [],
"scoring": { "strategy": "balanced", "random_seed": null },
"output": {
"format": "json",
"include_explain": false,
"fields": ["cnpj", "legal_name", "uf", "email"]
},
"explain": {
"assumptions": [],
"warnings": [],
"unmapped_constraints": [],
"confidence": 0.9
}
}
}Resposta (resumo)
json
{
"request_id": "req_01HX...",
"snapshot": "2026-01",
"snapshot_date": "2026-01-31",
"provenance": {
"rfb_snapshot": "2026-01",
"ibge_population_year": "not_available",
"ceis_as_of_date": "not_available"
},
"accounts": [
{
"cnpj": "00000000000000",
"legal_name": "SOFTWARE EXEMPLO LTDA",
"uf": "SP",
"email": "contato@example.com"
}
],
"next_cursor": "eyJvZmZzZXQiOjEwMDB9",
"has_more": true
}Observação: a resposta completa também inclui spec com os filtros normalizados.
Quando usar export async
Se o volume for alto, use o fluxo de export:

