Listar empresas
Devolve as empresas da conta, da mais recente para a mais antiga, em páginas por cursor.
GET
https://app.salos.com.br/api/companies
companies:read
Filtros
| Parâmetro | Tipo | O que faz |
|---|---|---|
search |
texto | procura por nome |
external_id |
texto | só a empresa daquele id de origem, se você usa importação |
limit |
número | quantos por página (padrão 25, teto 999) |
cursor |
texto | o next_cursor da página anterior |
format |
csv |
devolve CSV em vez de JSON, para planilha |
created_after |
data ISO 8601 | só empresas criadas a partir deste instante |
created_before |
data ISO 8601 | só empresas criadas até este instante |
updated_after |
data ISO 8601 | só empresas atualizadas a partir deste instante |
updated_before |
data ISO 8601 | só empresas atualizadas até este instante |
Resposta
{
"data": [
{
"id": "9f1e4b7a-2d5c-4f8e-8b3a-6c9d2e5f1a73",
"name": "Aurora Esquadrias",
"notes": null,
"cnpj": "11222333000181",
"legal_name": "Aurora Esquadrias Ltda",
"segment": "Indústria",
"size": "Média",
"phone": "+55 11 3333-4444",
"email": "contato@auroraesquadrias.com.br",
"website": "https://auroraesquadrias.com.br",
"zip_code": "01310-100",
"street": "Av. Paulista",
"street_number": "1000",
"complement": "sala 12",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"external_id": null,
"tags": [],
"custom_fields": {},
"created_at": "2026-05-02T12:00:00.000Z",
"updated_at": "2026-05-02T12:00:00.000Z"
}
],
"pagination": { "next_cursor": null }
}cnpj sai sempre NORMALIZADO — só dígitos, sem máscara. Formate na sua ponta se precisar exibir.
Enquanto next_cursor vier preenchido, existe mais página. Quando vier null, acabou.
Duas armadilhas
- O campo
tagssome se a chave não tivertags:read. Ele não vem vazio: some do JSON — quem lêempresa.tags.lengthquebra sem entender por quê. - Sem
cursor, cada chamada devolve a primeira página. Percorrer a base é seguir onext_cursor, nunca somaroffset.