O que é#

A certidão de distribuição TRF1 atesta que uma pessoa ou empresa possui ou não alguma ação de natureza criminal.

A certidão TRF1 informa sobre ações ocorridas em alguns estados das regiões norte, nordeste, centro-oeste.

Sobre a requisição#

Método: POST

Endereço: https://api.plexi.com.br/api/maestro/trf1/certidao-distribuicao

URL Base: https://api.plexi.com.br/

Parâmetros do header#

Nome Tipo Obrigatório? Descrição
Authorization String Sim Chave de API gerada no cadastro no Plexi, prefixada com Bearer
Callback String Não URL para onde o resultado da requisição será enviado via HTTP POST.

Parâmetros do body#

Nome Tipo Obrigatório? Descrição
tipo string Sim Tipo da certidão. A tabela abaixo apresenta os valores possíveis.
cpfCnpj string Sim CPF ou CNPJ a ser pesquisado.
orgaos array Sim Órgãos onde a consulta será realizada. A tabela abaixo apresenta os valores possíveis.
matrizFiliais boolean Não Considerar Matriz e Filiais na consulta. Valor padrão é false

Valores possíveis para o campo "tipo"

Valor Descrição
criminal Criminal
civel Cível
eleitoral Eleitoral

Valores válidos para o campo "orgaos"

Valor Descrição
ac SEÇÃO JUDICIÁRIA DO ESTADO DO ACRE
am SEÇÃO JUDICIÁRIA DO ESTADO DO AMAZONAS
ap SEÇÃO JUDICIÁRIA DO ESTADO DO AMAPÁ
ba SEÇÃO JUDICIÁRIA DO ESTADO DA BAHIA
df SEÇÃO JUDICIÁRIA DO DISTRITO FEDERAL
go SEÇÃO JUDICIÁRIA DO ESTADO DE GOIÁS
ma SEÇÃO JUDICIÁRIA DO ESTADO DO MARANHÃO
mt SEÇÃO JUDICIÁRIA DO ESTADO DE MATO GROSSO
pa SEÇÃO JUDICIÁRIA DO ESTADO DO PARÁ
pi SEÇÃO JUDICIÁRIA DO ESTADO DO PIAUÍ
ro SEÇÃO JUDICIÁRIA DO ESTADO DE RONDÔNIA
rr SEÇÃO JUDICIÁRIA DO ESTADO DE RORAIMA
to SEÇÃO JUDICIÁRIA DO ESTADO DO TOCANTINS
trf1 TRIBUNAL REGIONAL FEDERAL DA 1ª REGIÃO
varasJuizados Varas e Juizados (Todo o 1º Grau). Obs: Este valor só pode ser enviado sozinho, caso tenha outro valor dentro do array, uma exceção será informada.
regionalizada Regionalizada (1º e 2º Graus). Obs: Este valor só pode ser enviado sozinho, caso tenha outro valor dentro do array, uma exceção será informada.

Estrutura da resposta#

Status Significado Descrição Informações retornadas
201 Created Solicitação criada Campo requestId, com o ID da requisição criada.
422 Unprocessable Entity A solicitação contém erro Em quais campos houve erro.

Exemplos de retornos quando você faz a requisição#

Status 201

A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.

JSON
{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

Status 422

Significa que ocorreu um erro de validação dos dados enviados.

JSON
{
  "message": "The given data was invalid.",
  "errors": {
    "cpf": [
      "O campo cpf é obrigatório."
    ],
    "nome": [
      "O campo nome é obrigatório."
    ]
  }
}

Exemplos de retornos do resultado da pesquisa#

Valores possíveis do campo "status"

Status Significado
negativo Empresa ou pessoa NÃO está associada a ações na região TRF1
indefinido O sistema não pôde emitir a certidão automaticamente, pois foi detectada como positiva ou ocorreu homonímia (nomes semelhantes). O requerente deverá solicitar análise diretamente no site do TRF1.
erro Erro ao buscar informações, seja por documento ou outro dado incorreto

Respostas com status negativo

JSON
{
  "status": "negativo",
  "cpfCnpj": "999.999.999-99",
  "nome": "FULANO DA SILVA",
  "numeroCertidao": "99999999",
  "dataHora": "01/01/2020 00:00",
  "codigoSeguranca": "9999 9999 9999 9999 9999 9999 9999 9999",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}

Respostas com status indefinido

JSON
{
  "status": "indefinido",
  "mensagem": "Com base nas informações digitadas, o sistema não pode emitir a certidão, pois foi detectada como positiva ou ocorreu homonímia (nomes semelhantes).",
  "cpfCnpj": "99.999.999/9999-99",
  "nome": "EMPRESA LTDA",
  "numeroCertidao": "99999999",
  "dataHora": null,
  "codigoSeguranca": null,
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}

Respostas com status erro

JSON
{
  "status": "erro",
  "mensagem": "CPF ou CNPJ inexistente",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}