AdvPlan Casos API
Processos e casos, com linha do tempo e fases
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/advplan-com-br:advplan-com-br-casos-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Advplan Com Br Casos API
version: 1.0.0
contact:
name: Suporte AdvPlan
email: contato@advplan.com.br
description: 'Operations tagged Casos across 2 of this provider''s published API definitions: advplan-com-br-openapi.json, advplan-com-br-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
tags:
- name: Casos
description: Processos e casos, com linha do tempo e fases
paths:
/api/v1/casos:
get:
tags:
- Casos
summary: Lista os casos do escritório
operationId: 5917df8dbf0d67429c2b113fb1a4aeae
parameters:
- name: fase
in: query
description: Chave da fase (prospeccao, processual, execucao…)
schema:
type: string
- name: cliente_id
in: query
schema:
type: integer
- name: busca
in: query
description: Código interno, número CNJ ou assunto
schema:
type: string
- name: per_page
in: query
description: Itens por página (padrão 20, máximo 100)
schema:
type: integer
responses:
'200':
description: Lista paginada de casos
'401':
description: Chave ausente ou inválida
security:
- chaveDoEscritorio: []
post:
tags:
- Casos
summary: Cria um caso
description: O código interno é gerado pelo AdvPlan. Cliente vinculado que era prospecto passa a ativo. Dispara o webhook caso.criado.
operationId: e5cb3127589d3effbe4a433172d1a49c
requestBody:
required: true
content:
application/json:
schema:
required:
- fase
- advogado_responsavel_id
properties:
fase:
description: Chave de uma fase do kanban do escritório
type: string
example: consultivo
advogado_responsavel_id:
type: integer
example: 7
numero_cnj:
type: string
example: 5001234-56.2026.8.08.0014
assunto:
type: string
example: Revisão de contrato bancário
tribunal:
type: string
example: TJES
comarca:
type: string
example: Colatina
valor_causa:
type: number
example: 25000
segredo_justica:
type: boolean
example: false
clientes:
type: array
items:
properties:
id:
type: integer
example: 34
papel:
type: string
enum:
- autor
- reu
- interessado
- investigado
- representante_vitima
- reeducando
- vitima
type: object
type: object
responses:
'201':
description: Caso criado, com o código interno gerado
'403':
description: Algum cliente informado está fora do alcance da chave
'422':
description: Dados inválidos
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
/api/v1/casos/{caso}:
get:
tags:
- Casos
summary: Mostra um caso
operationId: b654c19efdbbea17a84ec5f5cdb9b0bb
parameters:
- name: caso
in: path
required: true
schema:
type: integer
responses:
'200':
description: Caso, com cliente e responsável
'404':
description: Não existe, ou é de outro escritório
security:
- chaveDoEscritorio: []
put:
tags:
- Casos
summary: Atualiza um caso
description: Também aceita PATCH. Mudar a fase por aqui vale o mesmo que PUT /casos/{caso}/fase.
operationId: f01f4d6730f29704ab72fdc4ce3a4b67
parameters:
- name: caso
in: path
required: true
schema:
type: integer
requestBody:
description: Mesmos campos do cadastro; mande só o que muda.
required: true
content:
application/json:
schema:
properties:
vara:
type: string
example: 2ª Vara Cível
risco_chance:
type: string
enum:
- provavel
- possivel
- remoto
type: object
responses:
'200':
description: Caso atualizado
'404':
description: Não existe, ou é de outro escritório
'422':
description: Dados inválidos, ou a fase nova não aceita o caso agora
security:
- chaveDoEscritorio: []
delete:
tags:
- Casos
summary: Remove um caso
operationId: d655c1028d1f4673876ac2c948b0189c
parameters:
- name: caso
in: path
required: true
schema:
type: integer
responses:
'200':
description: 'Removido: {deleted: true}'
'403':
description: A chave não tem permissão de excluir casos
'404':
description: Não existe, ou é de outro escritório
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
/api/v1/casos/{caso}/timeline:
get:
tags:
- Casos
summary: Linha do tempo do caso
description: 'Tudo o que aconteceu no caso, do mais recente para o mais antigo: publicações, prazos, documentos e comunicação com o cliente.'
operationId: 817b4ed7e52a4260d64c8b50768e651e
parameters:
- name: caso
in: path
required: true
schema:
type: integer
responses:
'200':
description: Eventos da linha do tempo
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
/api/v1/casos/{caso}/eventos:
post:
tags:
- Casos
summary: Registra um fato na linha do tempo do caso
operationId: 54c4c144696616dc56726b419519836f
parameters:
- name: caso
in: path
required: true
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
required:
- tipo
- descricao
properties:
tipo:
type: string
enum:
- contratacao
- documentacao
- acordo_tentativa
- acordo_fechado
- protocolo
- intimacao
- despacho
- decisao
- audiencia
- manifestacao
- recurso
- sentenca
- transito
- comunicacao_cliente
- observacao
example: observacao
descricao:
type: string
example: Cliente enviou o comprovante de residência.
data_evento:
type: string
format: date
example: '2026-10-04'
visibilidade:
description: publica aparece no portal do cliente; o padrão é publica
type: string
enum:
- publica
- interna
type: object
responses:
'201':
description: Evento registrado
'404':
description: Não existe, ou é de outro escritório
'422':
description: Dados inválidos
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
/api/v1/casos/{caso}/fase:
put:
tags:
- Casos
summary: Move o caso de fase
description: Mesma mudança que arrastar o card no kanban — inclusive dispara os fluxos automáticos configurados para a fase de destino.
operationId: b20f323615171a3e2bfe3a46778e5605
parameters:
- name: caso
in: path
required: true
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
required:
- fase
properties:
fase:
type: string
example: execucao
type: object
responses:
'200':
description: Caso na fase nova
'422':
description: Fase inexistente no escritório
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
/api/v1/casos/{caso}/encerrar:
post:
tags:
- Casos
summary: Encerra o caso
description: Muda a fase do caso para encerrado, registrando o motivo e a data de encerramento.
operationId: be76a9fc07803204178877b9bd74feed
parameters:
- name: caso
in: path
required: true
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
required:
- motivo
properties:
motivo:
type: string
enum:
- sentenca_favoravel
- sentenca_desfavoravel
- acordo
- desistencia
- prescricao
- outro
observacoes:
type: string
data_encerramento:
type: string
format: date
type: object
responses:
'200':
description: Caso encerrado
'422':
description: Dados inválidos
security:
- chaveDoEscritorio: []
servers:
- url: https://lp.advplan.com.br
description: Este ambiente (o que você está lendo agora)
components:
securitySchemes:
chaveDoEscritorio:
type: http
description: 'Cole a chave criada em Configurações → Chaves de API. No cabeçalho vai como: Authorization: Bearer SUA_CHAVE'
scheme: bearer
x-refined-from:
- advplan-com-br-openapi.json
- advplan-com-br-openapi.json