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 tags some se a chave não tiver tags:read. Ele não vem vazio: some do JSON — quem lê empresa.tags.length quebra sem entender por quê.
  • Sem cursor, cada chamada devolve a primeira página. Percorrer a base é seguir o next_cursor, nunca somar offset.