Skip to main content
GET
/
listas-restritivas
/
{documento}
Listas restritivas por documento
curl --request GET \
  --url 'https://221b-api.sherlocker.com.br/api/v1/listas-restritivas/{documento}?token='
{
  "documento": {
    "numero": "<string>",
    "nome": "<string>"
  },
  "consultado_em": "<string>",
  "resumo": {
    "tem_ocorrencia": true,
    "tem_sancao": true,
    "tem_alerta": true,
    "total_ocorrencias": 123,
    "por_grupo": {
      "sancoes": 123,
      "restritivas": 123,
      "alertas": 123
    },
    "fontes_aplicaveis": 123,
    "fontes_consultadas": 123,
    "com_ocorrencia": 123,
    "indisponiveis": 123,
    "nao_aplicaveis": 123
  },
  "grupos": {
    "sancoes": [
      {
        "lista_id": "cnep",
        "fonte": "CNEP",
        "grupo": "sancoes",
        "nome_na_fonte": "ACME LTDA",
        "titulo": "CNEP — Empresas Punidas",
        "orgao": "Controladoria-Geral da Uniao",
        "data_inicio": "2024-01-01",
        "data_fim": "2027-01-01",
        "vigente": true,
        "fonte_oficial": "https://portaldatransparencia.gov.br",
        "ultima_atualizacao": "2026-06-15 13:00:00",
        "detalhes": {}
      }
    ],
    "restritivas": [
      {
        "lista_id": "cnep",
        "fonte": "CNEP",
        "grupo": "sancoes",
        "nome_na_fonte": "ACME LTDA",
        "titulo": "CNEP — Empresas Punidas",
        "orgao": "Controladoria-Geral da Uniao",
        "data_inicio": "2024-01-01",
        "data_fim": "2027-01-01",
        "vigente": true,
        "fonte_oficial": "https://portaldatransparencia.gov.br",
        "ultima_atualizacao": "2026-06-15 13:00:00",
        "detalhes": {}
      }
    ],
    "alertas": [
      {
        "lista_id": "cnep",
        "fonte": "CNEP",
        "grupo": "sancoes",
        "nome_na_fonte": "ACME LTDA",
        "titulo": "CNEP — Empresas Punidas",
        "orgao": "Controladoria-Geral da Uniao",
        "data_inicio": "2024-01-01",
        "data_fim": "2027-01-01",
        "vigente": true,
        "fonte_oficial": "https://portaldatransparencia.gov.br",
        "ultima_atualizacao": "2026-06-15 13:00:00",
        "detalhes": {}
      }
    ]
  },
  "cobertura": [
    {
      "lista_id": "ceis",
      "nome": "CEIS — Empresas Inidoneas e Suspensas",
      "ocorrencias": 0,
      "ultima_atualizacao": "2026-06-15 13:00:00",
      "motivo": "<string>",
      "fonte_oficial": "https://portaldatransparencia.gov.br"
    }
  ]
}

Authorizations

token
string
query
required

Path Parameters

documento
string
required

CPF (11 digitos) ou CNPJ (14 digitos), com ou sem formatacao

Example:

"12345678000199"

Query Parameters

nome
string

Nome / razao social. Se omitido, e resolvido automaticamente da base.

Response

Ocorrencias agrupadas + mapa de cobertura (ver exemplos em /cpf e /cnpj)

documento
object
consultado_em
string

ISO 8601

resumo
object

Veredito de uma olhada.

grupos
object
cobertura
object[]