Baixar Collection

Instituicoes - Escavador API - Documentação

Grupo

Instituições

Obter Instituição

GET /api/v1/instituicoes/{instituicaoId}
Requer autenticaçãoPaga

Retorna dados relacionados a uma instituição pelo seu identificador.

Visão geral

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

URL Parameters

?
instituicaoId integer Obrigatório

Identificador numérico de uma Instituição.

Exemplos de respostas válidas

HTTP 200 ? 
{
    "id": 1,
    "nome": "Instituto Brasileiro",
    "sigla": "IB",
    "pais": "Brasil",
    "ultimos_processos": [
        {
            "id": 50234,
            "numero_antigo": null,
            "numero_novo": "0000000-00.0000.0.0.0001",
            "is_cnj": 1,
            "enviado_trimon_em": "2022-04-19 18:55:35",
            "created_at": null,
            "updated_at": null,
            "origem_tribunal_id": 21,
            "filtrado_em": null,
            "tipo_envolvido": "AGRAVADO | RECORRIDO | RECLAMADO",
            "link": "https://www.escavador.com/processos/50234/processo-0000000-0000000000001-do-tribunal-superior-do-trabalho",
            "link_api": "https://api.escavador.com/api/v1/processos/1",
            "data_movimentacoes": "17/10/2013 a 09/03/2022",
            "data_primeira_movimentacao": "17/10/2013",
            "envolvidos_ultima_movimentacao": [
                {
                    "id": 1,
                    "nome": "João Silva",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/1/joao-silva",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/1",
                    "nome_sem_filtro": "João Silva",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "12345/DF",
                    "advogado_de": null
                },
                {
                    "id": 2,
                    "nome": "Atelie da Maria",
                    "objeto_type": "Instituicao",
                    "pivot_tipo": "RECLAMADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/2/atelie-da-maria",
                    "link_api": "https://api.escavador.com/api/v1/instituicoes/2",
                    "nome_sem_filtro": "Atelie da Maria",
                    "envolvido_tipo": "Reclamado",
                    "envolvido_extra_nome": "",
                    "oab": "",
                    "advogado_de": null
                }
            ],
            "url": {
                "id": 90709623,
                "slug": "processo-0000757-9420135100014-do-tribunal-superior-do-trabalho",
                "objeto_type": "Processo",
                "objeto_id": 50234,
                "redirect": null,
                "anuncio_ocultado_em": null
            }
        }
    ],
    "quantidade_processos": 321,
    "estados_com_mais_processos": [
        {
            "estado": "São Paulo",
            "qtd": 100
        }
    ],
    "link": "https://www.escavador.com/sobre/1/instituto-brasileiro",
    "link_api": "https://api.escavador.com/api/v1/instituicoes/1",
    "created_at": null
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Processos de uma Instituição

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

Retorna os processos de uma instituição que saíram em Diários Oficiais e estão no Escavador.

Visão geral

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

URL Parameters

?
instituicaoId integer Obrigatório

Identificador numérico de uma Instituição.

Query Parameters

?
limit integer Opcional

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

page integer Opcional

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

Exemplos de respostas válidas

HTTP 200 ? 
{
    "paginator": {
        "total": 321,
        "total_pages": 17,
        "current_page": 1,
        "per_page": 20
    },
    "links": {
        "prev": null,
        "next": "https://api.escavador.com/api/v1/instituicoes/1/processos?page=2"
    },
    "items": [
        {
            "id": 1,
            "numero_antigo": null,
            "numero_novo": "0000000-00.0000.0.00.0000",
            "is_cnj": 1,
            "enviado_trimon_em": "2022-03-17 22:07:05",
            "created_at": null,
            "updated_at": null,
            "origem_tribunal_id": 102,
            "filtrado_em": null,
            "tipo_envolvido": "",
            "diario_sigla": "DJSP",
            "diario_nome": "Diário de Justiça do Estado de São Paulo (São Paulo)",
            "estado": "SP",
            "data_movimentacoes": "01/03/2017 a 10/03/2017",
            "quantidade_movimentacoes": 2,
            "envolvidos_ultima_movimentacao": [
                {
                    "id": 10,
                    "nome": "UB - Universidade Brasileira",
                    "objeto_type": "Instituicao",
                    "pivot_tipo": "AGRAVADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/10/ub-universidade-brasileira",
                    "link_api": "https://api.escavador.com/api/v1/instituicoes/10",
                    "nome_sem_filtro": "UB - Universidade Brasileira",
                    "envolvido_tipo": "Agravado",
                    "envolvido_extra_nome": "",
                    "oab": "",
                    "advogado_de": null
                },
                {
                    "id": 11,
                    "nome": "Katia Rosa Machado de Oliveira",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/12/katia-machado-",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/12",
                    "nome_sem_filtro": "Katia Machado",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "1234/SP",
                    "advogado_de": null
                },
                {
                    "id": 12,
                    "nome": "Luiza Maia Fugimoto",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "AGRAVANTE",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/12/luiza-fugimoto",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/12",
                    "nome_sem_filtro": "Luiza Maia Fugimoto",
                    "envolvido_tipo": "Agravante",
                    "envolvido_extra_nome": "",
                    "oab": "",
                    "advogado_de": null
                }
            ],
            "tipo_ultima_movimentacao": "Agravo de Instrumento",
            "link": "https://www.escavador.com/processos/1/processo-0000000-0000000000000-do-diario-de-justica-do-estado-de-sao-paulo",
            "link_api": "https://api.escavador.com/api/v1/processos/1",
            "url": {
                "id": 1,
                "slug": "processo-0000000-0000000000000-do-diario-de-justica-do-estado-de-sao-paulo",
                "objeto_type": "Processo",
                "objeto_id": 1,
                "redirect": null,
                "anuncio_ocultado_em": null
            }
        },
        {
            "id": 2,
            "numero_antigo": "0000.00.00.000000-0",
            "numero_novo": "9999999-99.9999.9.99.9999",
            "is_cnj": 1,
            "enviado_trimon_em": "2022-03-17 22:07:05",
            "created_at": null,
            "updated_at": null,
            "origem_tribunal_id": 102,
            "filtrado_em": null,
            "tipo_envolvido": "",
            "diario_sigla": "DJSP",
            "diario_nome": "Diário de Justiça do Estado de São Paulo (São Paulo)",
            "estado": "SP",
            "data_movimentacoes": "01/03/2017 a 10/03/2017",
            "quantidade_movimentacoes": 2,
            "envolvidos_ultima_movimentacao": [
                {
                    "id": 10,
                    "nome": "UB - Universidade Brasileira",
                    "objeto_type": "Instituicao",
                    "pivot_tipo": "AGRAVADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/10/ub-universidade-brasileira",
                    "link_api": "https://api.escavador.com/api/v1/instituicoes/10",
                    "nome_sem_filtro": "UB - Universidade Brasileira",
                    "envolvido_tipo": "Agravado",
                    "envolvido_extra_nome": "",
                    "oab": "",
                    "advogado_de": null
                },
                {
                    "id": 11,
                    "nome": "Katia Rosa Machado de Oliveira",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "ADVOGADO",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/12/katia-machado-",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/12",
                    "nome_sem_filtro": "Katia Machado",
                    "envolvido_tipo": "Advogado",
                    "envolvido_extra_nome": "",
                    "oab": "1234/SP",
                    "advogado_de": null
                },
                {
                    "id": 12,
                    "nome": "Luiza Fugimoto",
                    "objeto_type": "Pessoa",
                    "pivot_tipo": "AGRAVANTE",
                    "pivot_outros": "NAO",
                    "pivot_extra_nome": null,
                    "link": "https://www.escavador.com/sobre/12/luiza-fugimoto",
                    "link_api": "https://api.escavador.com/api/v1/pessoas/12",
                    "nome_sem_filtro": "Luiza Fugimoto",
                    "envolvido_tipo": "Agravante",
                    "envolvido_extra_nome": "",
                    "oab": "",
                    "advogado_de": null
                }
            ],
            "tipo_ultima_movimentacao": "Agravo de Instrumento",
            "link": "https://www.escavador.com/processos/1/processo-9999999-9999999999999-do-diario-de-justica-do-estado-de-sao-paulo",
            "link_api": "https://api.escavador.com/api/v1/processos/2",
            "url": {
                "id": 1,
                "slug": "processo-9999999-9999999999999-do-diario-de-justica-do-estado-de-sao-paulo",
                "objeto_type": "Processo",
                "objeto_id": 2,
                "redirect": null,
                "anuncio_ocultado_em": null
            }
        }
    ]
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}

Pessoas de uma Instituição

GET /api/v1/instituicoes/{instituicaoId}/pessoas
Requer autenticaçãoPaga

Retorna as pessoas que estão associadas a uma instituição.

Visão geral

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

URL Parameters

?
instituicaoId integer Obrigatório

Identificador numérico de uma Instituição.

Query Parameters

?
limit integer Opcional

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

page integer Opcional

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

Exemplos de respostas válidas

HTTP 200 ? 
{
    "paginator": {
        "total": 2,
        "total_pages": 1,
        "current_page": 1,
        "per_page": 20
    },
    "links": {
        "prev": null,
        "next": null
    },
    "items": [
        {
            "id": 1,
            "formacao": {
                "usuario_id": null,
                "lattes_id": "ABC56100Y1",
                "tipo": "formacao",
                "ano_inicio": 2012,
                "ano_fim": 2014
            },
            "nome": "Maria de Souza",
            "link": "https://www.escavador.com/sobre/1/maria-de-souza",
            "link_api": "https://api.escavador.com/api/v1/pessoas/1"
        },
        {
            "id": 2,
            "formacao": {
                "usuario_id": null,
                "lattes_id": "ABC97051Z1",
                "tipo": "formacao",
                "ano_inicio": 2017,
                "ano_fim": null
            },
            "nome": "João José",
            "link": "https://www.escavador.com/sobre/2/joao-jose",
            "link_api": "https://api.escavador.com/api/v1/pessoas/2"
        }
    ]
}
HTTP 401 ? 
{
    "error": "Unauthenticated"
}
HTTP 402 ? 
{
    "error": "Você não possui saldo em crédito da API."
}
HTTP 404 ? 
{
    "error": "NotFound"
}