Skip to main content
GET
/
empresas
/
cnpj
/
{cnpj}
/
linha-do-tempo
Linha do tempo da empresa
curl --request GET \
  --url 'https://221b-api.sherlocker.com.br/api/v1/empresas/cnpj/{cnpj}/linha-do-tempo?token='
{
  "cnpj": "12.345.678/0001-99",
  "cobertura": {
    "dados_a_partir_de": "2024-01",
    "meses_disponiveis": [
      "2024-01",
      "2024-02",
      "2024-03",
      "2024-04",
      "2024-05"
    ],
    "aviso": "Meses não listados ainda não foram processados; alterações nesses períodos podem não aparecer. Eventos com origem 'estado_inicial' representam o estado no início do monitoramento, não uma alteração."
  },
  "retornados": 2,
  "truncado": false,
  "linha_do_tempo": [
    {
      "data": "2024-05-15",
      "data_oficial": true,
      "mes_referencia": "2024-05",
      "entidade": "empresa",
      "estabelecimento": "12.345.678/0001-99",
      "tipo": "razao_social_alterada",
      "categoria": "cadastro",
      "origem": "alteracao",
      "titulo": "Razão social alterada",
      "descricao": "Razão social alterada de \"Empresa Velha Ltda\" para \"Empresa Nova Ltda\".",
      "campo": "razao_social",
      "de": {
        "descricao": "Empresa Velha Ltda"
      },
      "para": {
        "descricao": "Empresa Nova Ltda"
      },
      "pessoa": null
    },
    {
      "data": "2024-04-10",
      "data_oficial": true,
      "mes_referencia": "2024-04",
      "entidade": "socio",
      "estabelecimento": "12.345.678/0001-99",
      "tipo": "socio_entrada",
      "categoria": "socios",
      "origem": "alteracao",
      "titulo": "Entrada de sócio",
      "descricao": "João Silva Da Costa entrou como Sócio-Administrador.",
      "de": null,
      "para": {
        "descricao": "João Silva Da Costa"
      },
      "pessoa": {
        "nome": "João Silva Da Costa",
        "documento": "123.456.789-10",
        "qualificacao": "Sócio-Administrador"
      }
    }
  ]
}

Authorizations

token
string
query
required

Path Parameters

cnpj
string
required

CNPJ da empresa (14 digitos)

Example:

"12345678000199"

Query Parameters

tipos
string

Filtra por tipo de evento. CSV dos 15 tipos (ex.: socio_entrada,capital_alterado). Omitido = todos.

Example:

"socio_entrada,socio_saida"

desde
string

Mes inicial inclusive (YYYY-MM)

Example:

"2024-01"

ate
string

Mes final inclusive (YYYY-MM)

Example:

"2024-12"

limite
integer
default:500

Maximo de eventos retornados (1 a 2000, padrao 500). Sem offset: use truncado + filtros para ver mais.

Required range: x <= 2000
Example:

500

Response

Linha do tempo com cobertura e eventos

cnpj
string

CNPJ consultado, formatado

cobertura
object
retornados
integer

Quantidade de eventos devolvidos

truncado
boolean

true quando retornados bateu no limite (ha mais eventos)

linha_do_tempo
object[]