Criar certificado digital

Realiza o upload de um certificado.
Opcionalmente, permite enviar as configurações de 2FA no mesmo request.

Atenção
 Para solicitar os autos de processos via API v2 com certificado digital, pode ser exigida
autenticação multifator (MFA) pelo sistema do Tribunal. Saiba mais nos artigos
Acessando os Autos de Processos via API v2 com Certificado Digital e no  Como obter e cadastrar QR Code para autenticação MFA no escavador

Como preencher

Para preencher corretamente as configurações, consulte as siglas válidas na rota
Listar Tribunais disponíveis e os sistemas compatíveis na rota
Listar Sistemas disponíveis.

O arquivo do certificado digital (.pfx ou .p12).

A senha do certificado.

Lista de configurações de 2FA.

A sigla do tribunal.

Lista com os nomes dos sistemas.

O código secreto do 2FA.

{
    "id": 17,
    "nome": "ANA MARIA",
    "cpf": "11111111111",
    "criado_em": "2025-06-10T13:40:27+00:00",
    "expira_em": "2026-06-10T00:00:00+00:00",
    "autenticacoes": [
        {
            "id": 1,
            "tribunal": "TRF4",
            "sistema": "EPROC",
            "criado_em": "2025-11-28T15:43:21+00:00",
            "atualizado_em": "2025-11-28T15:43:21+00:00"
        },
        {
            "id": 2,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJES",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        },
        {
            "id": 3,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJRJ",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        }
    ]
}

{
    "code": "UNPROCESSABLE_ENTITY",
    "message": "Não foi possível processar a solicitação",
    "errors": [],
    "appends": null
}

Prompt: Explique o endpoint POST /api/v2/certificados, incluindo autenticação, parâmetros e exemplo de resposta.


Listar certificados digitais

Retorna a lista paginada de certificados digitais vinculados à conta da organização.

Filtra os certificados pelo CPF do titular.

{
    "items": [
        {
            "id": 17,
            "nome": "ANA MARIA",
            "cpf": "11111111111",
            "criado_em": "2025-06-10T13:40:27+00:00",
            "expira_em": "2026-06-10T00:00:00+00:00"
        }
    ],
    "links": {
        "next": null,
        "prev": null,
        "first": "https://api.escavador.com/api/v2/certificados?page=1",
        "last": "https://api.escavador.com/api/v2/certificados?page=1"
    },
    "paginator": {
        "current_page": 1,
        "per_page": 20,
        "total": 1,
        "total_pages": 1
    }
}

{
    "error": "Unauthenticated"
}

Prompt: Explique o endpoint GET /api/v2/certificados, incluindo autenticação, parâmetros e exemplo de resposta.


Buscar certificado digital

Retorna os dados detalhados de um certificado específico, incluindo suas configurações de 2FA.

O ID do certificado.

{
    "id": 17,
    "nome": "ANA MARIA",
    "cpf": "11111111111",
    "criado_em": "2025-06-10T13:40:27+00:00",
    "expira_em": "2026-06-10T00:00:00+00:00",
    "autenticacoes": [
        {
            "id": 1,
            "tribunal": "TRF4",
            "sistema": "EPROC",
            "criado_em": "2025-11-28T15:43:21+00:00",
            "atualizado_em": "2025-11-28T15:43:21+00:00"
        },
        {
            "id": 2,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJES",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        },
        {
            "id": 3,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJRJ",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        }
    ]
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/certificados/{id}, incluindo autenticação, parâmetros e exemplo de resposta.


Remover um certificado

Remove o certificado digital e todos as suas configurações de autenticação.

O ID do certificado a ser excluído.

{
    "error": "NotFound"
}

Prompt: Explique o endpoint DELETE /api/v2/certificados/{id}, incluindo autenticação, parâmetros e exemplo de resposta.


Configurar autenticações

Adiciona novas configurações de 2FA ou atualiza a secret de sistemas já vinculados ao certificado.
O que for enviado será criado/atualizado, o que não for enviado será mantido inalterado.

 Para preencher corretamente as configurações, consulte as siglas válidas na rota
 Listar Tribunais disponíveis e os sistemas compatíveis na rota
 Listar Sistemas disponíveis.

O ID do certificado.

Lista de configurações.

A sigla do tribunal.

Lista com os nomes dos sistemas.

O código secreto do 2FA.

{
    "id": 17,
    "nome": "ANA MARIA",
    "cpf": "11111111111",
    "criado_em": "2025-06-10T13:40:27+00:00",
    "expira_em": "2026-06-10T00:00:00+00:00",
    "autenticacoes": [
        {
            "id": 1,
            "tribunal": "TRF4",
            "sistema": "EPROC",
            "criado_em": "2025-11-28T15:43:21+00:00",
            "atualizado_em": "2025-11-28T15:43:21+00:00"
        },
        {
            "id": 2,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJES",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        },
        {
            "id": 3,
            "tribunal": "TRF2",
            "sistema": "EPROC-SJRJ",
            "criado_em": "2025-11-28T17:12:41+00:00",
            "atualizado_em": "2025-11-28T17:12:41+00:00"
        }
    ]
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint POST /api/v2/certificados/{id}/autenticacoes, incluindo autenticação, parâmetros e exemplo de resposta.


Remover uma autenticação

Remove a autenticação de um sistema específico deste certificado.

O ID do certificado.

O ID da autenticação a ser removida.

Prompt: Explique o endpoint DELETE /api/v2/certificados/{id}/autenticacoes/{autenticacaoId}, incluindo autenticação, parâmetros e exemplo de resposta.


Listar Sistemas disponíveis

Retorna a lista de sistemas dos tribunais.

Filtra os sistemas a partir das siglas de tribunais enviadas.

Filtra os sistemas que utilizam certificado digital.

Filtra os sistemas que utilizam autenticação de dois fatores (2FA).

{
    "items": [
        {
            "sistema_nome": "PJE",
            "tribunal_sigla": "CNJ",
            "tribunal_nome": "Conselho Nacional de Justiça",
            "utiliza_certificado_digital": 1,
            "utiliza_2fa": 1
        },
        {
            "sistema_nome": "SITE",
            "tribunal_sigla": "STF",
            "tribunal_nome": "Supremo Tribunal Federal",
            "utiliza_certificado_digital": 0,
            "utiliza_2fa": 0
        },
        {
            "sistema_nome": "ESAJ",
            "tribunal_sigla": "TJAL",
            "tribunal_nome": "Tribunal de Justiça de Alagoas",
            "utiliza_certificado_digital": 0,
            "utiliza_2fa": 0
        },
        {
            "sistema_nome": "PROJUDI",
            "tribunal_sigla": "TJAL",
            "tribunal_nome": "Tribunal de Justiça de Alagoas",
            "utiliza_certificado_digital": 0,
            "utiliza_2fa": 0
        },
        {
            "sistema_nome": "EPROC",
            "tribunal_sigla": "TJRS",
            "tribunal_nome": "Tribunal de Justiça do Rio Grande do Sul",
            "utiliza_certificado_digital": 1,
            "utiliza_2fa": 1
        },
        {
            "sistema_nome": "PJE",
            "tribunal_sigla": "TJRS",
            "tribunal_nome": "Tribunal de Justiça do Rio Grande do Sul",
            "utiliza_certificado_digital": 1,
            "utiliza_2fa": 1
        },
        {
            "sistema_nome": "tucujuris",
            "tribunal_sigla": "TJAP",
            "tribunal_nome": "Tribunal de Justiça do Amapá",
            "utiliza_certificado_digital": 0,
            "utiliza_2fa": 0
        }
    ]
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/tribunais/sistemas, incluindo autenticação, parâmetros e exemplo de resposta.


Consultar saldo

Retorna o saldo atual do usuário na API.

{
    "quantidade_creditos": 99,
    "saldo": 0.99,
    "saldo_descricao": "R$ 0,99"
}

{
    "error": "Unauthenticated"
}

Prompt: Explique o endpoint GET /api/v2/quantidade-creditos, incluindo autenticação, parâmetros e exemplo de resposta.


Solicitar atualização de processos em lote

Solicita a atualização de múltiplos processos nos sistemas dos Tribunais.
Permite definir configurações globais (como download de autos ou uso de credenciais) que serão aplicadas a todos os processos do lote.
Cada processo do lote será validado individualmente. Se um processo já possuir uma atualização recente ou em andamento, ele será identificado na resposta de erro do lote.
A cobrança é realizada individualmente por processo criado.

Lista de objetos contendo os números dos processos.

Se `enviar_callback=1`, um callback será enviado para sua URL configurada para cada processo que concluir a atualização.

Se `documentos_publicos=1`, serão baixados os documentos públicos para todos os processos do lote.

Se `autos=1`, baixa os autos completos dos processos do lote. Requer credenciais (`utilizar_certificado=1` ou `usuario` e `senha`) e não pode ser usado com `documentos_publicos`.

Se `utilizar_certificado=1`, a autenticação das buscas que exigem login será feita com certificado digital.

Se `utilizar_certificado=1`, você pode informar o ID do certificado a ser usado no lote. Se não for informado, um certificado válido cadastrado será selecionado aleatoriamente.

Usuário de acesso utilizado em cada busca aos tribunais deste lote (quando aplicável).

Senha de acesso utilizada em cada busca aos tribunais deste lote (quando aplicável).

Se `ignorar_atualizados=1`, processos com atualização recente ou em andamento são ignorados sem erro individual; o lote só retorna erro se nenhum processo puder ser processado.

{
    "id": 56,
    "status_geral": "PENDENTE",
    "criado_em": "2026-02-10T14:22:25+00:00",
    "total": 3,
    "pendente": 3,
    "sucesso": 0,
    "nao_encontrado": 0,
    "erro": 0,
    "processos": {
        "pendente": [
            {
                "numero_cnj": "08025173520198230010"
            },
            {
                "numero_cnj": "30012639320168060072"
            },
            {
                "numero_cnj": "10300069720158260114"
            }
        ],
        "sucesso": [],
        "nao_encontrado": [],
        "erro": []
    }
}

Esse é um exemplo de resposta de lote criado com sucesso.

{
    "code": "UNPROCESSABLE_ENTITY",
    "message": "Não foi possível processar a solicitação",
    "errors": {
        "processos.0.numero_cnj": [
            "O número do processo não está no formato CNJ."
        ]
    },
    "appends": null
}

Exemplo de erro quando processos do lote possuem formatos inválidos.

{
    "code": "UNPROCESSABLE_ENTITY",
    "message": "Não foi possível processar a solicitação",
    "errors": {
        "0802517-35.2019.8.23.0010": {
            "message": "Esse processo já está sendo atualizado.",
            "appends": {
                "ultima_verificacao": {
                    "id": 519,
                    "status": "NA_FILA",
                    "motivo_erro": null,
                    "criado_em": "2026-02-10T16:01:05+00:00",
                    "numero_cnj": "0802517-35.2019.8.23.0010",
                    "concluido_em": null,
                    "opcoes": [],
                    "enviar_callback": "NAO"
                }
            }
        },
        "3001263-93.2016.8.06.0072": {
            "message": "Esse processo já está sendo atualizado.",
            "appends": {
                "ultima_verificacao": {
                    "id": 520,
                    "status": "NA_FILA",
                    "motivo_erro": null,
                    "criado_em": "2026-02-10T16:01:05+00:00",
                    "numero_cnj": "3001263-93.2016.8.06.0072",
                    "concluido_em": null,
                    "opcoes": [],
                    "enviar_callback": "NAO"
                }
            }
        },
        "1030006-97.2015.8.26.0114": {
            "message": "Esse processo já está sendo atualizado.",
            "appends": {
                "ultima_verificacao": {
                    "id": 455,
                    "status": "NA_FILA",
                    "motivo_erro": null,
                    "criado_em": "2026-02-10T14:22:25+00:00",
                    "numero_cnj": "1030006-97.2015.8.26.0114",
                    "concluido_em": null,
                    "opcoes": [],
                    "enviar_callback": "NAO"
                }
            }
        }
    },
    "appends": null
}

Exemplo de erro quando processos do lote possuem atualizações recentes ou em andamento.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

Prompt: Explique o endpoint POST /api/v2/processos/lote/solicitar-atualizacao, incluindo autenticação, parâmetros e exemplo de resposta.


Status de uma atualização de processos em lote

Retorna o progresso atual de um lote de atualizações solicitado.

Os processos dentro do lote podem assumir diferentes estados individualmente, mas o lote é considerado concluído quando todos os seus processos saírem da fila de processamento.

O identificador único do lote retornado no momento da criação.

{
    "id": 56,
    "status_geral": "FINALIZADO",
    "criado_em": "2026-02-10T14:22:25+00:00",
    "total": 3,
    "pendente": 0,
    "sucesso": 2,
    "nao_encontrado": 0,
    "erro": 1,
    "processos": {
        "pendente": [],
        "sucesso": [
            {
                "numero_cnj": "08025173520198230010"
            },
            {
                "numero_cnj": "30012639320168060072"
            }
        ],
        "nao_encontrado": [],
        "erro": [
            {
                "numero_cnj": "10300069720158260114",
                "motivo": "LOGIN_INVALIDO"
            }
        ]
    }
}

{
    "error": "Unauthenticated"
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/processos/lote/{id}/status, incluindo autenticação, parâmetros e exemplo de resposta.


Processo por numeração CNJ

Retorna dados completos da capa de um processo judicial brasileiro a partir da numeração CNJ.
Este endpoint fornece informações detalhadas da capa, incluindo partes envolvidas, audiências,
dados de todas as fontes (tribunais) onde o processo tramitou, e outras informações relevantes para acompanhamento processual.

Os dados retornados são da base do Escavador. Caso precise de informações mais recentes,
utilize a rota de [solicitar atualização de um processo](/v2/docs/atualizacao-de-processos#solicitar-atualizao-de-um-processo) e,
depois da conclusão, consulte novamente os endpoints do processo.

Número único do processo no formato CNJ. Aceita formatos: `NNNNNNN-DD.AAAA.J.TT.OOOO` ou `NNNNNNNDDAAAAJTTOOOO` (20 dígitos sem formatação).

{
    "numero_cnj": "1024000-20.2015.2.23.0000",
    "titulo_polo_ativo": "Maria da Conceição de Oliveira",
    "titulo_polo_passivo": "João da Silva",
    "ano_inicio": 2015,
    "data_inicio": "2015-11-21",
    "estado_origem": {
        "nome": "São Paulo",
        "sigla": "SP"
    },
    "unidade_origem": {
        "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
        "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
        "classificacao": "JE - Juizado Especial",
        "cidade": "São Paulo",
        "estado": {
            "nome": "São Paulo",
            "sigla": "SP"
        },
        "tribunal_sigla": "TJSP"
    },
    "data_ultima_movimentacao": "2018-07-25",
    "quantidade_movimentacoes": 103,
    "fontes_tribunais_estao_arquivadas": false,
    "data_ultima_verificacao": "2023-02-09T14:30:11+00:00",
    "tempo_desde_ultima_verificacao": "há 1 mês",
    "processos_relacionados": [
        {
            "numero": "8027909-02.2019.8.05.0000"
        },
        {
            "numero": "8028150-73.2019.8.05.0000"
        }
    ],
    "fontes": [
        {
            "id": 3,
            "processo_fonte_id": 14626,
            "descricao": "TJSP - 1º grau",
            "nome": "Tribunal de Justiça de São Paulo",
            "sigla": "TJSP",
            "tipo": "TRIBUNAL",
            "data_inicio": "2015-11-27",
            "data_ultima_movimentacao": "2018-07-25",
            "segredo_justica": null,
            "arquivado": null,
            "status_predito": "INATIVO",
            "grau": 1,
            "grau_formatado": "Primeiro Grau",
            "fisico": false,
            "sistema": "ESAJ",
            "capa": {
                "classe": "PROCEDIMENTO COMUM CIVEL",
                "assunto": "RESPONSABILIDADE CIVIL",
                "assuntos_normalizados": [
                    {
                        "id": 3642,
                        "nome": "Responsabilidade Civil",
                        "nome_com_pai": "DIREITO CIVIL > Responsabilidade Civil",
                        "path_completo": "DIREITO CIVIL > Responsabilidade Civil",
                        "categoria_raiz": "DIREITO CIVIL",
                        "bloqueado": false
                    }
                ],
                "assunto_principal_normalizado": {
                    "id": 3642,
                    "nome": "Responsabilidade Civil",
                    "nome_com_pai": "DIREITO CIVIL > Responsabilidade Civil",
                    "path_completo": "DIREITO CIVIL > Responsabilidade Civil",
                    "categoria_raiz": "DIREITO CIVIL",
                    "bloqueado": false
                },
                "area": "CIVEL",
                "orgao_julgador": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                "orgao_julgador_normalizado": {
                    "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                    "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                    "classificacao": "JE - Juizado Especial",
                    "cidade": "São Paulo",
                    "estado": {
                        "nome": "São Paulo",
                        "sigla": "SP"
                    },
                    "tribunal_sigla": "TJSP"
                },
                "situacao": "Baixado",
                "valor_causa": {
                    "valor": "50000.0000",
                    "moeda": "R$",
                    "valor_formatado": "R$ 50.000,00"
                },
                "data_distribuicao": "2015-11-27",
                "data_arquivamento": null,
                "informacoes_complementares": null
            },
            "audiencias": [
                {
                    "tipo": "Instrução",
                    "data": "2024-10-17",
                    "quantidade_pessoas": 2,
                    "situacao": "Cancelada"
                }
            ],
            "url": "https://esaj.tjsp.jus.br/cpopg/search.do?conversationId=&dadosConsulta.localPesquisa.cdLocal=-1&cbPesquisa=NUMPROC&dadosConsulta.tipoNuProcesso=UNIFICADO&numeroDigitoAnoUnificado=1024000-20.2015&foroNumeroUnificado=0000&dadosConsulta.valorConsultaNuUnificado=1024000-20.2015.2.23.0000&dadosConsulta.valorConsulta=",
            "tribunal": {
                "id": 102,
                "nome": "Tribunal de Justiça de São Paulo",
                "sigla": "TJSP",
                "categoria": null
            },
            "quantidade_movimentacoes": 68,
            "quantidade_envolvidos": 7,
            "data_ultima_verificacao": "2023-02-09T14:30:11+00:00",
            "envolvidos": [
                {
                    "nome": "Maria da Conceição de Oliveira",
                    "quantidade_processos": 1,
                    "tipo_pessoa": "FISICA",
                    "advogados": [
                        {
                            "nome": "Marta Brandao de Oliveira",
                            "quantidade_processos": 21,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Marta Brandao de Oliveira",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        },
                        {
                            "nome": "Fernando Marçal",
                            "quantidade_processos": 10,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Fernando Marçal",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        }
                    ],
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "REQUERENTE",
                    "tipo_normalizado": "Requerente",
                    "polo": "ATIVO",
                    "cpf": "00000000000",
                    "nome_normalizado": "Maria da Conceição de Oliveira"
                },
                {
                    "nome": "Joao da Silva",
                    "quantidade_processos": 97,
                    "tipo_pessoa": "FISICA",
                    "advogados": [
                        {
                            "nome": "Antonio Carlos de Souza",
                            "quantidade_processos": 37,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Antonio Carlos de Souza",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        },
                        {
                            "nome": "Fabiane Santos Carvalho",
                            "quantidade_processos": 33,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Fabiane Santos Carvalho",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        }
                    ],
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "REQUERIDO",
                    "tipo_normalizado": "Requerido",
                    "polo": "PASSIVO",
                    "cpf": "00000000000",
                    "nome_normalizado": "Joao da Silva"
                },
                {
                    "nome": "Marcos Tira Teima",
                    "quantidade_processos": 126,
                    "tipo_pessoa": "FISICA",
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "JUIZ",
                    "tipo_normalizado": "Juiz",
                    "polo": "NENHUM"
                }
            ]
        },
        {
            "id": 6,
            "processo_fonte_id": 14566,
            "descricao": "TJSP - 2º grau",
            "nome": "Tribunal de Justiça de São Paulo",
            "sigla": "TJSP",
            "tipo": "TRIBUNAL",
            "data_inicio": "2017-06-01",
            "data_ultima_movimentacao": "2018-04-26",
            "segredo_justica": null,
            "arquivado": null,
            "status_predito": "INATIVO",
            "grau": 2,
            "grau_formatado": "Segundo Grau",
            "fisico": false,
            "sistema": "ESAJ",
            "capa": {
                "classe": "APELACAO CIVEL",
                "assunto": "DIREITO CIVIL-RESPONSABILIDADE CIVIL-INDENIZACAO POR DANO MORAL",
                "assuntos_normalizados": [
                    {
                        "id": 3644,
                        "nome": "Indenização por Dano Moral",
                        "nome_com_pai": "Responsabilidade Civil > Indenização por Dano Moral",
                        "path_completo": "DIREITO CIVIL > Responsabilidade Civil > Indenização por Dano Moral",
                        "categoria_raiz": "DIREITO CIVIL",
                        "bloqueado": false
                    }
                ],
                "assunto_principal_normalizado": {
                    "id": 3644,
                    "nome": "Indenização por Dano Moral",
                    "nome_com_pai": "Responsabilidade Civil > Indenização por Dano Moral",
                    "path_completo": "DIREITO CIVIL > Responsabilidade Civil > Indenização por Dano Moral",
                    "categoria_raiz": "DIREITO CIVIL",
                    "bloqueado": false
                },
                "area": "CIVEL",
                "orgao_julgador": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                "orgao_julgador_normalizado": {
                    "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                    "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                    "classificacao": "JE - Juizado Especial",
                    "cidade": "São Paulo",
                    "estado": {
                        "nome": "São Paulo",
                        "sigla": "SP"
                    },
                    "tribunal_sigla": "TJSP"
                },
                "situacao": "Baixado",
                "valor_causa": {
                    "valor": "50000.0000",
                    "moeda": "R$",
                    "valor_formatado": "R$ 50.000,00"
                },
                "data_distribuicao": "2017-06-01",
                "data_arquivamento": null,
                "informacoes_complementares": null
            },
            "audiencias": [],
            "url": "https://esaj.tjsp.jus.br/cposg/search.do?conversationId=&paginaConsulta=0&cbPesquisa=NUMPROC&numeroDigitoAnoUnificado=1024000-20.2015&foroNumeroUnificado=0000&dePesquisaNuUnificado=1024000-20.2015.8.22.0000&dePesquisaNuUnificado=UNIFICADO&dePesquisa=&tipoNuProcesso=UNIFICADO&uuidCaptcha=sajcaptcha_e6c6a295c5404a6887d81483bdd96048&g-recaptcha-response=",
            "tribunal": {
                "id": 102,
                "nome": "Tribunal de Justiça de São Paulo",
                "sigla": "TJSP",
                "categoria": null
            },
            "quantidade_movimentacoes": 35,
            "quantidade_envolvidos": 7,
            "data_ultima_verificacao": "2023-02-09T14:30:00+00:00",
            "envolvidos": [
                {
                    "nome": "Maria da Conceição de Oliveira",
                    "quantidade_processos": 1,
                    "tipo_pessoa": "FISICA",
                    "advogados": [
                        {
                            "nome": "Fabiane Santos Carvalho",
                            "quantidade_processos": 21,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Fabiane Santos Carvalho",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        },
                        {
                            "nome": "Antonio Carlos de Souza",
                            "quantidade_processos": 10,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Antonio Carlos de Souza",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        }
                    ],
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "APELANTE",
                    "tipo_normalizado": "Apelante",
                    "polo": "ATIVO",
                    "cpf": "00000000000",
                    "nome_normalizado": "Maria da Conceicao de Oliveira"
                },
                {
                    "nome": "Joao da Silva",
                    "quantidade_processos": 97,
                    "tipo_pessoa": "FISICA",
                    "advogados": [
                        {
                            "nome": "",
                            "quantidade_processos": 37,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Marta Brandao de Oliveira",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        },
                        {
                            "nome": "Fernando Marçal",
                            "quantidade_processos": 33,
                            "tipo_pessoa": "FISICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "ADVOGADO",
                            "tipo_normalizado": "Advogado",
                            "polo": "ADVOGADO",
                            "cpf": "00000000000",
                            "nome_normalizado": "Fernando Marçal",
                            "oabs": [
                                {
                                    "uf": "SP",
                                    "tipo": "ADVOGADO",
                                    "numero": 123123
                                }
                            ]
                        }
                    ],
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "APELADO",
                    "tipo_normalizado": "Apelado",
                    "polo": "PASSIVO",
                    "cpf": "00000000000",
                    "nome_normalizado": "Joao da Silva"
                },
                {
                    "nome": "Ronaldo de Assis",
                    "quantidade_processos": 86,
                    "tipo_pessoa": "FISICA",
                    "prefixo": null,
                    "sufixo": null,
                    "tipo": "RELATOR",
                    "tipo_normalizado": "Juiz",
                    "polo": "NENHUM",
                    "cpf": "00000000000",
                    "nome_normalizado": "Ronaldo de Assis"
                }
            ]
        }
    ]
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/processos/numero_cnj/{numero}, incluindo autenticação, parâmetros e exemplo de resposta.


Movimentações de um processo

Retorna as movimentações de um processo a partir do número CNJ a partir dos dados já indexados no Escavador.

Uma movimentação é cada andamento/evento registrado no histórico processual por uma fonte (tribunal ou diário oficial),
como por exemplo: distribuição, conclusão, juntada de petição/documento, publicação, despacho,
decisão, sentença, baixa ou arquivamento. Em geral, cada item representa uma alteração relevante
no estado do processo ao longo do tempo.

Para obter movimentações mais recentes, solicite antes uma atualização do processo em [solicitar atualização de um processo](/v2/docs/atualizacao-de-processos#solicitar-atualizao-de-um-processo).

Acesse a [página de respostas](/v2/docs/respostas#estrutura-movimentao) para detalhes sobre os dados retornados.

Quantidade de movimentações por página. Pode ser 20, 50 ou 100.
 OBS: Se limit não for informado, o valor padrão retornado será 20.

Ordenação das movimentações por data. Valores aceitos: `asc` ou `desc`. Padrão: `desc`.

{
    "items": [
        {
            "id": 853879,
            "data": "2018-07-25",
            "tipo": "ANDAMENTO",
            "conteudo": "CERTIDAO DE CARTORIO EXPEDIDA",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853877,
            "data": "2018-07-25",
            "tipo": "ANDAMENTO",
            "conteudo": "CERTIDAO DE CARTORIO EXPEDIDA",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853875,
            "data": "2018-07-25",
            "tipo": "ANDAMENTO",
            "conteudo": "ARQUIVADO DEFINITIVAMENTE",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853881,
            "data": "2018-06-05",
            "tipo": "ANDAMENTO",
            "conteudo": "SUSPENSAO DO PRAZO",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853883,
            "data": "2018-06-02",
            "tipo": "ANDAMENTO",
            "conteudo": "SUSPENSAO DO PRAZO",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853885,
            "data": "2018-05-24",
            "tipo": "ANDAMENTO",
            "conteudo": "CERTIDAO DE PUBLICACAO EXPEDIDA",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853887,
            "data": "2018-05-23",
            "tipo": "ANDAMENTO",
            "conteudo": "REMETIDO AO DJE",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853889,
            "data": "2018-05-10",
            "tipo": "ANDAMENTO",
            "conteudo": "PROFERIDO DESPACHO",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853896,
            "data": "2018-05-04",
            "tipo": "ANDAMENTO",
            "conteudo": "DECISAO DE 2ª INSTANCIA - RECURSO NAO PROVIDO - JUNTADA",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853895,
            "data": "2018-05-04",
            "tipo": "ANDAMENTO",
            "conteudo": "EMBARGOS DE DECLARACAO ACOLHIDOS",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853893,
            "data": "2018-05-04",
            "tipo": "ANDAMENTO",
            "conteudo": "TRANSITO EM JULGADO AS PARTES - PROC. EM ANDAMENTO",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853891,
            "data": "2018-05-04",
            "tipo": "ANDAMENTO",
            "conteudo": "CONCLUSOS PARA DESPACHO",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 853897,
            "data": "2018-04-26",
            "tipo": "ANDAMENTO",
            "conteudo": "RECEBIDOS OS AUTOS DO TRIBUNAL DE JUSTICA",
            "fonte": {
                "fonte_id": 3,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 1,
                "grau_formatado": "Primeiro Grau"
            }
        },
        {
            "id": 849990,
            "data": "2018-04-26",
            "tipo": "ANDAMENTO",
            "conteudo": "EXPEDIDO CERTIDAO",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849988,
            "data": "2018-04-26",
            "tipo": "ANDAMENTO",
            "conteudo": "BAIXA DEFINITIVA",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849986,
            "data": "2018-04-26",
            "tipo": "ANDAMENTO",
            "conteudo": "EXPEDIDO CERTIDAO DE BAIXA DE RECURSO",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849992,
            "data": "2018-03-28",
            "tipo": "ANDAMENTO",
            "conteudo": "EXPEDIDO CERTIDAO",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849994,
            "data": "2018-03-26",
            "tipo": "ANDAMENTO",
            "conteudo": "JULGADO VIRTUALMENTE",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849998,
            "data": "2018-03-06",
            "tipo": "ANDAMENTO",
            "conteudo": "EXPEDIDO CERTIDAO",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        },
        {
            "id": 849996,
            "data": "2018-03-06",
            "tipo": "ANDAMENTO",
            "conteudo": "CONCLUSOS PARA O RELATOR (EXPEDIDO TERMO COM CONCLUSAO)",
            "fonte": {
                "fonte_id": 6,
                "nome": "Tribunal de Justiça de São Paulo",
                "tipo": "TRIBUNAL",
                "sigla": "TJSP",
                "grau": 2,
                "grau_formatado": "Segundo Grau"
            }
        }
    ],
    "links": {
        "next": "https://api.escavador.com/api/v2/processos/numero_cnj/1024000-20.2015.8.22.0000/movimentacoes?cursor=eyJkYXRhIjoiMjAxOC0wMy0wNiAwMDowMDowMCIsIm1vdmltZW50YWNhb19pZCI6ODQ5OTk2LCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9&li=216029777"
    },
    "paginator": {
        "per_page": 20
    }
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

{
    "code": "NUMERO_CNJ_INVALIDO",
    "message": "O número do processo não está no formato CNJ.",
    "errors": null,
    "appends": null
}

Prompt: Explique o endpoint GET /api/v2/processos/numero_cnj/{numero}/movimentacoes, incluindo autenticação, parâmetros e exemplo de resposta.


Processos do envolvido por Nome ou CPF/CNPJ

Retorna os processos de um envolvido a partir do nome ou CPF/CNPJ.

Ao buscar processos pelo CPF, pode ocorrer da pessoa em questão possuir homônimos, o que torna o nome do CPF informado não único no Brasil.
Além disso, se os processos em que essa pessoa esteja envolvida não possuírem o CPF informado nos sistemas dos Tribunais, os resultados podem não ser retornados.
Nesse caso, é recomendável realizar a busca pelo nome da parte e filtrar pelo estado da pessoa, o que cobre a grande maioria dos casos.
Para saber mais sobre o algoritmo de matching, acesse a página da Central de Ajuda.

Acesse a [página de respostas](/v2/docs/respostas#estrutura-processo) para detalhes sobre os dados retornados.

Na busca por CPF, o `envolvido_encontrado` também inclui dados cadastrais da pessoa: as inscrições na OAB (`oabs`) e as participações societárias em empresas (`participacoes_societarias`).
Na busca por CNPJ, inclui o quadro societário da empresa (`quadro_societario`).

Nome do envolvido. <b>Obrigatório</b> se `cpf_cnpj` não for enviado.

CPF/CNPJ do envolvido. <b>Obrigatório</b> se `nome` não for enviado.

Ordenação dos processos de acordo com datas. Pode ser `data_ultima_movimentacao` ou `data_inicio` <br>Default: `data_inicio`.

Ordem dos items na resposta com base na data de início do processo. Pode ser `asc` ou `desc` <br>Default: `desc`.

Quantidade de processos por página. Pode ser 20, 50 ou 100.

Filtra processos a partir das siglas de tribunais enviadas.

Inclui processos de envolvidos do mesmo nome que não identificamos o CPF. Disponível apenas para busca por CPF <br>Default: `false`.

Filtra processos a partir do polo do envolvido. Pode ser `ATIVO`, `PASSIVO`, `ADVOGADO` ou `OUTROS`.

Filtra processos a partir do status do processo, pode ser `ATIVO` ou `INATIVO`. Obs. A classificação do status é feito por IA e vai considerar a última atualização que possuímos do processo na nossa base.

Filtra processos que iniciaram após a data informada. A data deve ser estar no formato AAAA-MM-DD.

Filtra processos que iniciaram antes da data informada. A data deve ser estar no formato AAAA-MM-DD e, caso a data minima seja enviada, deve ser maior que a data minima.

Filtra processos pelos códigos da Tabela Processual Unificada do CNJ. Aceita múltiplos códigos. Os códigos disponíveis podem ser consultados na rota [listar assuntos](/v2/docs/assuntos#listar-assuntos).

Filtra processos que contenham os envolvidos relacionados especificados. Aceita uma lista com até 50 nomes.

{
    "envolvido_encontrado": {
        "nome": "Engenharia e Construcoes Ltda",
        "outros_nomes": [],
        "tipo_pessoa": "JURIDICA",
        "quantidade_processos": 2,
        "cpfs_com_esse_nome": 0,
        "oabs": [],
        "participacoes_societarias": [],
        "quadro_societario": [
            {
                "nome": "Joao da Silva",
                "documento": "12345678900",
                "tipo_documento": "CPF",
                "qualificacao_socio": "Sócio-Administrador",
                "data_entrada_sociedade": "2015-06-01",
                "data_saida_sociedade": null
            }
        ],
        "quantidade_processos_retornados": 2
    },
    "items": [
        {
            "numero_cnj": "1060225-21.2023.5.56.0002",
            "titulo_polo_ativo": "Joao da Silva",
            "titulo_polo_passivo": "Empresa de Engenharia e outros",
            "ano_inicio": 2023,
            "data_inicio": "2023-03-11",
            "estado_origem": {
                "nome": "São Paulo",
                "sigla": "SP"
            },
            "unidade_origem": {
                "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                "classificacao": "JE - Juizado Especial",
                "cidade": "São Paulo",
                "estado": {
                    "nome": "São Paulo",
                    "sigla": "SP"
                },
                "tribunal_sigla": "TJSP"
            },
            "data_ultima_movimentacao": "2023-03-11",
            "quantidade_movimentacoes": 2,
            "fontes_tribunais_estao_arquivadas": false,
            "data_ultima_verificacao": "2023-03-14T19:00:14+00:00",
            "tempo_desde_ultima_verificacao": "há 15 minutos",
            "processos_relacionados": [
                {
                    "numero": "8027909-02.2019.8.05.0000"
                },
                {
                    "numero": "8028150-73.2019.8.05.0000"
                }
            ],
            "match_documento_por": "DOCUMENTO_TRIBUNAL",
            "fontes": [
                {
                    "id": 47,
                    "processo_fonte_id": 1048903,
                    "descricao": "TRT-2 - 1º grau",
                    "nome": "Tribunal Regional do Trabalho da 2ª Região",
                    "sigla": "TRT-2",
                    "tipo": "TRIBUNAL",
                    "data_inicio": "2023-03-11",
                    "data_ultima_movimentacao": "2023-03-11",
                    "segredo_justica": false,
                    "arquivado": null,
                    "status_predito": "ATIVO",
                    "grau": 1,
                    "grau_formatado": "Primeiro Grau",
                    "fisico": false,
                    "sistema": "PJE",
                    "capa": {
                        "classe": "ACAO TRABALHISTA - RITO ORDINARIO",
                        "assunto": "SALARIO POR FORA - INTEGRACAO",
                        "assuntos_normalizados": [
                            {
                                "id": 6870,
                                "nome": "Horas Extras",
                                "nome_com_pai": "Duração do Trabalho > Horas Extras",
                                "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Duração do Trabalho > Horas Extras",
                                "categoria_raiz": "DIREITO DO TRABALHO",
                                "bloqueado": false
                            },
                            {
                                "id": 7041,
                                "nome": "Salário por Fora - Integração",
                                "nome_com_pai": "Salário/Diferença Salarial > Salário por Fora - Integração",
                                "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Verbas Remuneratórias, Indenizatórias e Benefícios > Salário/Diferença Salarial > Salário por Fora - Integração",
                                "categoria_raiz": "DIREITO DO TRABALHO",
                                "bloqueado": false
                            }
                        ],
                        "assunto_principal_normalizado": {
                            "id": 7041,
                            "nome": "Salário por Fora - Integração",
                            "nome_com_pai": "Salário/Diferença Salarial > Salário por Fora - Integração",
                            "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Verbas Remuneratórias, Indenizatórias e Benefícios > Salário/Diferença Salarial > Salário por Fora - Integração",
                            "categoria_raiz": "DIREITO DO TRABALHO",
                            "bloqueado": false
                        },
                        "area": "TRABALHISTA",
                        "orgao_julgador": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                        "orgao_julgador_normalizado": {
                            "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                            "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                            "classificacao": "JE - Juizado Especial",
                            "cidade": "São Paulo",
                            "estado": {
                                "nome": "São Paulo",
                                "sigla": "SP"
                            },
                            "tribunal_sigla": "TJSP"
                        },
                        "situacao": "Baixado",
                        "valor_causa": {
                            "valor": "310455.6100",
                            "moeda": "R$",
                            "valor_formatado": "R$ 310.455,61"
                        },
                        "data_distribuicao": "2023-03-11",
                        "data_arquivamento": null,
                        "informacoes_complementares": null
                    },
                    "url": "https://pje.trt2.jus.br/consultaprocessual/detalhe-processo/10003246720235020007",
                    "tribunal": {
                        "id": 13,
                        "nome": "Tribunal Regional do Trabalho da 2ª Região",
                        "sigla": "TRT-2",
                        "categoria": null
                    },
                    "quantidade_movimentacoes": 2,
                    "data_ultima_verificacao": "2023-03-14T19:00:14+00:00",
                    "match_documento_por": "DOCUMENTO_TRIBUNAL",
                    "envolvidos": [
                        {
                            "nome": "Joao da Silva",
                            "quantidade_processos": 1,
                            "tipo_pessoa": "FISICA",
                            "advogados": [
                                {
                                    "nome": "Paulo Roberto de Oliveira",
                                    "quantidade_processos": 3,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "SP",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                },
                                {
                                    "nome": "Daniel Felipe Assis",
                                    "quantidade_processos": 8,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "oabs": [
                                        {
                                            "uf": "SP",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                }
                            ],
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMANTE",
                            "tipo_normalizado": "Reclamante",
                            "polo": "ATIVO",
                            "cpf": "00000000000"
                        },
                        {
                            "nome": "Empresa de Engenharia e outros",
                            "quantidade_processos": 2,
                            "tipo_pessoa": "JURIDICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMADO",
                            "tipo_normalizado": "Reclamado",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        },
                        {
                            "nome": "Empresa de Construcoes",
                            "quantidade_processos": 2,
                            "tipo_pessoa": "JURIDICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMADO",
                            "tipo_normalizado": "Reclamado",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        },
                        {
                            "nome": "Engenharia e Construcoes Ltda",
                            "quantidade_processos": 66,
                            "tipo_pessoa": "JURIDICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMADO",
                            "tipo_normalizado": "Reclamado",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        },
                        {
                            "nome": "Construtora e Incorporadora Ltda",
                            "quantidade_processos": 1,
                            "tipo_pessoa": "JURIDICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMADO",
                            "tipo_normalizado": "Reclamado",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        }
                    ]
                }
            ]
        },
        {
            "numero_cnj": "0205615-29.2023.3.12.0026",
            "titulo_polo_ativo": "Maria Almeida Sampaio",
            "titulo_polo_passivo": "Engenharia e Construcoes Ltda",
            "ano_inicio": 2023,
            "data_inicio": "2023-03-10",
            "data_ultima_movimentacao": "2023-03-10",
            "quantidade_movimentacoes": 2,
            "fontes_tribunais_estao_arquivadas": false,
            "data_ultima_verificacao": "2023-03-14T19:00:14+00:00",
            "tempo_desde_ultima_verificacao": "há 15 minutos",
            "match_documento_por": "NOME_EXATO_UNICO",
            "fontes": [
                {
                    "id": 355,
                    "processo_fonte_id": 1048904,
                    "descricao": "TRT-20 - 1º grau",
                    "nome": "Tribunal Regional do Trabalho da 20ª Região",
                    "sigla": "TRT-20",
                    "tipo": "TRIBUNAL",
                    "data_inicio": "2023-03-10",
                    "data_ultima_movimentacao": "2023-03-10",
                    "segredo_justica": false,
                    "arquivado": null,
                    "grau": 1,
                    "grau_formatado": "Primeiro Grau",
                    "fisico": false,
                    "sistema": "PJE",
                    "capa": {
                        "classe": "ACAO TRABALHISTA - RITO ORDINARIO",
                        "assunto": "ISONOMIA/DIFERENCA SALARIAL",
                        "assuntos_normalizados": [
                            {
                                "id": 6793,
                                "nome": "isonomia/Diferença Salarial",
                                "nome_com_pai": "Enquadramento > isonomia/Diferença Salarial",
                                "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Categoria Profissional Especial > Bancários > Enquadramento > isonomia/Diferença Salarial",
                                "categoria_raiz": "DIREITO DO TRABALHO",
                                "bloqueado": false
                            },
                            {
                                "id": 6978,
                                "nome": "Adicional de Periculosidade",
                                "nome_com_pai": "Adicional > Adicional de Periculosidade",
                                "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Verbas Remuneratórias, Indenizatórias e Benefícios > Adicional > Adicional de Periculosidade",
                                "categoria_raiz": "DIREITO DO TRABALHO",
                                "bloqueado": false
                            }
                        ],
                        "assunto_principal_normalizado": {
                            "id": 6793,
                            "nome": "isonomia/Diferença Salarial",
                            "nome_com_pai": "Enquadramento > isonomia/Diferença Salarial",
                            "path_completo": "DIREITO DO TRABALHO > Direito Individual do Trabalho  > Categoria Profissional Especial > Bancários > Enquadramento > isonomia/Diferença Salarial",
                            "categoria_raiz": "DIREITO DO TRABALHO",
                            "bloqueado": false
                        },
                        "area": "TRABALHISTA",
                        "orgao_julgador": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                        "orgao_julgador_normalizado": {
                            "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                            "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                            "classificacao": "JE - Juizado Especial",
                            "cidade": "São Paulo",
                            "estado": {
                                "nome": "São Paulo",
                                "sigla": "SP"
                            },
                            "tribunal_sigla": "TJSP"
                        },
                        "valor_causa": {
                            "valor": "292319.7200",
                            "moeda": "R$",
                            "valor_formatado": "R$ 292.319,72"
                        },
                        "data_distribuicao": "2023-03-10",
                        "data_arquivamento": null,
                        "informacoes_complementares": null
                    },
                    "url": "https://pje.trt20.jus.br/consultaprocessual/detalhe-processo/00002054020235200002",
                    "tribunal": {
                        "id": 31,
                        "nome": "Tribunal Regional do Trabalho da 20ª Região",
                        "sigla": "TRT-20",
                        "categoria": null
                    },
                    "quantidade_movimentacoes": 2,
                    "data_ultima_verificacao": "2023-03-14T19:00:14+00:00",
                    "match_documento_por": "NOME_EXATO_UNICO",
                    "envolvidos": [
                        {
                            "nome": "Maria Almeida Sampaio",
                            "quantidade_processos": 1,
                            "tipo_pessoa": "FISICA",
                            "advogados": [
                                {
                                    "nome": "Petrucio Silveira",
                                    "quantidade_processos": 16,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "SE",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                },
                                {
                                    "nome": "Kevin Correia Borges",
                                    "quantidade_processos": 8,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "SE",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                }
                            ],
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMANTE",
                            "tipo_normalizado": "Reclamante",
                            "polo": "ATIVO",
                            "cpf": "00000000000"
                        },
                        {
                            "nome": "Engenharia e Construcoes Ltda",
                            "quantidade_processos": 66,
                            "tipo_pessoa": "JURIDICA",
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "RECLAMADO",
                            "tipo_normalizado": "Reclamado",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        }
                    ]
                }
            ]
        }
    ],
    "links": {
        "next": "https://api.escavador.com/api/v2/envolvido/processos?nome=Joao%20da%20Silva&cursor=eyJwcm9jZXNzby5kYXRhX2luaWNpbyI6IjIwMjItMDctMDUgMDA6MDA6MDAiLCJwcm9jZXNzby5pZCI6MTEwNjg3NSwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ&li=216025845"
    },
    "paginator": {
        "per_page": 20
    }
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/envolvido/processos, incluindo autenticação, parâmetros e exemplo de resposta.


Resumo de Processos do envolvido por Nome ou CPF/CNPJ

Retorna a quantidade de processos de um envolvido a partir do nome ou CPF/CNPJ.

Na busca por CPF, a resposta também inclui dados cadastrais da pessoa: as inscrições na OAB (`oabs`) e as participações societárias em empresas (`participacoes_societarias`).
Na busca por CNPJ, inclui o quadro societário da empresa (`quadro_societario`).

{
    "nome": "Empresa Fantasia S.A",
    "tipo_pessoa": "JURIDICA",
    "quantidade_processos": 3516803,
    "oabs": [],
    "participacoes_societarias": [],
    "quadro_societario": [
        {
            "nome": "Joao da Silva",
            "documento": "12345678900",
            "tipo_documento": "CPF",
            "qualificacao_socio": "Sócio-Administrador",
            "data_entrada_sociedade": "2015-06-01",
            "data_saida_sociedade": null
        }
    ]
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/envolvido/resumo, incluindo autenticação, parâmetros e exemplo de resposta.


Estatísticas do envolvido por Nome ou CPF/CNPJ

Retorna um resumo agregado dos processos vinculados ao envolvido encontrado.

A resposta é dividida em três blocos principais:
`envolvido_encontrado`, com os dados do envolvido consultado; `indicadores`,
com sinais objetivos como recuperação judicial e segredo de justiça; e
`estatisticas`, com os principais assuntos, classes, tribunais, polos,
status, graus e matérias dos processos. Cada lista de estatísticas retorna
até 10 itens, ordenados pela maior quantidade de processos.

Informe `nome` ou `cpf_cnpj`. Os dois parâmetros não podem ser enviados
na mesma requisição.

Acesse a [página de respostas](/v2/docs/respostas#estrutura-estatisticasenvolvido)
para detalhes sobre os dados retornados.

Busca apenas correspondências exatas para o nome informado. Disponível apenas quando `nome` é enviado. Default: false

{
    "envolvido_encontrado": {
        "nome": "Banco do Brasil S.A",
        "tipo_pessoa": "JURIDICA",
        "documento": "00000000000191",
        "quantidade_processos": 54643
    },
    "indicadores": {
        "recuperacao_judicial": {
            "encontrada": false
        },
        "segredo_justica": {
            "quantidade_processos": 101
        }
    },
    "estatisticas": {
        "assuntos": [
            {
                "id": 1263,
                "nome": "DIREITO DO TRABALHO",
                "nome_com_pai": "DIREITO DO TRABALHO",
                "path": "DIREITO DO TRABALHO",
                "quantidade_processos": 1200
            },
            {
                "id": 7681,
                "nome": "Contratos Bancarios",
                "nome_com_pai": "Obrigacoes > Contratos Bancarios",
                "path": "DIREITO CIVIL | Obrigacoes | Contratos Bancarios",
                "quantidade_processos": 870
            }
        ],
        "classes": [
            {
                "nome": "Procedimento Comum Civel",
                "quantidade_processos": 9800
            },
            {
                "nome": "Execucao de Titulo Extrajudicial",
                "quantidade_processos": 7300
            }
        ],
        "tribunais": [
            {
                "id": 1,
                "sigla": "TJSP",
                "nome": "Tribunal de Justica de Sao Paulo",
                "quantidade_processos": 10500
            },
            {
                "id": 2,
                "sigla": "TJRJ",
                "nome": "Tribunal de Justica do Rio de Janeiro",
                "quantidade_processos": 8200
            }
        ],
        "polos": [
            {
                "polo": "PASSIVO",
                "quantidade_processos": 44394
            },
            {
                "polo": "ATIVO",
                "quantidade_processos": 7896
            },
            {
                "polo": "DESCONHECIDO",
                "quantidade_processos": 1910
            },
            {
                "polo": "ADVOGADO",
                "quantidade_processos": 304
            },
            {
                "polo": "NENHUM",
                "quantidade_processos": 130
            },
            {
                "polo": "TERCEIRO",
                "quantidade_processos": 9
            }
        ],
        "status": [
            {
                "status": "INATIVO",
                "quantidade_processos": 40367
            },
            {
                "status": "ATIVO",
                "quantidade_processos": 14196
            },
            {
                "status": "DESCONHECIDO",
                "quantidade_processos": 80
            }
        ],
        "graus": [
            {
                "grau": 1,
                "grau_formatado": "Primeiro Grau",
                "quantidade_processos": 54358
            },
            {
                "grau": 2,
                "grau_formatado": "Segundo Grau",
                "quantidade_processos": 12897
            },
            {
                "grau": 3,
                "grau_formatado": "Superior",
                "quantidade_processos": 2159
            },
            {
                "grau": null,
                "grau_formatado": "Instância Desconhecida",
                "quantidade_processos": 0
            }
        ],
        "materias": [
            {
                "id": 1313,
                "area": "DIREITO CIVIL",
                "quantidade_processos": 18400,
                "valor_total_causa_conhecido": 18450320.44,
                "quantidade_processos_com_valor": 91,
                "quantidade_processos_sem_valor": 18309,
                "maior_valor_causa_conhecido": 5200000,
                "menor_valor_causa_conhecido": 1800,
                "valor_medio_causa_quando_conhecido": 202750.77
            },
            {
                "id": 1263,
                "area": "DIREITO DO TRABALHO",
                "quantidade_processos": 9300,
                "valor_total_causa_conhecido": 1920450.55,
                "quantidade_processos_com_valor": 44,
                "quantidade_processos_sem_valor": 9256,
                "maior_valor_causa_conhecido": 310000,
                "menor_valor_causa_conhecido": 1500,
                "valor_medio_causa_quando_conhecido": 43646.6
            }
        ]
    }
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

{
    "code": "UNPROCESSABLE_ENTITY",
    "message": "Não foi possível processar a solicitação",
    "errors": [],
    "appends": null
}

Prompt: Explique o endpoint GET /api/v2/envolvido/estatisticas, incluindo autenticação, parâmetros e exemplo de resposta.


Processos de um advogado por OAB

Retorna os processos de um advogado a partir da OAB

Acesse a [página de respostas](/v2/docs/respostas#estrutura-processo) para detalhes sobre os dados retornados.

O `advogado_encontrado` também inclui dados cadastrais do advogado: o CPF (`cpf`) e as sociedades de advogados das quais faz parte (`sociedades`).

Estado da OAB.

Número da OAB.

Tipo da OAB, pode ser informado caso o mesmo número exista para diferentes tipos. Pode ser `ADVOGADO`, `SUPLEMENTAR`, `ESTAGIARIO` ou `CONSULTOR_ESTRANGEIRO`.

{
    "advogado_encontrado": {
        "nome": "JOÃO DA SILVA",
        "tipo": "ADVOGADO",
        "cpf": "12345678900",
        "sociedades": [
            {
                "inscricao": "5008",
                "nome": "SILVA E SOUZA ADVOGADOS ASSOCIADOS",
                "uf": "BA"
            }
        ],
        "quantidade_processos": 521
    },
    "items": [
        {
            "numero_cnj": "0000000-00.2022.2.03.0000",
            "titulo_polo_ativo": "Marcio Castro Chagas",
            "titulo_polo_passivo": "Mauro Emerson Gomes",
            "ano_inicio": 2022,
            "data_inicio": "2023-02-10",
            "estado_origem": {
                "nome": "São Paulo",
                "sigla": "SP"
            },
            "unidade_origem": {
                "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                "classificacao": "JE - Juizado Especial",
                "cidade": "São Paulo",
                "estado": {
                    "nome": "São Paulo",
                    "sigla": "SP"
                },
                "tribunal_sigla": "TJSP"
            },
            "data_ultima_movimentacao": "2023-02-10",
            "quantidade_movimentacoes": 1,
            "fontes_tribunais_estao_arquivadas": false,
            "data_ultima_verificacao": "2023-03-14T18:06:59+00:00",
            "tempo_desde_ultima_verificacao": "há 2 horas",
            "processos_relacionados": [
                {
                    "numero": "8027909-02.2019.8.05.0000"
                },
                {
                    "numero": "8028150-73.2019.8.05.0000"
                }
            ],
            "fontes": [
                {
                    "id": 1104,
                    "processo_fonte_id": 1125512,
                    "descricao": "TSE - 3º grau",
                    "nome": "Tribunal Superior Eleitoral",
                    "sigla": "TSE",
                    "tipo": "TRIBUNAL",
                    "data_inicio": "2023-02-10",
                    "data_ultima_movimentacao": "2023-02-10",
                    "segredo_justica": false,
                    "arquivado": null,
                    "status_predito": "ATIVO",
                    "grau": 3,
                    "grau_formatado": "Superior",
                    "fisico": false,
                    "sistema": "UNIFICADO",
                    "capa": {
                        "classe": "RECURSO ESPECIAL ELEITORAL",
                        "assunto": "DIREITO ELEITORAL",
                        "assuntos_normalizados": [
                            {
                                "id": 3388,
                                "nome": "Eleições",
                                "nome_com_pai": "Conselhos Regionais de Fiscalização Profissional e Afins > Eleições",
                                "path_completo": "DIREITO ADMINISTRATIVO E OUTRAS MATÉRIAS DE DIREITO PÚBLICO > Organização Político-administrativa / Administração Pública > Conselhos Regionais de Fiscalização Profissional e Afins > Eleições",
                                "categoria_raiz": "DIREITO ADMINISTRATIVO E OUTRAS MATÉRIAS DE DIREITO PÚBLICO",
                                "bloqueado": false
                            },
                            {
                                "id": 3935,
                                "nome": "Propaganda eleitoral",
                                "nome_com_pai": "Campanha Eleitoral > Propaganda eleitoral",
                                "path_completo": "DIREITO ELEITORAL E PROCESSO ELEITORAL DO STF > Eleição > Campanha Eleitoral > Propaganda eleitoral",
                                "categoria_raiz": "DIREITO ELEITORAL E PROCESSO ELEITORAL DO STF",
                                "bloqueado": false
                            },
                            {
                                "id": 4564,
                                "nome": "DIREITO ELEITORAL",
                                "nome_com_pai": "DIREITO ELEITORAL",
                                "path_completo": "DIREITO ELEITORAL",
                                "categoria_raiz": "DIREITO ELEITORAL",
                                "bloqueado": false
                            },
                            {
                                "id": 4717,
                                "nome": "Eleições",
                                "nome_com_pai": "DIREITO ELEITORAL > Eleições",
                                "path_completo": "DIREITO ELEITORAL > Eleições",
                                "categoria_raiz": "DIREITO ELEITORAL",
                                "bloqueado": false
                            },
                            {
                                "id": 4904,
                                "nome": "Propaganda Política",
                                "nome_com_pai": "Partidos Políticos > Propaganda Política",
                                "path_completo": "DIREITO ELEITORAL > Partidos Políticos > Propaganda Política",
                                "categoria_raiz": "DIREITO ELEITORAL",
                                "bloqueado": false
                            },
                            {
                                "id": 5770,
                                "nome": "Propaganda Política - Propaganda Eleitoral - Impulsionamento",
                                "nome_com_pai": "Propaganda Política - Propaganda Eleitoral > Propaganda Política - Propaganda Eleitoral - Impulsionamento",
                                "path_completo": "DIREITO ELEITORAL > Eleições > Propaganda Política - Propaganda Eleitoral > Propaganda Política - Propaganda Eleitoral - Impulsionamento",
                                "categoria_raiz": "DIREITO ELEITORAL",
                                "bloqueado": false
                            }
                        ],
                        "assunto_principal_normalizado": {
                            "id": 4564,
                            "nome": "DIREITO ELEITORAL",
                            "nome_com_pai": "DIREITO ELEITORAL",
                            "path_completo": "DIREITO ELEITORAL",
                            "categoria_raiz": "DIREITO ELEITORAL",
                            "bloqueado": false
                        },
                        "area": null,
                        "orgao_julgador": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                        "orgao_julgador_normalizado": {
                            "nome": "01 VARA JUIZADO ESPECIAL CIVEL DE CAMPINAS",
                            "endereco": "Avenida Francisco Xavier de Arruda Camargo, 300",
                            "classificacao": "JE - Juizado Especial",
                            "cidade": "São Paulo",
                            "estado": {
                                "nome": "São Paulo",
                                "sigla": "SP"
                            },
                            "tribunal_sigla": "TJSP"
                        },
                        "situacao": "Baixado",
                        "valor_causa": {
                            "valor": null,
                            "moeda": null,
                            "valor_formatado": null
                        },
                        "data_distribuicao": "2023-02-10",
                        "data_arquivamento": null,
                        "informacoes_complementares": null
                    },
                    "url": "https://consultaunificadapje.tse.jus.br/#/public/resultado/0000000-00.2022.2.03.0000",
                    "tribunal": {
                        "id": 36,
                        "nome": "Tribunal Superior Eleitoral",
                        "sigla": "TSE",
                        "categoria": null
                    },
                    "quantidade_movimentacoes": 1,
                    "data_ultima_verificacao": "2023-03-14T18:06:59+00:00",
                    "envolvidos": [
                        {
                            "nome": "Marcio Castro Chagas",
                            "quantidade_processos": 1,
                            "tipo_pessoa": null,
                            "advogados": [
                                {
                                    "nome": "João Paulo de Silva",
                                    "quantidade_processos": 5,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "CE",
                                            "tipo": "ADVOGADO",
                                            "numero": 123023
                                        }
                                    ]
                                }
                            ],
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "AUTOR",
                            "tipo_normalizado": "Autor",
                            "polo": "ATIVO"
                        },
                        {
                            "nome": "Mauro Emerson Gomes",
                            "quantidade_processos": 1,
                            "tipo_pessoa": "JURIDICA",
                            "advogados": [
                                {
                                    "nome": "Roberta dos Santos Conceição",
                                    "quantidade_processos": 49,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "CE",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                },
                                {
                                    "nome": "Luiz Carlos Silveira",
                                    "quantidade_processos": 31,
                                    "tipo_pessoa": "JURIDICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "oabs": [
                                        {
                                            "uf": "CE",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                }
                            ],
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "REU",
                            "tipo_normalizado": "Réu",
                            "polo": "PASSIVO"
                        },
                        {
                            "nome": "Rede Servicos Online do Brasil Ltda",
                            "quantidade_processos": 10996,
                            "tipo_pessoa": "JURIDICA",
                            "advogados": [
                                {
                                    "nome": "Joana D'Arc de Souza",
                                    "quantidade_processos": 101,
                                    "tipo_pessoa": "FISICA",
                                    "prefixo": null,
                                    "sufixo": null,
                                    "tipo": "ADVOGADO",
                                    "tipo_normalizado": "Advogado",
                                    "polo": "ADVOGADO",
                                    "cpf": "00000000000",
                                    "oabs": [
                                        {
                                            "uf": "SP",
                                            "tipo": "ADVOGADO",
                                            "numero": 123123
                                        }
                                    ]
                                }
                            ],
                            "prefixo": null,
                            "sufixo": null,
                            "tipo": "REU",
                            "tipo_normalizado": "Réu",
                            "polo": "PASSIVO",
                            "cnpj": "00000000000000"
                        }
                    ]
                }
            ]
        }
    ],
    "links": {
        "next": "https://api.escavador.com/api/v2/advogado/processos?oab_estado=SP&oab_numero=123123&cursor=eyJwcm9jZXNzby5kYXRhX2luaWNpbyI6IjIwMjEtMDEtMTkgMDA6MDA6MDAiLCJwcm9jZXNzby5pZCI6MTEwNzI0NCwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ&li=216038277"
    },
    "paginator": {
        "per_page": 20
    }
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/advogado/processos, incluindo autenticação, parâmetros e exemplo de resposta.


Resumo de processos do advogado por OAB

Retorna um resumo do advogado a partir do oab, mostrando a quantidade de processos e o tipo da oab informada

A resposta também inclui dados cadastrais do advogado: o CPF (`cpf`) e as sociedades de advogados das quais faz parte (`sociedades`).

Estado da OAB.

Número da OAB.

{
    "nome": "Fulano da Silva",
    "tipo": "ADVOGADO",
    "cpf": "12345678900",
    "sociedades": [
        {
            "inscricao": "5008",
            "nome": "SILVA E SOUZA ADVOGADOS ASSOCIADOS",
            "uf": "BA"
        }
    ],
    "quantidade_processos": 153
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint GET /api/v2/advogado/resumo, incluindo autenticação, parâmetros e exemplo de resposta.


Solicitar atualização de um processo

Solicita a atualização de um processo nos sistemas dos Tribunais para obter as informações mais recentes. A operação é ideal para sincronizar dados e obter acesso a novos andamentos ou documentos.

É possível solicitar download dos documentos públicos ou dos autos do processo, que são documentos restritos e exigem autenticação. Para autenticação via certificado digital, você pode cadastrá-los em https://api.escavador.com/certificados. A escolha entre as opções afeta o custo da solicitação.

A atualização é uma tarefa assíncrona e possui uma lógica de retentativas dentro de um mesmo pedido. Após o envio, você deve consultar o endpoint de status ou configurar um webhook para aguardar a conclusão. Com o status SUCESSO, os dados atualizados e os documentos estarão disponíveis para consulta nos endpoints apropriados.

Atenção
 Para solicitar atualizações de processos via API v2 com certificado digital, pode ser exigida
autenticação multifator (MFA) pelo sistema do Tribunal. Saiba mais nos artigos
Acessando os Autos de Processos via API v2 com Certificado Digital e no  Como obter e cadastrar QR Code para autenticação MFA no escavador

Número único do processo. <b>Obrigatório estar no formato de CNJ.</b>

Se `enviar_callback=1`, um callback será enviado para sua URL configurada quando o processo for atualizado.

Se `documentos_publicos=1`, serão baixados os documentos públicos do processo. Não pode ser usado junto com `autos=1`.

Se `autos=1`, serão baixados os autos completos do processo (documentos restritos). Requer autenticação via certificado ou usuário/senha. **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 atualização.

Se `utilizar_certificado=1`, um dos certificados cadastrados na sua conta será utilizado para a autenticação no tribunal. Obrigatório se `autos=1` e não for informado `usuario` e `senha`.

O ID de um certificado específico que você cadastrou. Se não for enviado, um certificado aleatório da sua conta será selecionado para todas as tentativas do pedido.

Usuário de acesso ao sistema do tribunal. Obrigatório se `autos=1` e não for informado `utilizar_certificado=1`.

Senha de acesso ao sistema do tribunal. Obrigatório se `autos=1` e não for informado `utilizar_certificado=1`.

Se `autos == 1`, você pode especificar quais documentos deseja receber.
INICIAIS: Serão baixados somente os documentos da primeira data do processo.

{
    "id": 125,
    "status": "PENDENTE",
    "numero_cnj": "0000000-00.0000.0.00.0000",
    "criado_em": "2023-05-10T19:09:43+00:00",
    "concluido_em": null
}

Esse é um exemplo de resposta bem-sucedida.

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "error": "NotFound"
}

Prompt: Explique o endpoint POST /api/v2/processos/numero_cnj/{numero}/solicitar-atualizacao, incluindo autenticação, parâmetros e exemplo de resposta.


Solicita a geração/atualização do resumo inteligente de um processo.

Esta rota registra uma solicitação para gerar ou atualizar o resumo inteligente do processo. O resumo é baseado nos dados mais recentes disponíveis em nossa base. Para garantir que o resumo reflita as últimas alterações no tribunal, recomenda-se primeiro atualizar o processo através da rota [Atualizar Processo](/v2/docs/atualizacao-de-processos#solicitar-atualizao-de-um-processo).

<aside class="notice">
Para a implementação completa do fluxo (solicitar, acompanhar status e buscar resumo), consulte: [Fluxo de implementação: Resumo de processos (IA)](/v2/docs/fluxo-resumo-processos-ia).
</aside>

Indica se deseja receber uma notificação via callback quando o resumo inteligente estiver pronto.

{
    "id": 2001596,
    "status": "PENDENTE",
    "criado_em": "2025-01-13T21:01:26+00:00",
    "numero_cnj": "8118778-37.2021.8.05.0001",
    "concluido_em": null,
    "enviar_callback": "SIM"
}

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "code": "NOT_FOUND",
    "message": "Recurso não encontrado",
    "errors": null,
    "appends": null
}

{
    "code": "NUMERO_CNJ_INVALIDO",
    "message": "O número do processo não está no formato CNJ.",
    "errors": null,
    "appends": null
}

Prompt: Explique o endpoint POST /api/v2/processos/numero_cnj/{numero}/ia/resumo/solicitar-atualizacao, incluindo autenticação, parâmetros e exemplo de resposta.


Resumo inteligente de um processo

Retorna o resumo inteligente do processo, caso o resumo já exista. No retorno, são exibidos o número CNJ do processo, o conteúdo do resumo (normalmente um texto resumido com os elementos essenciais do processo) e a data de atualização do resumo.
<aside class="notice">
Para a implementação correta em produção, consulte o fluxo recomendado em: [Fluxo de implementação: Resumo de processos (IA)](/v2/docs/fluxo-resumo-processos-ia).
</aside>

{
    "numero_cnj": "8118778-37.2021.8.05.0001",
    "conteudo": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis a nibh sit amet tellus elementum rhoncus. Mauris ullamcorper posuere odio sodales dictum. Etiam pellentesque euismod quam, a accumsan metus. Fusce lobortis, ipsum eget feugiat efficitur, urna nisi rhoncus tortor, vel interdum libero odio ac ligula. Phasellus sapien massa, malesuada eget augue eget, consectetur gravida elit. In at ipsum tempor, blandit metus quis, semper mauris. Nunc in sem ullamcorper, vestibulum ex et, volutpat velit.",
    "atualizado_em": "2025-01-13T21:01:33+00:00"
}

{
    "error": "Unauthenticated"
}

{
    "error": "Você não possui saldo em crédito da API."
}

{
    "code": "NOT_FOUND",
    "message": "Recurso não encontrado",
    "errors": null,
    "appends": null
}

{
    "code": "NUMERO_CNJ_INVALIDO",
    "message": "O número do processo não está no formato CNJ.",
    "errors": null,
    "appends": null
}

Prompt: Explique o endpoint GET /api/v2/processos/numero_cnj/{numero}/ia/resumo, incluindo autenticação, parâmetros e exemplo de resposta.