Baixar Collection

Processos - Escavador Business API - Documentação

Grupo

Processos

Retornar um processo

GET /api/v1/processos/{processoId}
Requer autenticaçãoPaga

Retorna um processo pelo seu identificador no Escavador.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: GET.

URL Parameters

?
processo integer Obrigatório

Identificador numérico do processo no Escavador.

processoId string Obrigatório

Sem descrição

Exemplos de respostas válidas

HTTP 200 ? 
{
    "id": 1,
    "numero_antigo": null,
    "numero_novo": "0000000-00.0000.0.00.0000",
    "is_cnj": 1,
    "enviado_trimon_em": "2022-01-23 12:29:21",
    "created_at": null,
    "updated_at": null,
    "origem_tribunal_id": 16,
    "filtrado_em": null,
    "enviado_nursery_em": null,
    "diario_sigla": "TRT-5",
    "diario_nome": "TRT da 5ª Região (Bahia)",
    "estado": "BA",
    "data_movimentacoes": "30/01/2015 a 24/05/2022",
    "quantidade_movimentacoes": 27,
    "ultimas_movimentacoes_resumo": [
        {
            "id": 1,
            "data": "2022-05-24T00:00:00.000000Z",
            "link_api": "https://api.escavador.com/api/v1/movimentacoes/1",
            "envolvidos_resumo": [
                {
                    "id": 1,
                    "nome": "Elba",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/9923641/elba",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                    "nome_sem_filtro": "Elba",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": null
                }
            ],
            "quantidade_envolvidos": 7,
            "conteudo_resumo": "Conteudo .... "
        }
    ],
    "envolvidos_ultima_movimentacao": [
        {
            "id": 47056,
            "nome": "Elba",
            "objeto_type": "Pessoa",
            "pivot_tipo": "ADVOGADO",
            "pivot_outros": "NAO",
            "pivot_extra_nome": null,
            "link": "https://www.escavador.com/sobre/1/elba",
            "link_api": "https://api.escavador.com/api/v1/pessoas/1",
            "nome_sem_filtro": "Elba",
            "envolvido_tipo": "Advogado",
            "envolvido_extra_nome": "",
            "oab": "00000/BA",
            "advogado_de": null
        }
    ],
    "tipo_ultima_movimentacao": "Ação Trabalhista - Rito Ordinário"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Movimentações de um processo que saíram em Diários Oficiais

GET /api/v1/processos/{processoId}/movimentacoes
Requer autenticaçãoPaga

Retorna as movimentações de um Processo pelo identificador do processo no Escavador.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: GET.

URL Parameters

?
processoId integer Obrigatório

Identificador numérico de um processo no Escavador.

Query Parameters

?
limit integer Opcional

Limita o número dos registros listados. Caso não seja enviado, aplica-se o limite padrão de 20 registros. Limite máximo: 60.

page integer Opcional

Número da página, respeitando o limite informado.

Exemplos de respostas válidas

HTTP 200 ? 
{
    "items": [
        {
            "id": 1,
            "secao": "26<sup>a</sup>. Vara do Trabalho de Salvador",
            "texto_categoria": "<p class=\"content-small \">Rela&#231;&#227;o emitida em 29/01/2015 16:10:20</p><br><p class=\"content-small \">Ficam os Senhores Advogados abaixo mencionados notificados dos</p><br><p class=\"content-small \">ATOS praticados nos processos aos quais est&#227;o vinculados:</p>",
            "diario_oficial_id": 140,
            "processo_id": 1,
            "pagina": null,
            "complemento": null,
            "tipo": "Notificação DJ",
            "subtipo": null,
            "conteudo": "<p class=\"content-small \">-    RECEBER CR&#201;DITO EM 05 DIAS EVITANDO-SE<br>ARQUIVAMENTO. - ADV AUTOR: CARLOS BRUNO CAMPOS<br>ROCHA BOMFIM.</p>",
            "snippet": "- RECEBER CR&#201;DITO EM 05 DIAS EVITANDO-SE ARQUIVAMENTO. - ADV AUTOR: CARLOS BRUNO CAMPOS ROCHA BOMFIM.",
            "data": "2015-01-30",
            "letras_processo": "RTOrd",
            "subprocesso": null,
            "created_at": null,
            "updated_at": null,
            "descricao_pequena": "Movimentação do processo RTOrd-0000000-00.0000.0.00.0000",
            "diario_oficial": "30/01/2015 | TRT-5 - Judiciário",
            "estado": "Bahia",
            "envolvidos": [
                {
                    "id": 2,
                    "nome": "Fulano de Tal",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/1/fulano-de-tal",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                    "nome_sem_filtro": "Fulano de Tal",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": 62
                }
            ],
            "link": "https://www.escavador.com/processos/125060/processo-0000000-0000000000000-do-trt-da-5-regiao?ano=2015#movimentacao-132229",
            "link_api": "https://api.escavador.com/api/v1/movimentacoes/1",
            "link_pdf": null,
            "link_pdf_api": null,
            "data_formatada": "30/01/2015",
            "objeto_type": "Movimentacao",
            "people_filtered": [],
            "diario": {
                "id": 140,
                "origem_id": 8,
                "plugin": "TRT",
                "edicao": "1656/2015",
                "tipo": "Judiciário",
                "tipo_url": "J",
                "data": "2015-01-30",
                "data_disponibilizacao": null,
                "data_publicacao": "2015-01-30",
                "tipo_exibicao": "MOVIMENTACOES",
                "qtd_paginas": null,
                "created_at": "2015-10-14 15:02:24",
                "descricao": "TRT da 5ª Região",
                "objeto_type": "Diario",
                "origem": {
                    "id": 8,
                    "nome": "TRT da 5ª Região",
                    "sigla": "TRT-5",
                    "tipo": null,
                    "db": "JURIDICO",
                    "estado": "BA",
                    "competencia": "Bahia",
                    "categoria": "Tribunais Regionais do Trabalho",
                    "created_at": "2015-10-14T15:02:24.000000Z",
                    "updated_at": "2015-10-14T15:02:24.000000Z"
                }
            }
        }
    ],
    "links": {
        "prev": null,
        "next": null,
        "first": "https://api.escavador.com/api/v1/processos/1/movimentacoes?page=1",
        "last": "https://api.escavador.com/api/v1/processos/1/movimentacoes?page=1"
    },
    "paginator": {
        "current_page": 1,
        "per_page": 20,
        "total": 13,
        "total_pages": 1
    }
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Buscar processos dos Diários Oficiais por OAB

GET /api/v1/oab/{estado}/{numero}/processos
Requer autenticaçãoPaga

Busca processos que estão nos Diários Oficiais do Escavador que estão relacionados ao OAB informado. Como essa busca é feita em cima de dados extraídos das páginas dos Diários Oficiais, não é garantido vir todos os processos da OAB informada.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: GET.

URL Parameters

?
estado string Obrigatório

Sigla do Estado da OAB.

numero string Obrigatório

Número da OAB.

Query Parameters

?
page integer Opcional

Número da página, respeitando o limite informado.

Exemplos de respostas válidas

HTTP 200 ? 
{
    "paginator": {
        "total": 404,
        "total_pages": 21,
        "current_page": 1,
        "per_page": 20
    },
    "links": {
        "prev": null,
        "next": "https://api.escavador.com/api/v1/oab/BA/23267/processos?page=2"
    },
    "items": [
        {
            "id": 1,
            "numero_antigo": "00000/0000-000-00-00.0",
            "numero_novo": "0000000-00.0000.0.00.0000",
            "is_cnj": 1,
            "enviado_trimon_em": "2022-01-23 12:29:21",
            "created_at": null,
            "updated_at": null,
            "origem_tribunal_id": 16,
            "filtrado_em": null,
            "enviado_nursery_em": null,
            "tipo_envolvido": "ADVOGADO",
            "quantidade_movimentacoes_envolvido_faz_parte": 7,
            "taxa_movimentacoes_envolvido_faz_parte": 1,
            "diario_sigla": "TRT-5",
            "diario_nome": "TRT da 5ª Região (Bahia)",
            "estado": "BA",
            "data_movimentacoes": "17/01/2013 a 30/01/2015",
            "quantidade_movimentacoes": 7,
            "envolvidos_ultima_movimentacao": [
                {
                    "id": 2,
                    "nome": "Fulano de tal",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "RECLAMANTE",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/1/fulano-de-tal",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                    "nome_sem_filtro": "Fulano de Tal",
                    "envolvido_tipo": "Reclamante",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": null
                },
                {
                    "id": 3,
                    "nome": "Fulana de Tal",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/2/fulana-de-tal",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/2",
                    "nome_sem_filtro": "Fulana de Tal",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": 31
                }
            ],
            "link": "https://www.escavador.com/processos/1/processo-0000000-0000000000090-do-trt-da-5-regiao",
            "link_api": "https://api.escavador.com/api/v1/processos/1",
            "url": {
                "id": 1,
                "slug": "processo-0000000-0000000000000-do-trt-da-5-regiao",
                "objeto_type": "Processo",
                "objeto_id": 1,
                "redirect": null,
                "created_at": "2022-01-23 12:29:21",
                "anuncio_ocultado_em": null
            }
        },
        {
            "id": 2,
            "numero_antigo": "00000/0000-000-00-00.0",
            "numero_novo": "0000000-00.0000.0.00.0000",
            "is_cnj": 1,
            "enviado_trimon_em": "2022-01-23 12:29:21",
            "created_at": null,
            "updated_at": null,
            "origem_tribunal_id": 16,
            "filtrado_em": null,
            "enviado_nursery_em": null,
            "tipo_envolvido": "ADVOGADO | ADVOGADO | ADVOGADO",
            "quantidade_movimentacoes_envolvido_faz_parte": 13,
            "taxa_movimentacoes_envolvido_faz_parte": 1,
            "diario_sigla": "TRT-5",
            "diario_nome": "TRT da 5ª Região (Bahia)",
            "estado": "BA",
            "data_movimentacoes": "14/11/2012 a 30/01/2015",
            "quantidade_movimentacoes": 13,
            "envolvidos_ultima_movimentacao": [
                {
                    "id": 2,
                    "nome": "Fulano de tal",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "RECLAMANTE",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/1/fulano-de-tal",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                    "nome_sem_filtro": "Fulano de Tal",
                    "envolvido_tipo": "Reclamante",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": null
                },
                {
                    "id": 3,
                    "nome": "Fulana de Tal",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/2/fulana-de-tal",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/2",
                    "nome_sem_filtro": "Fulana de Tal",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "00000/BA",
                    "advogado_de": 31
                }
            ],
            "link": "https://www.escavador.com/processos/125060/processo-0122300-0820095050026-do-trt-da-5-regiao",
            "link_api": "https://api.escavador.com/api/v1/processos/125060",
            "url": {
                "id": 90784449,
                "slug": "processo-0122300-0820095050026-do-trt-da-5-regiao",
                "objeto_type": "Processo",
                "objeto_id": 125060,
                "redirect": null,
                "created_at": "2022-01-23 12:29:21",
                "anuncio_ocultado_em": null
            }
        }
    ]
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Buscar processos dos Diários Oficiais por número

GET /api/v1/processos/numero/{numero}
Requer autenticaçãoPaga

Busca processos que estão nos Diários Oficiais do Escavador e contenham o número único informado.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: GET.

URL Parameters

?
numero string Obrigatório

Número único do processo.

Query Parameters

?
match_exato boolean Opcional

Se match_exato == 1, a busca será feita pelo número inteiro do processo pesquisado. Default: 0.

Exemplos de respostas válidas

HTTP 200 ? 
[
    {
        "id": 1,
        "numero_antigo": null,
        "numero_novo": "0000000-00.0000.0.00.0000",
        "is_cnj": 1,
        "enviado_trimon_em": "2022-01-11 20:33:54",
        "created_at": "2018-10-31 06:29:00",
        "updated_at": "2022-08-09 09:00:22",
        "origem_tribunal_id": 16,
        "filtrado_em": null,
        "enviado_nursery_em": null,
        "diario_sigla": "TRT-5",
        "diario_nome": "TRT da 5ª Região (Bahia)",
        "estado": "BA",
        "data_movimentacoes": "30/10/2018 a 08/08/2022",
        "quantidade_movimentacoes": 20,
        "ultimas_movimentacoes_resumo": [
            {
                "id": 1,
                "data": "2022-08-08T00:00:00.000000Z",
                "link_api": "https://api.escavador.com/api/v1/movimentacoes/1",
                "envolvidos_resumo": [
                    {
                        "id": 1,
                        "nome": "Fulano de Tal",
                        "objeto_type": "Pessoa",
                        "pivot_tipo": "ADVOGADO",
                        "pivot_outros": "NAO",
                        "pivot_extra_nome": null,
                        "link": "https://www.escavador.com/sobre/1/fulano-de-tal",
                        "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                        "nome_sem_filtro": "Fulano de Tal",
                        "envolvido_tipo": "Advogado",
                        "envolvido_extra_nome": "",
                        "oab": "00000/BA",
                        "advogado_de": null
                    }
                ],
                "quantidade_envolvidos": 9,
                "conteudo_resumo": "Conteudo "
            }
        ]
    }
]
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Envolvidos de um Processo que saíram em Diários Oficiais

GET /api/v1/processos/{processoId}/envolvidos
Requer autenticaçãoPaga

Retorna os envolvidos de um Processo pelo identificador do processo no Escavador.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: GET.

URL Parameters

?
processoId integer Obrigatório

Identificador numérico de um Processo.

Query Parameters

?
limit integer Opcional

Limita o número dos registros listados. Caso não seja enviado, aplica-se o limite padrão de 20 registros. Limite máximo: 60.

page integer Opcional

Número da página, respeitando o limite informado.

Exemplos de respostas válidas

HTTP 200 ? 
{
    "paginator": {
        "total": 3,
        "total_pages": 1,
        "current_page": 1,
        "per_page": 20
    },
    "links": {
        "prev": null,
        "next": null
    },
    "items": [
        {
            "id": 2,
            "nome": "Edilson Batista",
            "objeto_type": "Pessoa",
            "link": "https://www.escavador.com/sobre/6/edilson-batista",
            "link_api": "https://api.escavador.com/api/v1/pessoas/6",
            "nome_sem_filtro": "Edilson Batista",
            "envolvido_tipo": "Autor",
            "envolvido_extra_nome": "",
            "oab": "",
            "advogado_de": null
        },
        {
            "id": 5,
            "nome": "Empresa de Refrigerantes - Me",
            "objeto_type": "Instituicao",
            "link": "https://www.escavador.com/sobre/3/empresa-de-refrigerantes-me",
            "link_api": "https://api.escavador.com/api/v1/instituicoes/3",
            "nome_sem_filtro": "Empresa de Refrigerantes - Me",
            "envolvido_tipo": "Réu",
            "envolvido_extra_nome": "",
            "oab": "",
            "advogado_de": null
        },
        {
            "id": 3,
            "nome": "Maria de Souza",
            "objeto_type": "Pessoa",
            "link": "https://www.escavador.com/sobre/8/maria-de-souza",
            "link_api": "https://api.escavador.com/api/v1/pessoas/8",
            "nome_sem_filtro": "Maria de Souza",
            "envolvido_tipo": "Advogado",
            "envolvido_extra_nome": "",
            "oab": "5051/BR",
            "advogado_de": null
        }
    ]
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processos no site do tribunal em lote (assíncrono)

POST /api/v1/tribunal/async/lote
Requer autenticaçãoGrátis

Faz uma busca em todos os tribunais enviados para o tipo de busca escolhido, uma alternativa para a chamadas iguais para diferentes tribunais. A busca é feita diretamente nos sites dos tribunais, pelos robôs do Escavador. O tempo de busca é afetado pelo tempo de resposta dos sites dos tribunais, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Callbacks relacionados

Evento Descrição
resultado_busca_oab_async A busca assíncrona de processos por OAB foi concluída e o usuário marcou a opção de receber por callback.
resultado_busca_documento_async A busca assíncrona de processos por CPF ou CNPJ foi concluída e o usuário marcou a opção de receber por callback.
resultado_busca_nome_async A busca assíncrona de processos pelo nome da parte foi concluída e o usuário marcou a opção de receber por callback.

Body Parameters

?
tipo string Obrigatório

tipo da busca que será realizada, possíveis valores: busca_por_nome, busca_por_documento, busca_por_oab

tribunais array<string> Obrigatório

Siglas dos tribunais onde os valores serão buscados.

nome string Opcional

Se o tipo da busca é busca_por_nome é necessário informar o nome na requisição

numero_documento string Opcional

Se o tipo da busca é busca_por_documento é necessário informar o número do documento na requisição

numero_oab string Opcional

Se o tipo da busca é busca_por_oab é necessário informar o número da oab na requisição

estado_oab string Opcional

Se o tipo da busca é busca_por_oab é necessário informar o estado (UF) da oab na requisição

send_callback integer Opcional

Se send_callback == 1, todas as respostas serão enviadas para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "items": [
        {
            "id": 135,
            "created_at": {
                "date": "2021-10-21 12:50:15.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "enviar_callback": "NAO",
            "link_api": "http://api.escavador.com/api/v1/async/resultados/135",
            "resposta": null,
            "status": "PENDENTE",
            "motivo_erro": null,
            "status_callback": null,
            "tipo": "BUSCA_POR_NOME",
            "opcoes": null,
            "tribunal": {
                "sigla": "TJSP",
                "nome": "Tribunal de Justiça de São Paulo",
                "busca_processo": 1,
                "busca_nome": 1,
                "busca_oab": 1,
                "busca_documento": 1,
                "disponivel_autos": 0,
                "documentos_publicos": 1,
                "quantidade_creditos_busca_processo": 5,
                "quantidade_creditos_busca_nome": 3,
                "quantidade_creditos_busca_documento": 4,
                "quantidade_creditos_busca_oab": 4
            },
            "valor": "Ronaldo"
        },
        {
            "id": 136,
            "created_at": {
                "date": "2021-10-21 12:50:15.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "enviar_callback": "NAO",
            "link_api": "http://api.escavador.com/api/v1/async/resultados/136",
            "resposta": null,
            "status": "PENDENTE",
            "motivo_erro": null,
            "status_callback": null,
            "tipo": "BUSCA_POR_NOME",
            "opcoes": null,
            "tribunal": {
                "sigla": "TJBA",
                "nome": "Tribunal de Justiça da Bahia",
                "busca_processo": 1,
                "busca_nome": 1,
                "busca_oab": 0,
                "busca_documento": 1,
                "disponivel_autos": 0,
                "documentos_publicos": 1,
                "quantidade_creditos_busca_processo": 5,
                "quantidade_creditos_busca_nome": 5,
                "quantidade_creditos_busca_documento": 5,
                "quantidade_creditos_busca_oab": null
            },
            "valor": "Ronaldo"
        },
        {
            "id": 137,
            "created_at": {
                "date": "2021-10-21 12:50:15.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "enviar_callback": "NAO",
            "link_api": "http://api.escavador.com/api/v1/async/resultados/137",
            "resposta": null,
            "status": "PENDENTE",
            "motivo_erro": null,
            "status_callback": null,
            "tipo": "BUSCA_POR_NOME",
            "opcoes": null,
            "tribunal": {
                "sigla": "TJES",
                "nome": "Tribunal de Justiça do Espírito Santo",
                "busca_processo": 1,
                "busca_nome": 1,
                "busca_oab": 1,
                "busca_documento": 0,
                "disponivel_autos": 0,
                "documentos_publicos": 1,
                "quantidade_creditos_busca_processo": 5,
                "quantidade_creditos_busca_nome": null,
                "quantidade_creditos_busca_documento": null,
                "quantidade_creditos_busca_oab": null
            },
            "valor": "Ronaldo"
        },
        {
            "error": "A busca por nome não está disponível em TRF1"
        }
    ]
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processo no site do tribunal (assíncrono)

POST /api/v1/processo-tribunal/{numero}/async
Requer autenticaçãoPaga

A busca é feita diretamente nos sites dos tribunais, pelos robôs do Escavador. O tempo de busca é afetado pelo tempo de resposta dos sites dos tribunais, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Campos no retorno da API

Parâmetro Tipo Descrição
id int Id do resultado da busca.
numero_processo string Numeração do processo.
resposta string Informações do processo.
link_api string Link para consultar o resultado pela API.
status string Status do resultado da busca:
PENDENTE: As informações do processo ainda estão sendo pesquisadas
SUCESSO: As informações do processo já estão disponíveis
ERRO: Não conseguiu coletar as informações do processo
NAO_ENCONTRADO: Não encontrou o processo

Campos do processo na resposta

Campo Tipo Descrição
numero_unico String Número único desse processo.
origem String Tribunal de onde esse processo foi extraido.
instancias Object[] Lista com as informações do processo em cada uma das instâncias do tribunal.
instancias[].instancia String Instância a qual esse objeto representa, note que pode haver mais de um objeto contendo todas as informações abaixo em uma determinada instância.
instancias[].segredo Boolean Determina se o processo está em segredo de justiça. Em caso afirmativo, as informações em seguida serão nulas ou vazias.
instancias[].numero String Número antigo do processo nessa instância.
instancias[].url String URL para o local exato de onde as informações dessa instância foram extraidas.
instancias[].assunto String Assunto da instância do processo.
instancias[].classe String Classe judicial da instância do processo.
instancias[].area String Área do direito do processo. Ex.: Cívil, Criminal, Trabalhista e etc.
instancias[].data_distribuicao String Data que foi distribuido o processo no tribunal. Possui o formato dd/mm/aaaa.
instancias[].orgao_julgador String Orgão julgador da instância do processo.
instancias[].valor_causa String Valor da causa nesta instância.
instancias[].sistema String Sistema eletronico em que essa instância se encontra.
instancias[].dados Object[] Lista de dados arbitrários no cabeçalho dessa instância.
instancias[].dados[].tipo String Não assuma que esse campo sempre tem um determinado valor, o mesmo pode mudar a depender do processo e/ou tribunal.
instancias[].dados[].valor String Não assuma que esse campo sempre tem um determinado valor, o mesmo pode mudar a depender do processo e/ou tribunal.
instancias[].partes Object[] Lista de envolvidos no processo nessa instância.
instancias[].partes[].id Integer Indice de referência, usado no campo advogado_de.
instancias[].partes[].tipo String Tipo do Envolvido.
instancias[].partes[].nome String Nome do Envolvido.
instancias[].partes[].principal Boolean Informa se o envolvido é uma parte principal, por padrão vem o valor true caso não encontre essa informação no tribunal.
instancias[].partes[].advogado_de Integer Contém o id do envolvido o qual o envolvido atual é o advogado, se o envolvido for uma advogado e o tribunal informar a relação envolvido-advogado.
instancias[].partes[].polo String O tipo do polo deste envolvido.
instancias[].documento Object[] Documento de identificação do envolvido.
instancias[].documento[].numero String Numero do documento de identificação do envolvido.
instancias[].documento[].tipo String Tipo do documento de identificação do envolvido. Podendo ser CPF ou CNPJ.
instancias[].documentos_publicos[] Object[] Documentos Públicos relacionados ao processo que são retornados quando o parâmetro documentos_publicos é enviado.
instancias[].movimentacoes Object[] Lista de movimentações do processo, ordenada na ordem em que a movimentação apareceu no tribunal.
instancias[].movimentacoes[].data String Data da movimentação no tribunal. Possui o formato dd/mm/aaaa.
instancias[].movimentacoes[].conteudo String Conteudo da movimentação no tribunal. Pode possuir varias linhas sendo separadas por
.
instancias[].audiencias Object[] Lista de audiências ocorridas.
instancias[].audiencias[].data String Data de uma audiência no tribunal. Possui o formato dd/mm/aaaa.
instancias[].audiencias[].audiencia String Tipo da audiência no tribunal.
instancias[].audiencias[].situacao String A situação da audiência no tribunal.
instancias[].audiencias[].numero_pessoas Integer Numero de pessoas na audiência no tribunal.
instancias[].arquivado Boolean Indica se o processo foi arquivado, em certos casos, essa informação pode não ser obtida, retornando NULL
instancias[].data_arquivamento String Indica a data em que o processo foi arquivado
instancias[].fisico Boolean Indica se o processo é do tipo físico

Callbacks relacionados

Evento Descrição
resultado_processo_async A busca assíncrona do processo foi concluída e o usuário marcou a opção de receber por callback.

URL Parameters

?
processo integer Obrigatório

Numeração única (CNJ) do processo.

numero string Obrigatório

Sem descrição

Body Parameters

?
send_callback integer Opcional

Se send_callback == 1, a resposta será enviada para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

wait integer Opcional

Se wait == 1, a requisição irá durar até 1 minuto e caso consiga as informações do processo nesse tempo, a resposta vem de forma síncrona. Caso passe 2 minutos, se não tiver resposta do processo, o fluxo ocorrerá da forma assíncrona. Default: 0.

autos integer Opcional

Se autos == 1, o Escavador vai trazer também os documentos dos autos do processo no atributo documentos_restritos e é necessário informar usuário e senha ou ter certificado digital cadastrado na API do Escavador Business. Obs: Essa opção aumenta o custo da rota. Importante: A API Escavador atualmente não possui suporte para acesso a autos em tribunais com a seguinte combinação de autenticação: a) usuário e senha; mais b) um segundo fator/multi fator de autenticação (2FA/MFA). Recomendamos verificar os requisitos de autenticação do tribunal específico para garantir o sucesso da solicitação de busca. Default: 0.

documentos_publicos integer Opcional

Se documentos_publicos == 1, o Escavador vai trazer também os documentos públicos do processo no atributo documentos_publicos Obs: Essa opção aumenta o custo da rota. Default: 0.

usuario string Opcional

Se autos == 1, informe o login do advogado cadastrado no tribunal específico.

senha string Opcional

Se autos == 1, informe a senha do advogado cadastrado no tribunal específico. Obs: A senha será encriptada, armazenada durante o download dos autos e deletada após o uso.

origem string Opcional

Sigla da origem do processo (Ex: STJ, STF, SEEU, ...). Esse parâmetro serve para forçar a consulta em uma origem diferente do processo. Atenção: Ao utilizar esse parâmetro a consulta será cobrada mesmo que o processo não seja encontrado.

tipo_numero string Opcional

Se origem == STF é possivel enviar o número de processo no formato de classe e número (Ex: HC 211509) passando tipo_numero == "classe_numero".
Se origem == STJ é possível enviar o número de processo no formato de número de registro (Ex: 2021/0179885-9) passando tipo_numero == "numero_registro".
Atenção: Ao enviar um número do tipo numero_registro remova a barra do número!
Ex: 2021/0179885-9 deve ser enviado como 20210179885-9 .

dias_ultima_atualizacao integer Opcional

Caso a gente possua uma versão antiga do processo em nossa base de dados, você pode informar o número de dias desde a última consulta do processo. Se a última atualização do processo for há menos dias que o informado, retornaremos os dados sem precisar consultar os tribunais e a resposta será mais rápida.

utilizar_certificado integer Opcional

Se utilizar_certificado == 1, e você possui certificados da OAB registrados no Escavador, é possível utilizá-los para realizar buscas em vez de usar credenciais tradicionais (usuário e senha). Default: 0.

certificado_id integer Opcional

Se utilizar_certificado == 1, você pode especificar um certificado registrado para realizar a busca. Se não especificar um, será escolhido aleatoriamente um dos seus certificados.

documentos_especificos string Opcional

Se autos == 1, você pode especificar quais documentos deseja receber.
INICIAIS: Nossos robôs vão baixar somente os documentos da primeira data do processo.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2022-08-15 18:16:24",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "SIM",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000-00.0000.0.00.0000",
    "resposta": null,
    "status": "PENDENTE",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": null,
    "tribunal": {
        "sigla": "TRT-5",
        "nome": "TRT da 5ª Região",
        "busca_processo": 1,
        "busca_nome": 0,
        "busca_oab": 0,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "0000000-00.0000.0.00.0000"
}

Esta resposta representa um retorno utilizando wait

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2023-04-19 14:10:10",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000",
    "resposta": {
        "numero_unico": "0000000-00.0000.0.00.0000",
        "origem": "TJBA",
        "instancias": [
            {
                "url": "https://consultapublicapje.tjba.jus.br/pje/ConsultaPublica/listView.seam",
                "sistema": "PJE",
                "instancia": "PRIMEIRO_GRAU",
                "extra_instancia": "",
                "segredo": false,
                "numero": null,
                "assunto": "DIREITO CIVIL (899) - Obrigações (7681) - Preferências e Privilégios Creditórios",
                "classe": "HABILITAÇÃO (38)",
                "area": null,
                "data_distribuicao": "19/01/2022",
                "orgao_julgador": "1ª V EMPRESARIAL DE SALVADOR",
                "moeda_valor_causa": null,
                "valor_causa": null,
                "arquivado": true,
                "data_arquivamento": "01/09/2022",
                "fisico": null,
                "last_update_time": "19/04/2023 14:12",
                "situacoes": [],
                "dados": [
                    {
                        "tipo": "Processo referência",
                        "valor": "0000000-00.0000.0.00.0000"
                    }
                ],
                "partes": [
                    {
                        "id": 1,
                        "tipo": "REQUERENTE",
                        "nome": "MARIA",
                        "principal": true,
                        "polo": "ATIVO",
                        "documento": {
                            "tipo": "CPF",
                            "numero": "000.000.000-00"
                        }
                    },
                    {
                        "id": 2,
                        "tipo": "ADVOGADO",
                        "nome": "JOAO",
                        "principal": true,
                        "polo": "ATIVO",
                        "documento": {
                            "tipo": "CPF",
                            "numero": "000.000.000-00"
                        },
                        "advogado_de": 1,
                        "oabs": [
                            {
                                "numero": "12345",
                                "uf": "BA"
                            }
                        ]
                    }
                ],
                "movimentacoes": [
                    {
                        "id": 1,
                        "data": "03/12/2022",
                        "conteudo": "Certidão de publicação no DJe (Certidão de publicação no DJe)"
                    },
                    {
                        "id": 12,
                        "data": "24/10/2022",
                        "conteudo": "Decorrido prazo de EMPRESARIAL LTDA - EPP em 27/09/2022 23:59."
                    }
                ],
                "documentos_publicos": [
                    {
                        "posicao_id": 8,
                        "titulo": "Certidão de publicação no DJe (Certidão de publicação no DJe)",
                        "descricao": "",
                        "data": "03/12/2022",
                        "tipo": "DOCUMENTO_PUBLICO",
                        "unique_name": "tjba-PJE",
                        "size": 72503,
                        "is_on_s3": true,
                        "is_compressed": false,
                        "possivel_restrito": false,
                        "paginas": 3,
                        "updated_at": "30/01/2023 23:17:05",
                        "movid": 1,
                        "link_api": "https://api.escavador.com/api/v1/processo-tribunal/documentos-publicos/",
                        "extensao": "pdf"
                    }
                ],
                "audiencias": []
            }
        ]
    },
    "status": "SUCESSO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": {
        "documentos_publicos": true
    },
    "tribunal": {
        "sigla": "TJBA",
        "nome": "Tribunal de Justiça da Bahia",
        "busca_processo": 1,
        "busca_nome": 1,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "0000000-00.0000.0.00.0000"
}

Esta resposta representa um retorno do Callback enviado

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2023-04-19 14:10:10",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000",
    "resposta": {
        "numero_unico": "0000000-00.0000.0.00.0000",
        "origem": "TJBA",
        "instancias": [
            {
                "url": "https://consultapublicapje.tjba.jus.br/pje/ConsultaPublica/listView.seam",
                "sistema": "PJE",
                "instancia": "PRIMEIRO_GRAU",
                "extra_instancia": "",
                "segredo": false,
                "numero": null,
                "assunto": "DIREITO CIVIL (899) - Obrigações (7681) - Preferências e Privilégios Creditórios",
                "classe": "HABILITAÇÃO (38)",
                "area": null,
                "data_distribuicao": "19/01/2022",
                "orgao_julgador": "1ª V EMPRESARIAL DE SALVADOR",
                "moeda_valor_causa": null,
                "valor_causa": null,
                "arquivado": true,
                "data_arquivamento": "01/09/2022",
                "fisico": null,
                "last_update_time": "19/04/2023 14:12",
                "situacoes": [],
                "dados": [
                    {
                        "tipo": "Processo referência",
                        "valor": "0000000-00.0000.0.00.0000"
                    }
                ],
                "partes": [
                    {
                        "id": 1,
                        "tipo": "REQUERENTE",
                        "nome": "MARIA",
                        "principal": true,
                        "polo": "ATIVO",
                        "documento": {
                            "tipo": "CPF",
                            "numero": "000.000.000-00"
                        }
                    },
                    {
                        "id": 2,
                        "tipo": "ADVOGADO",
                        "nome": "JOAO",
                        "principal": true,
                        "polo": "ATIVO",
                        "documento": {
                            "tipo": "CPF",
                            "numero": "000.000.000-00"
                        },
                        "advogado_de": 1,
                        "oabs": [
                            {
                                "numero": "12345",
                                "uf": "BA"
                            }
                        ]
                    }
                ],
                "movimentacoes": [
                    {
                        "id": 1,
                        "data": "03/12/2022",
                        "conteudo": "Certidão de publicação no DJe (Certidão de publicação no DJe)"
                    },
                    {
                        "id": 12,
                        "data": "24/10/2022",
                        "conteudo": "Decorrido prazo de EMPRESARIAL LTDA - EPP em 27/09/2022 23:59."
                    }
                ],
                "documentos_publicos": [
                    {
                        "posicao_id": 8,
                        "titulo": "Certidão de publicação no DJe (Certidão de publicação no DJe)",
                        "descricao": "",
                        "data": "03/12/2022",
                        "tipo": "DOCUMENTO_PUBLICO",
                        "unique_name": "tjba-PJE",
                        "size": 72503,
                        "is_on_s3": true,
                        "is_compressed": false,
                        "possivel_restrito": false,
                        "paginas": 3,
                        "updated_at": "30/01/2023 23:17:05",
                        "movid": 1,
                        "link_api": "https://api.escavador.com/api/v1/processo-tribunal/documentos-publicos/",
                        "extensao": "pdf"
                    }
                ],
                "audiencias": []
            }
        ]
    },
    "status": "SUCESSO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": {
        "documentos_publicos": true
    },
    "tribunal": {
        "sigla": "TJBA",
        "nome": "Tribunal de Justiça da Bahia",
        "busca_processo": 1,
        "busca_nome": 1,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "0000000-00.0000.0.00.0000"
}

Esta resposta representa um retorno do Callback enviado com erro

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2023-04-27 17:35:16",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000-00.0000.0.00.0000",
    "resposta": {
        "message": "Nossos robôs não conseguiram acessar as informações no site do TRF1. Tente novamente mais tarde"
    },
    "status": "ERRO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": {
        "tentativas": 2,
        "documentos_publicos": true
    },
    "tribunal": {
        "sigla": "TRF1",
        "nome": "TRF da 1ª Região",
        "busca_processo": 1,
        "busca_nome": 1,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "0000000-00.0000.0.00.0000"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processos no site do tribunal por nome do envolvido (assíncrono)

POST /api/v1/tribunal/{origem}/busca-por-nome/async
Requer autenticaçãoPaga

A busca é feita diretamente nos sites dos tribunais, pelos robôs do Escavador. O tempo de busca é afetado pelo tempo de resposta dos sites dos tribunais, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Campos no retorno da API

Campo Tipo Descrição
id Integer Id do resultado da busca.
tipo Integer BUSCA_POR_NOME
valor String Nome do envolvido informado.
resposta String Informações dos processos.
link_api String Link para consultar o resultado pela API.
status String Status do resultado da busca:
PENDENTE: As informações ainda estão sendo pesquisadas
SUCESSO: As informações já estão disponíveis
ERRO: Não conseguiu coletar as informações

Callbacks relacionados

Evento Descrição
resultado_busca_nome_async A busca assíncrona de processos pelo nome da parte foi concluída e o usuário marcou a opção de receber por callback.

URL Parameters

?
origem string Obrigatório

Tribunal de origem do processo.

Body Parameters

?
nome string Obrigatório

Nome do envolvido.

permitir_parcial integer Opcional

A busca por nome é feita em todos os sistemas daquele Tribunal (Ex: Esaj, Prodjudi...). Se permitir_parcial == 1 e tiver sucesso apenas em parte dos sistemas pesquisados, a informação será entregue parcialmente. Default: 0.

send_callback integer Opcional

Se send_callback == 1, a resposta será enviada para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2022-08-15 19:52:34",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "resposta": null,
    "status": "PENDENTE",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_POR_NOME",
    "opcoes": null,
    "tribunal": {
        "sigla": "TJSP",
        "nome": "Tribunal de Justiça de São Paulo",
        "busca_processo": 1,
        "busca_nome": 1,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "Fulano de Tal"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processos no site do tribunal por CPF ou CNPJ (assíncrono)

POST /api/v1/tribunal/{origem}/busca-por-documento/async
Requer autenticaçãoPaga

A busca é feita diretamente nos sites dos tribunais, pelos robôs do Escavador. O tempo de busca é afetado pelo tempo de resposta dos sites dos tribunais, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Callbacks relacionados

Evento Descrição
resultado_busca_documento_async A busca assíncrona de processos por CPF ou CNPJ foi concluída e o usuário marcou a opção de receber por callback.

URL Parameters

?
origem string Obrigatório

Sem descrição

Body Parameters

?
numero_documento string Obrigatório

Numeração do documento (CPF ou CNPJ) do envolvido.

permitir_parcial integer Opcional

A busca por nome é feita em todos os sistemas daquele Tribunal (Ex: Esaj, Prodjudi...). Se permitir_parcial == 1 e tiver sucesso apenas em parte dos sistemas pesquisados, a informação será entregue parcialmente. Default: 0.

send_callback integer Opcional

Se send_callback == 1, a resposta será enviada para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2022-08-16 13:05:31",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "resposta": null,
    "status": "PENDENTE",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_POR_DOCUMENTO",
    "opcoes": null,
    "tribunal": {
        "sigla": "TJPA",
        "nome": "Tribunal de Justiça do Pará",
        "busca_processo": 1,
        "busca_nome": 1,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 1,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": 7,
        "quantidade_creditos_busca_documento": 7,
        "quantidade_creditos_busca_oab": 7
    },
    "valor": "00.000.000/0000-00"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processos no site do tribunal por OAB (assíncrono)

POST /api/v1/tribunal/{origem}/busca-por-oab/async
Requer autenticaçãoPaga

A busca é feita diretamente nos sites dos tribunais, pelos robôs do Escavador. O tempo de busca é afetados pelo tempo de resposta dos sites dos tribunais, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Callbacks relacionados

Evento Descrição
resultado_busca_oab_async A busca assíncrona de processos por OAB foi concluída e o usuário marcou a opção de receber por callback.

URL Parameters

?
origem string Obrigatório

Tribunal de origem do processo.

Body Parameters

?
numero_oab string Obrigatório

Número da OAB.

estado_oab string Obrigatório

Sigla do Estado da OAB.

permitir_parcial integer Opcional

A busca por nome é feita em todos os sistemas daquele Tribunal (Ex: Esaj, Prodjudi...). Se permitir_parcial == 1 e tiver sucesso apenas em parte dos sistemas pesquisados, a informação será entregue parcialmente. Default: 0.

send_callback integer Opcional

Se send_callback == 1, a resposta será enviada para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "id": 38,
    "created_at": {
        "date": "2021-09-16 10:44:20.000000",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/38",
    "resposta": null,
    "status": "PENDENTE",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_POR_OAB",
    "opcoes": null,
    "tribunal": {
        "sigla": "TJES",
        "nome": "Tribunal de Justiça do Espírito Santo",
        "busca_processo": 1,
        "busca_nome": 0,
        "busca_oab": 1,
        "busca_documento": 1,
        "disponivel_autos": 0,
        "documentos_publicos": 1,
        "quantidade_creditos_busca_processo": 5,
        "quantidade_creditos_busca_nome": null,
        "quantidade_creditos_busca_documento": null
    },
    "valor": "BA1234"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pesquisar processo administrativo com NUP (assíncrono)

POST /api/v1/processo-administrativo/{numero_nup}/async
Requer autenticaçãoPaga

A busca é feita diretamente nos sites dos órgãos e entidades da Administração Pública federal, pelos robôs do Escavador. O tempo de busca é afetado pelo tempo de resposta dos sites dos órgãos, pela presença de captchas e outros fatores. Como há possibilidade do tempo de resposta ser longo, essa rota funciona de maneira assíncrona. Após solicitar as informações do processo, caso tenha informado, você irá receber um callback (POST) como resultado e também um link para consultar o resultado através do campo link_api.

Visão geral

  • Este endpoint exige autenticação.
  • Método HTTP: POST.

Campos no retorno da API

Parâmetro Tipo Descrição
id int Id do resultado da busca.
numero_processo string Numeração do processo.
resposta string Informações do processo.
link_api string Link para consultar o resultado pela API.
status string Status do resultado da busca:
PENDENTE: As informações do processo ainda estão sendo pesquisadas
SUCESSO: As informações do processo já estão disponíveis
ERRO: Não conseguiu coletar as informações do processo
NAO_ENCONTRADO: Não encontrou o processo

Campos do processo na resposta

Campo Tipo Descrição
numero_unico String Número único desse processo.
numero_alternativo String Número alternativo desse processo.
origem String Origem administrativa de onde esse processo foi extraido.
instancias Object[] Lista com as informações do processo em cada uma das instâncias do tribunal.
instancias[].instancia String Instância a qual esse objeto representa, note que pode haver mais de um objeto contendo todas as informações abaixo em uma determinada instância.
instancias[].segredo Boolean Determina se o processo está em segredo de justiça. Em caso afirmativo, as informações em seguida serão nulas ou vazias.
instancias[].numero String Número antigo do processo nessa instância.
instancias[].url String URL para o local exato de onde as informações dessa instância foram extraidas.
instancias[].assunto String Assunto da instância do processo.
instancias[].classe String Classe judicial da instância do processo.
instancias[].area String Área do direito do processo. Ex.: Cívil, Criminal, Trabalhista e etc.
instancias[].data_distribuicao String Data que foi distribuido o processo no tribunal. Possui o formato dd/mm/aaaa.
instancias[].orgao_julgador String Orgão julgador da instância do processo.
instancias[].valor_causa String Valor da causa nesta instância.
instancias[].sistema String Sistema eletronico em que essa instância se encontra.
instancias[].dados Object[] Lista de dados arbitrários no cabeçalho dessa instância.
instancias[].dados[].tipo String Não assuma que esse campo sempre tem um determinado valor, o mesmo pode mudar a depender do processo e/ou tribunal.
instancias[].dados[].valor String Não assuma que esse campo sempre tem um determinado valor, o mesmo pode mudar a depender do processo e/ou tribunal.
instancias[].partes Object[] Lista de envolvidos no processo nessa instância.
instancias[].partes[].id Integer Indice de referência, usado no campo advogado_de.
instancias[].partes[].tipo String Tipo do Envolvido.
instancias[].partes[].nome String Nome do Envolvido.
instancias[].partes[].principal Boolean Informa se o envolvido é uma parte principal, por padrão vem o valor true caso não encontre essa informação no tribunal.
instancias[].partes[].advogado_de Integer Contém o id do envolvido o qual o envolvido atual é o advogado, se o envolvido for uma advogado e o tribunal informar a relação envolvido-advogado.
instancias[].partes[].polo String O tipo do polo deste envolvido.
instancias[].documento Object[] Documento de identificação do envolvido.
instancias[].documento[].numero String Numero do documento de identificação do envolvido.
instancias[].documento[].tipo String Tipo do documento de identificação do envolvido. Podendo ser CPF ou CNPJ.
instancias[].documentos_publicos[] Object[] Documentos Públicos relacionados ao processo que são retornados quando o parâmetro documentos_publicos é enviado.
instancias[].movimentacoes Object[] Lista de movimentações do processo, ordenada na ordem em que a movimentação apareceu no tribunal.
instancias[].movimentacoes[].data String Data da movimentação no tribunal. Possui o formato dd/mm/aaaa.
instancias[].movimentacoes[].conteudo String Conteudo da movimentação no tribunal. Pode possuir varias linhas sendo separadas por
.
instancias[].audiencias Object[] Lista de audiências ocorridas.
instancias[].audiencias[].data String Data de uma audiência no tribunal. Possui o formato dd/mm/aaaa.
instancias[].audiencias[].audiencia String Tipo da audiência no tribunal.
instancias[].audiencias[].situacao String A situação da audiência no tribunal.
instancias[].audiencias[].numero_pessoas Integer Numero de pessoas na audiência no tribunal.
instancias[].arquivado Boolean Indica se o processo foi arquivado, em certos casos, essa informação pode não ser obtida, retornando NULL
instancias[].data_arquivamento String Indica a data em que o processo foi arquivado
instancias[].fisico Boolean Indica se o processo é do tipo físico

Callbacks relacionados

Evento Descrição
resultado_processo_async A busca assíncrona do processo foi concluída e o usuário marcou a opção de receber por callback.

URL Parameters

?
numero_nup integer Obrigatório

Número único de protocolo (NUP).
Atenção: Ao enviar remova a barra do número!
Ex: 14152.167442/2022-10 deve ser enviado como 14152.167442-2022-10.

Body Parameters

?
send_callback integer Opcional

Se send_callback == 1, a resposta será enviada para a url de callback do usuário, uma alternativa caso não queira ficar consultando o resultado. Default: 0.

wait integer Opcional

Se wait == 1, a requisição irá durar até 1 minuto e caso consiga as informações do processo nesse tempo, a resposta vem de forma síncrona. Caso passe 2 minutos, se não tiver resposta do processo, o fluxo ocorrerá da forma assíncrona. Default: 0.

origem string Opcional

Sigla da origem administrativa do processo (Ex: MTE, ANP, SUSEP, ...).
Atenção: Ao informar a origem diretamente, é possivel enviar o número de processoem outro formato (Ex: 0001-2023).

dias_ultima_atualizacao integer Opcional

Caso a gente possua uma versão antiga do processo em nossa base de dados, você pode informar o número de dias desde a última consulta do processo. Se a última atualização do processo for há menos dias que o informado, retornaremos os dados sem precisar consultar os sistemas e a resposta será mais rápida.

Exemplos de respostas válidas

Esta resposta representa um retorno padrão da requisição

HTTP 200 ? 
{
    "id": 17,
    "created_at": {
        "date": "2024-11-08 19:14:00",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/17",
    "numero_processo": "00000000000000000",
    "resposta": null,
    "status": "PENDENTE",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": {
        "origem": "ANAC"
    },
    "origem_administrativa": {
        "sigla": "ANAC",
        "nome": null,
        "codigo": "00000"
    },
    "valor": "00000000000000000"
}

Esta resposta representa um retorno utilizando wait

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2024-12-08 14:00:10",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "SIM",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000",
    "resposta": {
        "numero_alternativo": "00000000000000000",
        "numero_unico": "00000000000000000",
        "origem": "ANAC",
        "instancias": [
            {
                "url": "https://sei.anac.gov.br/sei/modulos/pesquisa/md_pesq_processo_pesquisar.php?acao_externa=protocolo_pesquisar&acao_origem_externa=protocolo_pesquisar&id_orgao_acesso_externo=0",
                "sistema": "SEI",
                "instancia": "DESCONHECIDA",
                "extra_instancia": "",
                "tipo_precatorio": null,
                "segredo": false,
                "numero": null,
                "numeros_alternativos": [
                    {
                        "numero": "00000000000000000",
                        "tipo": "ALTERNATIVO"
                    }
                ],
                "assunto": "A definir: pendente de alteração pela Unidade",
                "classe": null,
                "area": null,
                "data_distribuicao": "19/05/2021",
                "orgao_julgador": null,
                "moeda_valor_causa": null,
                "valor_causa": null,
                "arquivado": null,
                "data_arquivamento": null,
                "fisico": null,
                "last_update_time": "09/12/2024 14:52",
                "situacoes": [],
                "dados": [],
                "partes": [
                    {
                        "id": 1,
                        "tipo": "Interessado(a)",
                        "nome": "Banco Do Brasil",
                        "principal": true,
                        "polo": null,
                        "documento": {
                            "tipo": null,
                            "numero": null
                        }
                    }
                ],
                "movimentacoes": [
                    {
                        "id": 1,
                        "data": "20/05/2021",
                        "conteudo": "Conclusão do processo na unidade\nUnidade: COFATI-REC"
                    }
                ],
                "documentos_publicos": [],
                "audiencias": []
            }
        ]
    },
    "status": "SUCESSO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": [],
    "origem_administrativa": {
        "sigla": "ANAC",
        "nome": null,
        "codigo": "00000"
    },
    "valor": "00000000000000000"
}

Esta resposta representa um retorno do Callback enviado

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2024-12-08 14:00:10",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "SIM",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "0000000",
    "resposta": {
        "numero_alternativo": "00000000000000000",
        "numero_unico": "00000000000000000",
        "origem": "ANAC",
        "instancias": [
            {
                "url": "https://sei.anac.gov.br/sei/modulos/pesquisa/md_pesq_processo_pesquisar.php?acao_externa=protocolo_pesquisar&acao_origem_externa=protocolo_pesquisar&id_orgao_acesso_externo=0",
                "sistema": "SEI",
                "instancia": "DESCONHECIDA",
                "extra_instancia": "",
                "tipo_precatorio": null,
                "segredo": false,
                "numero": null,
                "numeros_alternativos": [
                    {
                        "numero": "00000000000000000",
                        "tipo": "ALTERNATIVO"
                    }
                ],
                "assunto": "A definir: pendente de alteração pela Unidade",
                "classe": null,
                "area": null,
                "data_distribuicao": "19/05/2021",
                "orgao_julgador": null,
                "moeda_valor_causa": null,
                "valor_causa": null,
                "arquivado": null,
                "data_arquivamento": null,
                "fisico": null,
                "last_update_time": "09/12/2024 14:52",
                "situacoes": [],
                "dados": [],
                "partes": [
                    {
                        "id": 1,
                        "tipo": "Interessado(a)",
                        "nome": "Banco Do Brasil",
                        "principal": true,
                        "polo": null,
                        "documento": {
                            "tipo": null,
                            "numero": null
                        }
                    }
                ],
                "movimentacoes": [
                    {
                        "id": 1,
                        "data": "20/05/2021",
                        "conteudo": "Conclusão do processo na unidade\nUnidade: COFATI-REC"
                    }
                ],
                "documentos_publicos": [],
                "audiencias": []
            }
        ]
    },
    "status": "SUCESSO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": [],
    "origem_administrativa": {
        "sigla": "ANAC",
        "nome": null,
        "codigo": "00000"
    },
    "valor": "00000000000000000"
}

Esta resposta representa um retorno do Callback enviado com erro

HTTP 200 ? 
{
    "id": 1,
    "created_at": {
        "date": "2024-11-08 19:14:00",
        "timezone_type": 3,
        "timezone": "UTC"
    },
    "enviar_callback": "NAO",
    "link_api": "https://api.escavador.com/api/v1/async/resultados/1",
    "numero_processo": "00000000000000000",
    "resposta": {
        "message": "Nossos robôs não conseguiram acessar as informações no site do ANAC. Tente novamente mais tarde"
    },
    "status": "ERRO",
    "motivo_erro": null,
    "status_callback": null,
    "tipo": "BUSCA_PROCESSO",
    "opcoes": {
        "tentativas": 2
    },
    "origem_administrativa": {
        "sigla": "ANAC",
        "nome": null,
        "codigo": "00000"
    },
    "valor": "00000000000000000"
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}