O que é#

As certidões de distribuição dos Tribunais Regionais Federais atestam que uma pessoa ou empresa possui ou não alguma ação de natureza criminal.

Os Tribunais Regionais Federais são os tribunais de segunda instância do governo federal e são divididos em 6 regiões. Para cada região é disponibilizada uma consulta diferente no Plexi.

Sobre a requisição#

  • Método: POST
  • Endereço: https://api.plexi.com.br/api/maestro/trf3/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
cpfCnpj string Sim CPF ou CNPJ a ser pesquisado.
nome string Não Nome associado ao documento informado
nomeSocial string Não Nome social
abrangencia string Sim Abrangência da certidão. A tabela abaixo apresenta os valores possíveis.
tipo string Sim Tipo da certidão. A tabela abaixo apresenta os valores possíveis.

Valores possíveis para o campo "abrangencia":

Valor Descrição
regional Regional
sjsp Seção Judiciária de São Paulo
sjms Seção Judiciária de Mato Grosso do Sul
trf Tribunal Regional Federal da 3ª Região

Valores possíveis para o campo "tipo":

Valor Descrição
civel Cível
criminal Criminal
eleitoral Para fins eleitorais (apenas CPF)

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
positivo A pessoa ou empresa possui ações na região TRF3
indefinido Não é possível informar se a pessoa ou empresa possui ações na região TRF3
negativo Empresa ou pessoa NÃO está associada a ações na região TRF3

Indefinido

Não é possível informar se a pessoa ou empresa possui ações na região TRF3. Para ter a certidão para esse caso é preciso fazer a solicitação diretamente pelo site.

JSON
{
  "status": "indefinido",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}

Tela referente ao status indefinido

Positivo

JSON
{
  "status": "positivo",
  "numero": "2022/000000000000",
  "codigoSeguranca": "0000000000000000",
  "nome": "FULANO DA SILVA",
  "nomeMae": "SICRANA DE TAL",
  "dataNascimento": "01/01/1990",
  "cpfCnpj": "999.999.999-99",
  "dataHoraEmissao": "01/01/2020 12:00:00",
  "processos": [
    {
      "numero": "9999999-99.2021.4.03.6100",
      "classe": "1116 - EXECUÇÃO FISCAL",
      "situacao": "ANDAMENTO",
      "vara": "6100",
      "juizo": "1ª Vara de Execuções Fiscais Federal Exemplo",
      "tipoParte": "EXECUTADO"
    }
  ],
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}

Negativo

JSON
{
  "status": "negativo",
  "numero": "2022/000000000000",
  "codigoSeguranca": "0000000000000000",
  "nome": "FULANO DA SILVA",
  "nomeMae": "SICRANA DE TAL",
  "dataNascimento": "01/01/1990",
  "cpfCnpj": "999.999.999-99",
  "dataHoraEmissao": "01/01/2020 12:00:00",
  "processos": [],
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}