API REST e conexão de IA

Conecte o JurisPark a qualquer sistema.

Uma API REST em JSON, com chave por escritório e permissões por escopo, documentada em OpenAPI. E uma conexão de IA (MCP) para o Claude, o ChatGPT e outros clientes compatíveis operarem o escritório com os mesmos limites do usuário que a conectou.

  • JSON em português
  • OpenAPI 3.1 pública
  • Nenhuma rota apaga dados
Terminal
curl "https://app.jurispark.com.br/api/v1/me" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"
Resposta200 OK
{
  "data": {
    "usuario": {
      "id": "0191c3a2-1111-7000-8000-00000000a001",
      "nome": "Dr. Exemplo",
      "email": "dr@example.com",
      "papel": "Administrador"
    },
    "escritorio": {
      "id": "0191c3a2-0000-7000-8000-00000000f001",
      "nome": "Escritório Exemplo"
    },
    "chave": {
      "id": "0191c3a2-4444-7000-8000-00000000b001",
      "nome": "Planilha de prazos",
      "prefixo": "jp_live_Ab3x",
      "escopos": [
        "ler"
      ],
      "criadaEm": "2026-10-01T12:00:00.000Z",
      "venceEm": null
    },
    "escoposEfetivos": [
      "ler"
    ],
    "operacoes": [
      "obterIdentidade",
      "listarProcessos"
    ],
    "limites": {
      "porMinuto": 120,
      "porDia": 10000,
      "usadasHoje": 3
    }
  }
}
  • 17operações na API v1: consultar e registrar dados. Nenhuma apaga.
  • 100ferramentas de IA (MCP), em 10 áreas do escritório.
  • 3escopos de acesso por chave: ler, escrever e financeiro.
  • 120chamadas por minuto, por chave.

Começar

Duas formas de conectar, com os mesmos limites.

O JurisPark pode ser usado por fora do sistema de duas maneiras. Em ambas, quem acessa só vê e só faz o que o usuário que criou a chave, ou que conectou a IA, pode ver e fazer dentro do JurisPark.

API REST

Para programas, planilhas e automações. Você cria uma chave, envia pedidos HTTP e recebe JSON. Serve para integrar com ERPs, painéis e fluxos montados em ferramentas que fazem pedidos HTTP, como Zapier, n8n e Make. A API é do plano Escritório em diante.

Ir para a referência

Conexão de IA (MCP)

Para o advogado pedir em linguagem natural, no Claude ou em outra IA compatível: "quais prazos vencem esta semana?". Não precisa programar. O login é feito no próprio JurisPark. Está em todos os planos.

Ir para a conexão de IA

O essencial da API

Endereço base
https://app.jurispark.com.br/api/v1
Autenticação
Cabeçalho Authorization: Bearer jp_live_... em todas as chamadas.
Formato
JSON em UTF-8, campos em camelCase, textos em português. As respostas trazem o dado em data.
Datas e horas
Datas em AAAA-MM-DD. Instantes (como criadoEm) em ISO 8601, UTC. Horas de agenda em HH:MM, horário de Brasília.
Dinheiro
Números em reais, por exemplo 1500.5.
Especificação
OpenAPI 3.1, pública e sem chave, em /api/v1/openapi.json. Serve para gerar clientes e importar no Postman ou em ferramentas parecidas.
Onde usar
De servidor para servidor. A API não aceita chamadas diretas de navegadores de outros sites (sem CORS), e a chave nunca deve ir para uma página ou aplicativo que o usuário final consiga ver.
Escrita
Cria e altera registros. Nenhuma rota apaga dados. Excluir é sempre feito por uma pessoa, dentro do JurisPark.
Planos
A API é do plano Escritório em diante. A conexão de IA (MCP) está em todos os planos. Veja a comparação de planos.

Começar

Autenticação e escopos.

Cada integração usa uma chave própria. A chave age como o usuário que a criou, limitada aos acessos que você marcar.

Como gerar a chave

  1. Ligue a API no escritório. Em Configurações, API e integrações, o administrador liga a opção "API do escritório".
  2. Crie a chave. Clique em Criar chave, dê um nome que lembre o sistema que vai usá-la, marque os acessos (veja a tabela abaixo) e escolha o vencimento: sem vencimento, 30 dias, 90 dias, 6 meses ou 1 ano.
  3. Copie na hora. A chave aparece uma única vez. O JurisPark guarda apenas uma impressão digital dela: se você perder, revogue e crie outra.
  4. Envie em todas as chamadas no cabeçalho Authorization: Bearer jp_live_....
Criar minha chave Abre no sistema; pede o login se você ainda não entrou.

Criar e revogar chaves exige a permissão de configurar o escritório. Cada escritório pode ter até 10 chaves ativas. A chave começa com jp_live_ e tem 40 caracteres depois disso.

Escopos: o que cada acesso libera

Os escopos são independentes. Uma chave só com escrever consegue criar, mas não consegue listar: se a sua integração faz as duas coisas, marque ler e escrever.

Escopos de uma chave de API
EscopoNome na telaO que liberaOperações
ler Consultar Ver clientes, processos, andamentos, tarefas, agenda e publicações do Diário. GET /clientes GET /clientes/{id} GET /processos GET /processos/{id} GET /processos/{id}/andamentos GET /tarefas GET /agenda GET /publicacoes
escrever Registrar Criar e alterar clientes, tarefas e compromissos da agenda, e registrar andamentos. Nunca apaga. POST /clientes PATCH /clientes/{id} POST /processos/{id}/andamentos POST /tarefas PATCH /tarefas/{id} POST /agenda
financeiro Financeiro Ver o resumo e os lançamentos do financeiro do escritório. GET /financeiro/resumo GET /financeiro/lancamentos

A chave nunca passa do que o usuário pode

O que a chave consegue fazer é a interseção entre os escopos dela e as permissões atuais do usuário que a criou, conferida a cada chamada. Na prática:

  • O usuário só consegue dar à chave os acessos que ele mesmo tem.
  • Se o usuário perder uma permissão, a chave perde junto. Se ele for desativado, a chave passa a responder 403.
  • Cada operação lista, na referência, a permissão do usuário de que precisa (por exemplo, tarefas.criar).
  • Cofre de senhas e arquivos anexos não são acessíveis pela API.

Para ver o que uma chave consegue fazer agora, chame GET /me: a resposta traz os escopos efetivos e a lista de operações liberadas.

Começar

Primeiros passos, em três chamadas.

Troque jp_live_SUA_CHAVE pela sua chave. Em produção, leia a chave de uma variável de ambiente e nunca a deixe no código. Os exemplos em curl usam a sintaxe do Linux, macOS e Git Bash. Os de Node.js pedem a versão 18 ou mais nova e um arquivo .mjs. Os de Python usam a biblioteca requests.

1 Testar a chave

GET /me funciona com qualquer chave válida. Se vier 200 com o seu usuário e o seu escritório, está tudo certo. Se vier 401 ou 403, veja Erros.

curl

curl "https://app.jurispark.com.br/api/v1/me" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/me", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/me",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)

2 Listar tarefas abertas

Precisa do escopo ler. As listas usam paginação por cursor e aceitam filtros como status, responsavel e prioridade.

curl

curl "https://app.jurispark.com.br/api/v1/tarefas?status=abertas&limit=5" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas?status=abertas&limit=5", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/tarefas?status=abertas&limit=5",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)

3 Criar uma tarefa

Precisa do escopo escrever. Sem responsavelId, a tarefa fica com o dono da chave. A resposta é 201 com a tarefa criada, que já aparece na tela do sistema. O cabeçalho Idempotency-Key evita duplicar a tarefa se você precisar repetir a chamada (veja Idempotência).

curl

curl -X POST "https://app.jurispark.com.br/api/v1/tarefas" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Preparar réplica",
  "prazo": "2026-10-18",
  "prioridade": "alta"
}'

Node.js

import { randomUUID } from "node:crypto";

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "titulo": "Preparar réplica",
    "prazo": "2026-10-18",
    "prioridade": "alta"
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import uuid
import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/tarefas",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "titulo": "Preparar réplica",
        "prazo": "2026-10-18",
        "prioridade": "alta",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)

O $(uuidgen) do curl funciona em Linux, macOS e Git Bash. No Windows, use outro valor único no lugar.

API REST

Referência da API.

São 17 operações, agrupadas por recurso. Todas exigem a chave no cabeçalho Authorization. Cada operação mostra o escopo da chave e as permissões do usuário de que precisa, os parâmetros, um exemplo de chamada e uma resposta de exemplo. Esta referência é gerada da especificação OpenAPI (versão 1.0.0).

Ver todas as operações em uma tabela
Todas as operações da API v1
MétodoCaminhoO que fazEscopo
GET/meQuem é esta chavequalquer chave
GET/clientesListar clientesler
POST/clientesCadastrar um clienteescrever
GET/clientes/{id}Ver um clienteler
PATCH/clientes/{id}Alterar um clienteescrever
GET/processosListar processosler
GET/processos/{id}Ver um processoler
GET/processos/{id}/andamentosListar andamentos de um processoler
POST/processos/{id}/andamentosRegistrar um andamentoescrever
GET/tarefasListar tarefasler
POST/tarefasCriar uma tarefaescrever
PATCH/tarefas/{id}Alterar uma tarefaescrever
GET/agendaListar a agendaler
POST/agendaCriar um compromissoescrever
GET/publicacoesListar publicações do Diárioler
GET/financeiro/resumoResumo do financeirofinanceiro
GET/financeiro/lancamentosListar lançamentosfinanceiro

Conta

Identificação da chave.

GET/me

Quem é esta chave

#
qualquer chave válida

Mostra o usuário e o escritório dono da chave, os escopos e as operações que ela pode usar agora e o uso de hoje. Funciona com qualquer chave válida e serve para testar a conexão.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/me" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/me", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/me",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "usuario": {
      "id": "0191c3a2-1111-7000-8000-00000000a001",
      "nome": "Dr. Exemplo",
      "email": "dr@example.com",
      "papel": "Administrador"
    },
    "escritorio": {
      "id": "0191c3a2-0000-7000-8000-00000000f001",
      "nome": "Escritório Exemplo"
    },
    "chave": {
      "id": "0191c3a2-4444-7000-8000-00000000b001",
      "nome": "Planilha de prazos",
      "prefixo": "jp_live_Ab3x",
      "escopos": [
        "ler"
      ],
      "criadaEm": "2026-10-01T12:00:00.000Z",
      "venceEm": null
    },
    "escoposEfetivos": [
      "ler"
    ],
    "operacoes": [
      "obterIdentidade",
      "listarProcessos"
    ],
    "limites": {
      "porMinuto": 120,
      "porDia": 10000,
      "usadasHoje": 3
    }
  }
}
Campos da resposta (21)
  • usuarioobjetosempre presente
  • usuario.idtextosempre presente

    Identificador do usuário.

  • usuario.nometextosempre presente

    Nome.

  • usuario.emailtextosempre presente

    E-mail.

  • usuario.papeltextosempre presente

    Papel no escritório (Administrador, Advogado, Secretária ou Estagiário).

  • escritorioobjetosempre presente
  • escritorio.idtextosempre presente

    Identificador do escritório.

  • escritorio.nometextosempre presente

    Nome do escritório.

  • chaveobjetosempre presente
  • chave.idtextosempre presente

    Identificador da chave.

  • chave.nometextosempre presente

    Nome dado à chave.

  • chave.prefixotextosempre presente

    Início da chave, para você reconhecê-la.

  • chave.escoposlista de textossempre presente

    Escopos da chave.

  • chave.criadaEmdata e hora (ISO 8601, UTC)sempre presente

    Criação (UTC).

  • chave.venceEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Vencimento (UTC), ou nulo se não vence.

  • escoposEfetivoslista de textossempre presente

    Escopos que a chave realmente pode usar agora: os da chave que também são permitidos pelas permissões atuais do usuário.

  • operacoeslista de textossempre presente

    Identificadores (operationId) das operações que esta chave pode chamar agora.

  • limitesobjetosempre presente
  • limites.porMinutonúmero inteirosempre presente

    Chamadas por minuto, por chave.

  • limites.porDianúmero inteirosempre presente

    Chamadas por dia, por chave (fuso de São Paulo).

  • limites.usadasHojenúmero inteirosempre presente

    Chamadas já feitas hoje com esta chave.

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 401 403 429 500

Clientes

Cadastro de clientes.

GET/clientes

Listar clientes

#
escopo lerclientes.ver

Lista os clientes do escritório em ordem alfabética, com paginação por cursor. Por privacidade (LGPD), o CPF/CNPJ e o RG saem mascarados e o endereço de rua (CEP, logradouro, número, complemento e bairro) não é devolvido; cidade e UF, contatos e demais dados cadastrais saem normais. A lista dos campos ocultos vem em camposOcultos.

Parâmetros de consulta (todos opcionais)
  • qtexto

    Busca por nome, nome fantasia, e-mail ou parte do documento ou telefone.

    1 a 100 caracteres

  • etiquetatexto

    Só clientes com esta etiqueta.

    1 a 40 caracteres

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/clientes?q=silva&etiqueta=trabalhista" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/clientes?q=silva&etiqueta=trabalhista", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/clientes?q=silva&etiqueta=trabalhista",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
      "tipo": "PF",
      "nome": "Maria da Silva Souza",
      "documento": "***.982.247-**",
      "rg": "",
      "dataNascimento": "1985-03-14",
      "nomeFantasia": "",
      "inscricaoEstadual": "",
      "representanteLegal": "",
      "telefone": "(99) 98888-7777",
      "telefone2": "",
      "email": "maria@example.com",
      "cep": null,
      "logradouro": null,
      "numero": null,
      "complemento": null,
      "bairro": null,
      "cidade": "Timon",
      "uf": "MA",
      "observacoes": "Prefere contato por WhatsApp.",
      "etiquetas": [
        "trabalhista"
      ],
      "link": "https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
      "criadoEm": "2026-10-01T14:30:00.000Z",
      "camposOcultos": [
        "documento",
        "rg",
        "cep",
        "logradouro",
        "numero",
        "complemento",
        "bairro"
      ]
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (24)
  • idtextosempre presente

    Identificador único do cliente.

  • tipotextosempre presente

    PF (pessoa física) ou PJ (pessoa jurídica).

    Valores aceitos: PF PJ

  • nometextosempre presente

    Nome completo (PF) ou razão social (PJ).

  • documentotextosempre presente

    CPF ou CNPJ MASCARADO (CPF: *.982.247-, CNPJ: 52.998.224/**-), ou vazio quando não cadastrado. O número completo nunca é devolvido.

  • rgtextosempre presente

    RG MASCARADO (só os 2 últimos caracteres), ou vazio quando não cadastrado.

  • dataNascimentodata (AAAA-MM-DD), ou nulosempre presente

    Data de nascimento (AAAA-MM-DD), ou nulo.

  • nomeFantasiatextosempre presente

    Nome fantasia (pessoa jurídica), ou vazio.

  • inscricaoEstadualtextosempre presente

    Inscrição estadual (pessoa jurídica), ou vazio.

  • representanteLegaltextosempre presente

    Representante legal (pessoa jurídica), ou vazio.

  • telefonetextosempre presente

    Telefone principal, ou vazio.

  • telefone2textosempre presente

    Telefone secundário, ou vazio.

  • emailtextosempre presente

    E-mail, ou vazio.

  • ceptexto, ou nulosempre presente

    Sempre nulo: o endereço de rua não é devolvido pela API (privacidade).

  • logradourotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • numerotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • complementotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • bairrotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • cidadetextosempre presente

    Cidade.

  • uftextosempre presente

    Sigla do estado, ou vazio.

  • observacoestextosempre presente

    Anotações internas.

  • etiquetaslista de textossempre presente

    Etiquetas livres.

  • camposOcultoslista de textossempre presente

    Campos que a API não devolve por privacidade (ou devolve mascarados). Eles continuam podendo ser enviados ao cadastrar ou alterar um cliente.

  • linkendereço (URL)sempre presente

    Endereço do cliente dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Quando o cadastro foi criado (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

POST/clientes

Cadastrar um cliente

#
escopo escreverclientes.criar

Cadastra um cliente. O registro aparece na hora no sistema, igual a um cliente cadastrado pela tela. Use o cabeçalho Idempotency-Key para repetir a chamada com segurança, sem duplicar o cadastro.

Cabeçalho opcional Idempotency-Key: repete a chamada sem duplicar. Veja Idempotência.

Corpo da requisição (JSON)
  • tipotexto

    PF (pessoa física) ou PJ (pessoa jurídica). Se omitido, é deduzido do documento (11 dígitos = PF, 14 = PJ); sem documento, PF.

    Valores aceitos: PF PJ

  • nometextoobrigatório

    Nome completo (PF) ou razão social (PJ).

    1 a 160 caracteres

  • documentotexto

    CPF (PF) ou CNPJ (PJ). Aceita com ou sem pontuação e é validado pelos dígitos verificadores. Vazio remove.

    até 20 caracteres

  • rgtexto

    RG, só para pessoa física.

    até 30 caracteres

  • dataNascimentodata (AAAA-MM-DD), ou nulo

    Data de nascimento (AAAA-MM-DD). Nulo remove.

  • nomeFantasiatexto

    Nome fantasia, para pessoa jurídica.

    até 160 caracteres

  • inscricaoEstadualtexto

    Inscrição estadual, para pessoa jurídica.

    até 30 caracteres

  • representanteLegaltexto

    Representante legal, para pessoa jurídica.

    até 160 caracteres

  • telefonetexto

    Telefone principal, com DDD (10 ou 11 dígitos; o prefixo 55 é aceito e removido).

    até 25 caracteres

  • telefone2texto

    Telefone secundário, com DDD.

    até 25 caracteres

  • emailtexto

    E-mail do cliente.

    até 160 caracteres

  • ceptexto

    CEP (8 dígitos).

    até 10 caracteres

  • logradourotexto

    Rua, avenida etc.

    até 160 caracteres

  • numerotexto

    Número do endereço.

    até 20 caracteres

  • complementotexto

    Complemento do endereço.

    até 80 caracteres

  • bairrotexto

    Bairro.

    até 80 caracteres

  • cidadetexto

    Cidade.

    até 80 caracteres

  • uftexto

    Sigla do estado (vazio se não informado).

    Valores aceitos: AC AL AM AP BA CE DF ES GO MA MG MS MT PA PB PE PI PR RJ RN RO RR RS SC SE SP TO

  • observacoestexto

    Anotações internas sobre o cliente.

    até 5000 caracteres

  • etiquetaslista de textos

    Etiquetas livres (até 20).

    até 20 itens

Exemplo de chamada

curl

curl -X POST "https://app.jurispark.com.br/api/v1/clientes" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: exemplo-criarCliente-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "tipo": "PF",
  "nome": "Maria da Silva Souza",
  "documento": "529.982.247-25",
  "telefone": "(99) 98888-7777",
  "email": "maria@example.com",
  "cidade": "Timon",
  "uf": "MA",
  "etiquetas": [
    "trabalhista"
  ]
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/clientes", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": "exemplo-criarCliente-0001",
  },
  body: JSON.stringify({
    "tipo": "PF",
    "nome": "Maria da Silva Souza",
    "documento": "529.982.247-25",
    "telefone": "(99) 98888-7777",
    "email": "maria@example.com",
    "cidade": "Timon",
    "uf": "MA",
    "etiquetas": [
      "trabalhista"
    ]
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/clientes",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": "exemplo-criarCliente-0001",
    },
    json={
        "tipo": "PF",
        "nome": "Maria da Silva Souza",
        "documento": "529.982.247-25",
        "telefone": "(99) 98888-7777",
        "email": "maria@example.com",
        "cidade": "Timon",
        "uf": "MA",
        "etiquetas": [
            "trabalhista",
        ],
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
201 Criado. Exemplo de resposta
Resposta 201 Created
{
  "data": {
    "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "tipo": "PF",
    "nome": "Maria da Silva Souza",
    "documento": "***.982.247-**",
    "rg": "",
    "dataNascimento": "1985-03-14",
    "nomeFantasia": "",
    "inscricaoEstadual": "",
    "representanteLegal": "",
    "telefone": "(99) 98888-7777",
    "telefone2": "",
    "email": "maria@example.com",
    "cep": null,
    "logradouro": null,
    "numero": null,
    "complemento": null,
    "bairro": null,
    "cidade": "Timon",
    "uf": "MA",
    "observacoes": "Prefere contato por WhatsApp.",
    "etiquetas": [
      "trabalhista"
    ],
    "link": "https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "criadoEm": "2026-10-01T14:30:00.000Z",
    "camposOcultos": [
      "documento",
      "rg",
      "cep",
      "logradouro",
      "numero",
      "complemento",
      "bairro"
    ]
  }
}
Campos da resposta (24)
  • idtextosempre presente

    Identificador único do cliente.

  • tipotextosempre presente

    PF (pessoa física) ou PJ (pessoa jurídica).

    Valores aceitos: PF PJ

  • nometextosempre presente

    Nome completo (PF) ou razão social (PJ).

  • documentotextosempre presente

    CPF ou CNPJ MASCARADO (CPF: *.982.247-, CNPJ: 52.998.224/**-), ou vazio quando não cadastrado. O número completo nunca é devolvido.

  • rgtextosempre presente

    RG MASCARADO (só os 2 últimos caracteres), ou vazio quando não cadastrado.

  • dataNascimentodata (AAAA-MM-DD), ou nulosempre presente

    Data de nascimento (AAAA-MM-DD), ou nulo.

  • nomeFantasiatextosempre presente

    Nome fantasia (pessoa jurídica), ou vazio.

  • inscricaoEstadualtextosempre presente

    Inscrição estadual (pessoa jurídica), ou vazio.

  • representanteLegaltextosempre presente

    Representante legal (pessoa jurídica), ou vazio.

  • telefonetextosempre presente

    Telefone principal, ou vazio.

  • telefone2textosempre presente

    Telefone secundário, ou vazio.

  • emailtextosempre presente

    E-mail, ou vazio.

  • ceptexto, ou nulosempre presente

    Sempre nulo: o endereço de rua não é devolvido pela API (privacidade).

  • logradourotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • numerotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • complementotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • bairrotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • cidadetextosempre presente

    Cidade.

  • uftextosempre presente

    Sigla do estado, ou vazio.

  • observacoestextosempre presente

    Anotações internas.

  • etiquetaslista de textossempre presente

    Etiquetas livres.

  • camposOcultoslista de textossempre presente

    Campos que a API não devolve por privacidade (ou devolve mascarados). Eles continuam podendo ser enviados ao cadastrar ou alterar um cliente.

  • linkendereço (URL)sempre presente

    Endereço do cliente dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Quando o cadastro foi criado (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 413 415 422 429 500

GET/clientes/{id}

Ver um cliente

#
escopo lerclientes.ver

Devolve os dados de um cliente pelo id.

Parâmetro do caminho
  • idtextoobrigatório

    Id do cliente.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "tipo": "PF",
    "nome": "Maria da Silva Souza",
    "documento": "***.982.247-**",
    "rg": "",
    "dataNascimento": "1985-03-14",
    "nomeFantasia": "",
    "inscricaoEstadual": "",
    "representanteLegal": "",
    "telefone": "(99) 98888-7777",
    "telefone2": "",
    "email": "maria@example.com",
    "cep": null,
    "logradouro": null,
    "numero": null,
    "complemento": null,
    "bairro": null,
    "cidade": "Timon",
    "uf": "MA",
    "observacoes": "Prefere contato por WhatsApp.",
    "etiquetas": [
      "trabalhista"
    ],
    "link": "https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "criadoEm": "2026-10-01T14:30:00.000Z",
    "camposOcultos": [
      "documento",
      "rg",
      "cep",
      "logradouro",
      "numero",
      "complemento",
      "bairro"
    ]
  }
}
Campos da resposta (24)
  • idtextosempre presente

    Identificador único do cliente.

  • tipotextosempre presente

    PF (pessoa física) ou PJ (pessoa jurídica).

    Valores aceitos: PF PJ

  • nometextosempre presente

    Nome completo (PF) ou razão social (PJ).

  • documentotextosempre presente

    CPF ou CNPJ MASCARADO (CPF: *.982.247-, CNPJ: 52.998.224/**-), ou vazio quando não cadastrado. O número completo nunca é devolvido.

  • rgtextosempre presente

    RG MASCARADO (só os 2 últimos caracteres), ou vazio quando não cadastrado.

  • dataNascimentodata (AAAA-MM-DD), ou nulosempre presente

    Data de nascimento (AAAA-MM-DD), ou nulo.

  • nomeFantasiatextosempre presente

    Nome fantasia (pessoa jurídica), ou vazio.

  • inscricaoEstadualtextosempre presente

    Inscrição estadual (pessoa jurídica), ou vazio.

  • representanteLegaltextosempre presente

    Representante legal (pessoa jurídica), ou vazio.

  • telefonetextosempre presente

    Telefone principal, ou vazio.

  • telefone2textosempre presente

    Telefone secundário, ou vazio.

  • emailtextosempre presente

    E-mail, ou vazio.

  • ceptexto, ou nulosempre presente

    Sempre nulo: o endereço de rua não é devolvido pela API (privacidade).

  • logradourotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • numerotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • complementotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • bairrotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • cidadetextosempre presente

    Cidade.

  • uftextosempre presente

    Sigla do estado, ou vazio.

  • observacoestextosempre presente

    Anotações internas.

  • etiquetaslista de textossempre presente

    Etiquetas livres.

  • camposOcultoslista de textossempre presente

    Campos que a API não devolve por privacidade (ou devolve mascarados). Eles continuam podendo ser enviados ao cadastrar ou alterar um cliente.

  • linkendereço (URL)sempre presente

    Endereço do cliente dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Quando o cadastro foi criado (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 401 403 404 429 500

PATCH/clientes/{id}

Alterar um cliente

#
escopo escreverclientes.verclientes.editar

Altera só os campos enviados. Texto vazio limpa o campo. Não há rota para apagar clientes: quem exclui é o usuário, dentro do sistema.

Parâmetro do caminho
  • idtextoobrigatório

    Id do cliente.

Corpo da requisição (JSON)
  • tipotexto

    PF (pessoa física) ou PJ (pessoa jurídica). Se omitido, é deduzido do documento (11 dígitos = PF, 14 = PJ); sem documento, PF.

    Valores aceitos: PF PJ

  • nometexto

    Nome completo (PF) ou razão social (PJ).

    1 a 160 caracteres

  • documentotexto

    CPF (PF) ou CNPJ (PJ). Aceita com ou sem pontuação e é validado pelos dígitos verificadores. Vazio remove.

    até 20 caracteres

  • rgtexto

    RG, só para pessoa física.

    até 30 caracteres

  • dataNascimentodata (AAAA-MM-DD), ou nulo

    Data de nascimento (AAAA-MM-DD). Nulo remove.

  • nomeFantasiatexto

    Nome fantasia, para pessoa jurídica.

    até 160 caracteres

  • inscricaoEstadualtexto

    Inscrição estadual, para pessoa jurídica.

    até 30 caracteres

  • representanteLegaltexto

    Representante legal, para pessoa jurídica.

    até 160 caracteres

  • telefonetexto

    Telefone principal, com DDD (10 ou 11 dígitos; o prefixo 55 é aceito e removido).

    até 25 caracteres

  • telefone2texto

    Telefone secundário, com DDD.

    até 25 caracteres

  • emailtexto

    E-mail do cliente.

    até 160 caracteres

  • ceptexto

    CEP (8 dígitos).

    até 10 caracteres

  • logradourotexto

    Rua, avenida etc.

    até 160 caracteres

  • numerotexto

    Número do endereço.

    até 20 caracteres

  • complementotexto

    Complemento do endereço.

    até 80 caracteres

  • bairrotexto

    Bairro.

    até 80 caracteres

  • cidadetexto

    Cidade.

    até 80 caracteres

  • uftexto

    Sigla do estado (vazio se não informado).

    Valores aceitos: AC AL AM AP BA CE DF ES GO MA MG MS MT PA PB PE PI PR RJ RN RO RR RS SC SE SP TO

  • observacoestexto

    Anotações internas sobre o cliente.

    até 5000 caracteres

  • etiquetaslista de textos

    Etiquetas livres (até 20).

    até 20 itens

Exemplo de chamada

curl

curl -X PATCH "https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "telefone": "(99) 97777-6666",
  "observacoes": "Mudou de telefone em outubro."
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "telefone": "(99) 97777-6666",
    "observacoes": "Mudou de telefone em outubro."
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.patch(
    "https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    json={
        "telefone": "(99) 97777-6666",
        "observacoes": "Mudou de telefone em outubro.",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "tipo": "PF",
    "nome": "Maria da Silva Souza",
    "documento": "***.982.247-**",
    "rg": "",
    "dataNascimento": "1985-03-14",
    "nomeFantasia": "",
    "inscricaoEstadual": "",
    "representanteLegal": "",
    "telefone": "(99) 98888-7777",
    "telefone2": "",
    "email": "maria@example.com",
    "cep": null,
    "logradouro": null,
    "numero": null,
    "complemento": null,
    "bairro": null,
    "cidade": "Timon",
    "uf": "MA",
    "observacoes": "Prefere contato por WhatsApp.",
    "etiquetas": [
      "trabalhista"
    ],
    "link": "https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
    "criadoEm": "2026-10-01T14:30:00.000Z",
    "camposOcultos": [
      "documento",
      "rg",
      "cep",
      "logradouro",
      "numero",
      "complemento",
      "bairro"
    ]
  }
}
Campos da resposta (24)
  • idtextosempre presente

    Identificador único do cliente.

  • tipotextosempre presente

    PF (pessoa física) ou PJ (pessoa jurídica).

    Valores aceitos: PF PJ

  • nometextosempre presente

    Nome completo (PF) ou razão social (PJ).

  • documentotextosempre presente

    CPF ou CNPJ MASCARADO (CPF: *.982.247-, CNPJ: 52.998.224/**-), ou vazio quando não cadastrado. O número completo nunca é devolvido.

  • rgtextosempre presente

    RG MASCARADO (só os 2 últimos caracteres), ou vazio quando não cadastrado.

  • dataNascimentodata (AAAA-MM-DD), ou nulosempre presente

    Data de nascimento (AAAA-MM-DD), ou nulo.

  • nomeFantasiatextosempre presente

    Nome fantasia (pessoa jurídica), ou vazio.

  • inscricaoEstadualtextosempre presente

    Inscrição estadual (pessoa jurídica), ou vazio.

  • representanteLegaltextosempre presente

    Representante legal (pessoa jurídica), ou vazio.

  • telefonetextosempre presente

    Telefone principal, ou vazio.

  • telefone2textosempre presente

    Telefone secundário, ou vazio.

  • emailtextosempre presente

    E-mail, ou vazio.

  • ceptexto, ou nulosempre presente

    Sempre nulo: o endereço de rua não é devolvido pela API (privacidade).

  • logradourotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • numerotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • complementotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • bairrotexto, ou nulosempre presente

    Sempre nulo (privacidade).

  • cidadetextosempre presente

    Cidade.

  • uftextosempre presente

    Sigla do estado, ou vazio.

  • observacoestextosempre presente

    Anotações internas.

  • etiquetaslista de textossempre presente

    Etiquetas livres.

  • camposOcultoslista de textossempre presente

    Campos que a API não devolve por privacidade (ou devolve mascarados). Eles continuam podendo ser enviados ao cadastrar ou alterar um cliente.

  • linkendereço (URL)sempre presente

    Endereço do cliente dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Quando o cadastro foi criado (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 404 413 415 429 500

Processos

Processos e andamentos.

GET/processos

Listar processos

#
escopo lerprocessos.ver

Lista os processos (do mais recentemente atualizado para o mais antigo), com filtros e paginação por cursor. Processos excluídos pelo usuário não aparecem.

Parâmetros de consulta (todos opcionais)
  • qtexto

    Busca em título, número CNJ (com ou sem pontuação), tipo de ação, parte contrária, tribunal, etiquetas e nome do cliente.

    1 a 100 caracteres

  • statustexto

    Situação do processo (ativo, em_recurso, suspenso, arquivado, encerrado).

    1 a 30 caracteres

  • clientetexto

    Só processos deste cliente (id).

    1 a 80 caracteres

  • areatexto

    Área do direito (por exemplo: Trabalhista).

    1 a 40 caracteres

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/processos?q=souza&status=ativo" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/processos?q=souza&status=ativo", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/processos?q=souza&status=ativo",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "numeroCnj": "0001234-56.2024.8.10.0001",
      "titulo": "Souza x Empresa Exemplo",
      "natureza": "judicial",
      "area": "Trabalhista",
      "tipoAcao": "Reclamação trabalhista",
      "status": "ativo",
      "tribunal": "TJMA",
      "comarca": "Timon",
      "vara": "1ª Vara",
      "juiz": "",
      "url": "",
      "valorCausa": 25000,
      "dataDistribuicao": "2024-05-20",
      "parteContraria": "Empresa Exemplo Ltda",
      "advogadoParteContraria": "",
      "clientes": [
        {
          "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
          "nome": "Maria da Silva Souza",
          "papel": "Autor"
        }
      ],
      "advogados": [
        {
          "id": "0191c3a2-1111-7000-8000-00000000a001",
          "nome": "Dr. Exemplo",
          "papel": "Responsável"
        }
      ],
      "etapa": {
        "id": "st-post",
        "nome": "Fase postulatória"
      },
      "processoPrincipalId": null,
      "instancia": "1º grau",
      "fase": "Conhecimento",
      "etiquetas": [],
      "observacoes": "",
      "link": "https://app.jurispark.com.br/lawyer/lawsuits/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "criadoEm": "2026-09-20T12:00:00.000Z",
      "atualizadoEm": "2026-10-05T18:10:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (35)
  • idtextosempre presente

    Identificador único do processo.

  • numeroCnjtextosempre presente

    Número CNJ (vazio para processos administrativos ou sem número).

  • titulotextosempre presente

    Título do processo.

  • naturezatextosempre presente

    Natureza do processo.

    Valores aceitos: judicial administrativo

  • areatextosempre presente

    Área do direito.

  • tipoAcaotextosempre presente

    Tipo de ação.

  • statustextosempre presente

    Situação do processo (por exemplo: ativo, em_recurso, suspenso, arquivado, encerrado).

  • tribunaltextosempre presente

    Tribunal.

  • comarcatextosempre presente

    Comarca.

  • varatextosempre presente

    Vara ou órgão.

  • juiztextosempre presente

    Juiz.

  • urltextosempre presente

    Endereço do processo no sistema do tribunal, se cadastrado.

  • valorCausanúmerosempre presente

    Valor da causa em reais.

  • dataDistribuicaodata (AAAA-MM-DD), ou nulosempre presente

    Data de distribuição (AAAA-MM-DD), ou nulo.

  • parteContrariatextosempre presente

    Parte contrária.

  • advogadoParteContrariatextosempre presente

    Advogado da parte contrária.

  • clienteslista de objetossempre presente

    Clientes vinculados.

  • clientes[].idtextosempre presente

    Identificador do cliente.

  • clientes[].nometexto, ou nulosempre presente

    Nome do cliente (nulo se o usuário da chave não pode ver clientes).

  • clientes[].papeltextosempre presente

    Papel na ação (Autor, Réu, Terceiro, Interessado ou Outro).

  • advogadoslista de objetossempre presente

    Advogados vinculados.

  • advogados[].idtextosempre presente

    Identificador do usuário.

  • advogados[].nometexto, ou nulosempre presente

    Nome do advogado.

  • advogados[].papeltextosempre presente

    Responsável ou Participante.

  • etapaobjeto, ou nulosempre presente

    Etapa do funil de processos, ou nulo.

  • etapa.idtextosempre presente

    Identificador da etapa.

  • etapa.nometextosempre presente

    Nome da etapa.

  • processoPrincipalIdtexto, ou nulosempre presente

    Id do processo principal, quando este é um incidente ou recurso.

  • instanciatextosempre presente

    Instância.

  • fasetextosempre presente

    Fase.

  • etiquetaslista de textossempre presente

    Etiquetas.

  • observacoestextosempre presente

    Observações internas.

  • linkendereço (URL)sempre presente

    Endereço do processo dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

  • atualizadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Última atualização (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

GET/processos/{id}

Ver um processo

#
escopo lerprocessos.ver

Devolve os dados de um processo pelo id.

Parâmetro do caminho
  • idtextoobrigatório

    Id do processo.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    "numeroCnj": "0001234-56.2024.8.10.0001",
    "titulo": "Souza x Empresa Exemplo",
    "natureza": "judicial",
    "area": "Trabalhista",
    "tipoAcao": "Reclamação trabalhista",
    "status": "ativo",
    "tribunal": "TJMA",
    "comarca": "Timon",
    "vara": "1ª Vara",
    "juiz": "",
    "url": "",
    "valorCausa": 25000,
    "dataDistribuicao": "2024-05-20",
    "parteContraria": "Empresa Exemplo Ltda",
    "advogadoParteContraria": "",
    "clientes": [
      {
        "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
        "nome": "Maria da Silva Souza",
        "papel": "Autor"
      }
    ],
    "advogados": [
      {
        "id": "0191c3a2-1111-7000-8000-00000000a001",
        "nome": "Dr. Exemplo",
        "papel": "Responsável"
      }
    ],
    "etapa": {
      "id": "st-post",
      "nome": "Fase postulatória"
    },
    "processoPrincipalId": null,
    "instancia": "1º grau",
    "fase": "Conhecimento",
    "etiquetas": [],
    "observacoes": "",
    "link": "https://app.jurispark.com.br/lawyer/lawsuits/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    "criadoEm": "2026-09-20T12:00:00.000Z",
    "atualizadoEm": "2026-10-05T18:10:00.000Z"
  }
}
Campos da resposta (35)
  • idtextosempre presente

    Identificador único do processo.

  • numeroCnjtextosempre presente

    Número CNJ (vazio para processos administrativos ou sem número).

  • titulotextosempre presente

    Título do processo.

  • naturezatextosempre presente

    Natureza do processo.

    Valores aceitos: judicial administrativo

  • areatextosempre presente

    Área do direito.

  • tipoAcaotextosempre presente

    Tipo de ação.

  • statustextosempre presente

    Situação do processo (por exemplo: ativo, em_recurso, suspenso, arquivado, encerrado).

  • tribunaltextosempre presente

    Tribunal.

  • comarcatextosempre presente

    Comarca.

  • varatextosempre presente

    Vara ou órgão.

  • juiztextosempre presente

    Juiz.

  • urltextosempre presente

    Endereço do processo no sistema do tribunal, se cadastrado.

  • valorCausanúmerosempre presente

    Valor da causa em reais.

  • dataDistribuicaodata (AAAA-MM-DD), ou nulosempre presente

    Data de distribuição (AAAA-MM-DD), ou nulo.

  • parteContrariatextosempre presente

    Parte contrária.

  • advogadoParteContrariatextosempre presente

    Advogado da parte contrária.

  • clienteslista de objetossempre presente

    Clientes vinculados.

  • clientes[].idtextosempre presente

    Identificador do cliente.

  • clientes[].nometexto, ou nulosempre presente

    Nome do cliente (nulo se o usuário da chave não pode ver clientes).

  • clientes[].papeltextosempre presente

    Papel na ação (Autor, Réu, Terceiro, Interessado ou Outro).

  • advogadoslista de objetossempre presente

    Advogados vinculados.

  • advogados[].idtextosempre presente

    Identificador do usuário.

  • advogados[].nometexto, ou nulosempre presente

    Nome do advogado.

  • advogados[].papeltextosempre presente

    Responsável ou Participante.

  • etapaobjeto, ou nulosempre presente

    Etapa do funil de processos, ou nulo.

  • etapa.idtextosempre presente

    Identificador da etapa.

  • etapa.nometextosempre presente

    Nome da etapa.

  • processoPrincipalIdtexto, ou nulosempre presente

    Id do processo principal, quando este é um incidente ou recurso.

  • instanciatextosempre presente

    Instância.

  • fasetextosempre presente

    Fase.

  • etiquetaslista de textossempre presente

    Etiquetas.

  • observacoestextosempre presente

    Observações internas.

  • linkendereço (URL)sempre presente

    Endereço do processo dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

  • atualizadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Última atualização (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 401 403 404 429 500

GET/processos/{id}/andamentos

Listar andamentos de um processo

#
escopo lerprocessos.verandamentos.ver

Histórico de andamentos de um processo, do mais recente para o mais antigo.

Parâmetro do caminho
  • idtextoobrigatório

    Id do processo.

Parâmetros de consulta (todos opcionais)

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-9b22-7e30-9c33-1d4f8a2b6c03",
      "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "data": "2026-10-05",
      "titulo": "Juntada de contestação",
      "descricao": "Contestação protocolada pela parte contrária.",
      "origem": "Manual",
      "prazo": "2026-10-20",
      "criadoEm": "2026-10-05T18:10:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (8)
  • idtextosempre presente

    Identificador único do andamento.

  • processoIdtextosempre presente

    Processo ao qual o andamento pertence.

  • datadata (AAAA-MM-DD)sempre presente

    Data do andamento (AAAA-MM-DD).

  • titulotextosempre presente

    Título.

  • descricaotextosempre presente

    Descrição.

  • origemtextosempre presente

    De onde veio o andamento.

    Valores aceitos: Manual DJEN DataJud

  • prazodata (AAAA-MM-DD), ou nulosempre presente

    Prazo gerado pelo andamento (AAAA-MM-DD), ou nulo.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 404 429 500

POST/processos/{id}/andamentos

Registrar um andamento

#
escopo escreverprocessos.verandamentos.criar

Registra um andamento manual em um processo e atualiza a data de atualização do processo, como o sistema faz. Use Idempotency-Key para não duplicar em caso de nova tentativa.

Cabeçalho opcional Idempotency-Key: repete a chamada sem duplicar. Veja Idempotência.

Parâmetro do caminho
  • idtextoobrigatório

    Id do processo.

Corpo da requisição (JSON)
  • titulotextoobrigatório

    Título curto do andamento.

    1 a 200 caracteres

  • datadata (AAAA-MM-DD)

    Data do andamento (AAAA-MM-DD). Padrão: hoje (horário de Brasília).

  • descricaotexto

    Detalhes do andamento.

    até 3000 caracteres

  • prazodata (AAAA-MM-DD)

    Prazo decorrente do andamento (AAAA-MM-DD), se houver.

Exemplo de chamada

curl

curl -X POST "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: exemplo-criarAndamento-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Juntada de contestação",
  "data": "2026-10-05",
  "descricao": "Contestação protocolada pela parte contrária.",
  "prazo": "2026-10-20"
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": "exemplo-criarAndamento-0001",
  },
  body: JSON.stringify({
    "titulo": "Juntada de contestação",
    "data": "2026-10-05",
    "descricao": "Contestação protocolada pela parte contrária.",
    "prazo": "2026-10-20"
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/processos/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02/andamentos",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": "exemplo-criarAndamento-0001",
    },
    json={
        "titulo": "Juntada de contestação",
        "data": "2026-10-05",
        "descricao": "Contestação protocolada pela parte contrária.",
        "prazo": "2026-10-20",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
201 Criado. Exemplo de resposta
Resposta 201 Created
{
  "data": {
    "id": "0191c3a2-9b22-7e30-9c33-1d4f8a2b6c03",
    "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    "data": "2026-10-05",
    "titulo": "Juntada de contestação",
    "descricao": "Contestação protocolada pela parte contrária.",
    "origem": "Manual",
    "prazo": "2026-10-20",
    "criadoEm": "2026-10-05T18:10:00.000Z"
  }
}
Campos da resposta (8)
  • idtextosempre presente

    Identificador único do andamento.

  • processoIdtextosempre presente

    Processo ao qual o andamento pertence.

  • datadata (AAAA-MM-DD)sempre presente

    Data do andamento (AAAA-MM-DD).

  • titulotextosempre presente

    Título.

  • descricaotextosempre presente

    Descrição.

  • origemtextosempre presente

    De onde veio o andamento.

    Valores aceitos: Manual DJEN DataJud

  • prazodata (AAAA-MM-DD), ou nulosempre presente

    Prazo gerado pelo andamento (AAAA-MM-DD), ou nulo.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 404 413 415 422 429 500

Tarefas

Tarefas do escritório.

GET/tarefas

Listar tarefas

#
escopo lertarefas.ver

Lista as tarefas do escritório por prazo (as sem prazo vão para o fim), com filtros e paginação por cursor.

Parâmetros de consulta (todos opcionais)
  • qtexto

    Busca no título e na descrição.

    1 a 100 caracteres

  • statustexto

    Situação. "abertas" reúne tudo que não está concluído.

    Valores aceitos: abertas pendente andamento revisao concluida

  • responsaveltexto

    "eu" (o dono da chave) ou o id de um usuário.

    1 a 80 caracteres

  • prioridadetexto

    Prioridade.

    Valores aceitos: baixa media alta urgente

  • processotexto

    Só tarefas deste processo (id).

    1 a 80 caracteres

  • clientetexto

    Só tarefas deste cliente (id).

    1 a 80 caracteres

  • fromdata (AAAA-MM-DD)

    Só com prazo a partir desta data (AAAA-MM-DD).

  • todata (AAAA-MM-DD)

    Só com prazo até esta data (AAAA-MM-DD).

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/tarefas?q=r%C3%A9plica&status=abertas" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas?q=r%C3%A9plica&status=abertas", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/tarefas?q=r%C3%A9plica&status=abertas",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
      "titulo": "Preparar réplica",
      "descricao": "Revisar a contestação e redigir a réplica.",
      "prioridade": "alta",
      "status": "pendente",
      "prazo": "2026-10-18",
      "responsavel": {
        "id": "0191c3a2-1111-7000-8000-00000000a001",
        "nome": "Dr. Exemplo"
      },
      "processo": {
        "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
        "numeroCnj": "0001234-56.2024.8.10.0001",
        "titulo": "Souza x Empresa Exemplo"
      },
      "cliente": {
        "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
        "nome": "Maria da Silva Souza"
      },
      "etiquetas": [],
      "checklist": [
        {
          "id": "0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05",
          "texto": "Ler a contestação",
          "feito": false
        }
      ],
      "totalComentarios": 0,
      "link": "https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
      "criadoEm": "2026-10-05T18:20:00.000Z",
      "atualizadoEm": "2026-10-05T18:20:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (25)
  • idtextosempre presente

    Identificador único da tarefa.

  • titulotextosempre presente

    Título.

  • descricaotextosempre presente

    Descrição.

  • prioridadetextosempre presente

    Prioridade.

    Valores aceitos: baixa media alta urgente

  • statustextosempre presente

    Situação.

    Valores aceitos: pendente andamento revisao concluida

  • prazodata (AAAA-MM-DD), ou nulosempre presente

    Prazo (AAAA-MM-DD), ou nulo.

  • responsavelobjeto, ou nulosempre presente

    Responsável pela tarefa, ou nulo.

  • responsavel.idtextosempre presente

    Identificador do usuário.

  • responsavel.nometextosempre presente

    Nome do usuário.

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • etiquetaslista de textossempre presente

    Etiquetas.

  • checklistlista de objetossempre presente

    Itens da lista de verificação.

  • checklist[].idtextosempre presente

    Identificador do item.

  • checklist[].textotextosempre presente

    Texto do item.

  • checklist[].feitoverdadeiro ou falsosempre presente

    Se o item foi concluído.

  • totalComentariosnúmero inteirosempre presente

    Quantidade de comentários.

  • linkendereço (URL)sempre presente

    Endereço da tarefa dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

  • atualizadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Última atualização (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

POST/tarefas

Criar uma tarefa

#
escopo escrevertarefas.criar

Cria uma tarefa. Sem responsavelId, a tarefa fica com o usuário dono da chave. Use Idempotency-Key para não duplicar em caso de nova tentativa.

Cabeçalho opcional Idempotency-Key: repete a chamada sem duplicar. Veja Idempotência.

Corpo da requisição (JSON)
  • titulotextoobrigatório

    Título curto da tarefa.

    1 a 200 caracteres

  • descricaotexto

    Detalhes.

    até 5000 caracteres

  • prazodata (AAAA-MM-DD)

    Prazo (AAAA-MM-DD).

  • prioridadetexto

    Prioridade. Padrão: media.

    Valores aceitos: baixa media alta urgente

  • responsavelIdtexto

    Id do usuário responsável. Padrão: o usuário dono da chave. Atribuir a outra pessoa exige a permissão de atribuir tarefas.

    até 80 caracteres

  • processoIdtexto

    Processo relacionado.

    até 80 caracteres

  • clienteIdtexto

    Cliente relacionado.

    até 80 caracteres

  • etiquetaslista de textos

    Etiquetas (até 20).

    até 20 itens

  • checklistlista de textos

    Itens da lista de verificação (até 30).

    até 30 itens

Exemplo de chamada

curl

curl -X POST "https://app.jurispark.com.br/api/v1/tarefas" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: exemplo-criarTarefa-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Preparar réplica",
  "descricao": "Revisar a contestação e redigir a réplica.",
  "prazo": "2026-10-18",
  "prioridade": "alta",
  "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
  "checklist": [
    "Ler a contestação"
  ]
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": "exemplo-criarTarefa-0001",
  },
  body: JSON.stringify({
    "titulo": "Preparar réplica",
    "descricao": "Revisar a contestação e redigir a réplica.",
    "prazo": "2026-10-18",
    "prioridade": "alta",
    "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    "checklist": [
      "Ler a contestação"
    ]
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/tarefas",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": "exemplo-criarTarefa-0001",
    },
    json={
        "titulo": "Preparar réplica",
        "descricao": "Revisar a contestação e redigir a réplica.",
        "prazo": "2026-10-18",
        "prioridade": "alta",
        "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
        "checklist": [
            "Ler a contestação",
        ],
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
201 Criado. Exemplo de resposta
Resposta 201 Created
{
  "data": {
    "id": "0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
    "titulo": "Preparar réplica",
    "descricao": "Revisar a contestação e redigir a réplica.",
    "prioridade": "alta",
    "status": "pendente",
    "prazo": "2026-10-18",
    "responsavel": {
      "id": "0191c3a2-1111-7000-8000-00000000a001",
      "nome": "Dr. Exemplo"
    },
    "processo": {
      "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "numeroCnj": "0001234-56.2024.8.10.0001",
      "titulo": "Souza x Empresa Exemplo"
    },
    "cliente": {
      "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
      "nome": "Maria da Silva Souza"
    },
    "etiquetas": [],
    "checklist": [
      {
        "id": "0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05",
        "texto": "Ler a contestação",
        "feito": false
      }
    ],
    "totalComentarios": 0,
    "link": "https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
    "criadoEm": "2026-10-05T18:20:00.000Z",
    "atualizadoEm": "2026-10-05T18:20:00.000Z"
  }
}
Campos da resposta (25)
  • idtextosempre presente

    Identificador único da tarefa.

  • titulotextosempre presente

    Título.

  • descricaotextosempre presente

    Descrição.

  • prioridadetextosempre presente

    Prioridade.

    Valores aceitos: baixa media alta urgente

  • statustextosempre presente

    Situação.

    Valores aceitos: pendente andamento revisao concluida

  • prazodata (AAAA-MM-DD), ou nulosempre presente

    Prazo (AAAA-MM-DD), ou nulo.

  • responsavelobjeto, ou nulosempre presente

    Responsável pela tarefa, ou nulo.

  • responsavel.idtextosempre presente

    Identificador do usuário.

  • responsavel.nometextosempre presente

    Nome do usuário.

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • etiquetaslista de textossempre presente

    Etiquetas.

  • checklistlista de objetossempre presente

    Itens da lista de verificação.

  • checklist[].idtextosempre presente

    Identificador do item.

  • checklist[].textotextosempre presente

    Texto do item.

  • checklist[].feitoverdadeiro ou falsosempre presente

    Se o item foi concluído.

  • totalComentariosnúmero inteirosempre presente

    Quantidade de comentários.

  • linkendereço (URL)sempre presente

    Endereço da tarefa dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

  • atualizadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Última atualização (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 413 415 422 429 500

PATCH/tarefas/{id}

Alterar uma tarefa

#
escopo escrevertarefas.editar

Altera só os campos enviados (situação, prazo, prioridade, responsável, vínculos ou texto) e/ou acrescenta um comentário. Mudanças de prazo e de situação entram no histórico da tarefa. Não há rota para apagar tarefas.

Parâmetro do caminho
  • idtextoobrigatório

    Id da tarefa.

Corpo da requisição (JSON)
  • titulotexto

    Novo título.

    1 a 200 caracteres

  • descricaotexto

    Nova descrição.

    até 5000 caracteres

  • statustexto

    Nova situação.

    Valores aceitos: pendente andamento revisao concluida

  • prazodata (AAAA-MM-DD), ou nulo

    Novo prazo (AAAA-MM-DD). Nulo remove o prazo.

  • prioridadetexto

    Nova prioridade.

    Valores aceitos: baixa media alta urgente

  • responsavelIdtexto, ou nulo

    Novo responsável (id de usuário). Nulo remove. Exige a permissão de atribuir tarefas.

    até 80 caracteres

  • processoIdtexto, ou nulo

    Novo processo vinculado. Nulo desvincula.

    até 80 caracteres

  • clienteIdtexto, ou nulo

    Novo cliente vinculado. Nulo desvincula.

    até 80 caracteres

  • comentariotexto

    Comentário a acrescentar na tarefa.

    1 a 1000 caracteres

Exemplo de chamada

curl

curl -X PATCH "https://app.jurispark.com.br/api/v1/tarefas/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "concluida",
  "comentario": "Réplica protocolada."
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "status": "concluida",
    "comentario": "Réplica protocolada."
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.patch(
    "https://app.jurispark.com.br/api/v1/tarefas/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    json={
        "status": "concluida",
        "comentario": "Réplica protocolada.",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "id": "0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
    "titulo": "Preparar réplica",
    "descricao": "Revisar a contestação e redigir a réplica.",
    "prioridade": "alta",
    "status": "pendente",
    "prazo": "2026-10-18",
    "responsavel": {
      "id": "0191c3a2-1111-7000-8000-00000000a001",
      "nome": "Dr. Exemplo"
    },
    "processo": {
      "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "numeroCnj": "0001234-56.2024.8.10.0001",
      "titulo": "Souza x Empresa Exemplo"
    },
    "cliente": {
      "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
      "nome": "Maria da Silva Souza"
    },
    "etiquetas": [],
    "checklist": [
      {
        "id": "0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05",
        "texto": "Ler a contestação",
        "feito": false
      }
    ],
    "totalComentarios": 0,
    "link": "https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04",
    "criadoEm": "2026-10-05T18:20:00.000Z",
    "atualizadoEm": "2026-10-05T18:20:00.000Z"
  }
}
Campos da resposta (25)
  • idtextosempre presente

    Identificador único da tarefa.

  • titulotextosempre presente

    Título.

  • descricaotextosempre presente

    Descrição.

  • prioridadetextosempre presente

    Prioridade.

    Valores aceitos: baixa media alta urgente

  • statustextosempre presente

    Situação.

    Valores aceitos: pendente andamento revisao concluida

  • prazodata (AAAA-MM-DD), ou nulosempre presente

    Prazo (AAAA-MM-DD), ou nulo.

  • responsavelobjeto, ou nulosempre presente

    Responsável pela tarefa, ou nulo.

  • responsavel.idtextosempre presente

    Identificador do usuário.

  • responsavel.nometextosempre presente

    Nome do usuário.

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • etiquetaslista de textossempre presente

    Etiquetas.

  • checklistlista de objetossempre presente

    Itens da lista de verificação.

  • checklist[].idtextosempre presente

    Identificador do item.

  • checklist[].textotextosempre presente

    Texto do item.

  • checklist[].feitoverdadeiro ou falsosempre presente

    Se o item foi concluído.

  • totalComentariosnúmero inteirosempre presente

    Quantidade de comentários.

  • linkendereço (URL)sempre presente

    Endereço da tarefa dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

  • atualizadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Última atualização (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 404 413 415 429 500

Agenda

Compromissos, audiências e prazos.

GET/agenda

Listar a agenda

#
escopo leragenda.ver

Compromissos, audiências e prazos que tocam o período pedido (padrão: de hoje a 30 dias; no máximo 366 dias), em ordem de data e hora. Compromissos recorrentes aparecem uma vez, na data inicial. Cancelados só aparecem com status=cancelado.

Parâmetros de consulta (todos opcionais)
  • fromdata (AAAA-MM-DD)

    Início do período (AAAA-MM-DD). Padrão: hoje (horário de Brasília).

  • todata (AAAA-MM-DD)

    Fim do período (AAAA-MM-DD). Padrão: 30 dias depois de from.

  • tipotexto

    Tipo do compromisso.

    Valores aceitos: audiencia prazo_judicial prazo_interno reuniao compromisso diligencia pericia exigencia

  • statustexto

    Situação. Sem este filtro, os cancelados ficam de fora.

    Valores aceitos: agendado concluido cancelado

  • processotexto

    Só deste processo (id).

    1 a 80 caracteres

  • clientetexto

    Só deste cliente (id).

    1 a 80 caracteres

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/agenda?from=2026-10-01&to=2026-10-31" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/agenda?from=2026-10-01&to=2026-10-31", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/agenda?from=2026-10-01&to=2026-10-31",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-cc55-7b60-8f00-4a7c1d5e9f06",
      "tipo": "audiencia",
      "titulo": "Audiência de instrução",
      "data": "2026-11-12",
      "hora": "14:30",
      "dataFim": "2026-11-12",
      "horaFim": "15:30",
      "diaInteiro": false,
      "local": "Fórum de Timon, sala 3",
      "descricao": "",
      "status": "agendado",
      "recorrencia": "nenhuma",
      "processo": {
        "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
        "numeroCnj": "0001234-56.2024.8.10.0001",
        "titulo": "Souza x Empresa Exemplo"
      },
      "cliente": {
        "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
        "nome": "Maria da Silva Souza"
      },
      "link": "https://app.jurispark.com.br/lawyer/calendar",
      "criadoEm": "2026-10-05T18:30:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (21)
  • idtextosempre presente

    Identificador único do compromisso.

  • tipotextosempre presente

    Tipo.

    Valores aceitos: audiencia prazo_judicial prazo_interno reuniao compromisso diligencia pericia exigencia

  • titulotextosempre presente

    Título.

  • datadata (AAAA-MM-DD)sempre presente

    Data inicial (AAAA-MM-DD).

  • horahora (HH:MM), ou nulosempre presente

    Hora inicial (HH:MM, horário de Brasília), ou nulo se for o dia todo.

  • dataFimdata (AAAA-MM-DD)sempre presente

    Data final (AAAA-MM-DD).

  • horaFimhora (HH:MM), ou nulosempre presente

    Hora final (HH:MM), ou nulo.

  • diaInteiroverdadeiro ou falsosempre presente

    Verdadeiro quando não tem hora marcada.

  • localtextosempre presente

    Local.

  • descricaotextosempre presente

    Descrição.

  • statustextosempre presente

    Situação.

    Valores aceitos: agendado concluido cancelado

  • recorrenciatextosempre presente

    Repetição do compromisso. As repetições não são expandidas pela API: o item aparece uma vez, na data inicial.

    Valores aceitos: nenhuma diaria semanal quinzenal mensal anual

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • linkendereço (URL)sempre presente

    Endereço da agenda dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

POST/agenda

Criar um compromisso

#
escopo escreveragenda.criar

Cria um compromisso, audiência ou prazo na agenda. Os lembretes seguem o padrão configurado pelo escritório. Use Idempotency-Key para não duplicar em caso de nova tentativa.

Cabeçalho opcional Idempotency-Key: repete a chamada sem duplicar. Veja Idempotência.

Corpo da requisição (JSON)
  • tipotextoobrigatório

    Tipo do compromisso.

    Valores aceitos: audiencia prazo_judicial prazo_interno reuniao compromisso diligencia pericia exigencia

  • titulotextoobrigatório

    Título.

    1 a 200 caracteres

  • datadata (AAAA-MM-DD)obrigatório

    Data inicial (AAAA-MM-DD).

  • horahora (HH:MM)

    Hora inicial (HH:MM). Omita para compromisso de dia inteiro.

  • dataFimdata (AAAA-MM-DD)

    Data final (AAAA-MM-DD). Padrão: a mesma data inicial.

  • horaFimhora (HH:MM)

    Hora final (HH:MM).

  • localtexto

    Local.

    até 200 caracteres

  • descricaotexto

    Detalhes.

    até 2000 caracteres

  • processoIdtexto

    Processo relacionado.

    até 80 caracteres

  • clienteIdtexto

    Cliente relacionado.

    até 80 caracteres

Exemplo de chamada

curl

curl -X POST "https://app.jurispark.com.br/api/v1/agenda" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: exemplo-criarCompromisso-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "tipo": "audiencia",
  "titulo": "Audiência de instrução",
  "data": "2026-11-12",
  "hora": "14:30",
  "horaFim": "15:30",
  "local": "Fórum de Timon, sala 3",
  "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02"
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/agenda", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": "exemplo-criarCompromisso-0001",
  },
  body: JSON.stringify({
    "tipo": "audiencia",
    "titulo": "Audiência de instrução",
    "data": "2026-11-12",
    "hora": "14:30",
    "horaFim": "15:30",
    "local": "Fórum de Timon, sala 3",
    "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02"
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/agenda",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": "exemplo-criarCompromisso-0001",
    },
    json={
        "tipo": "audiencia",
        "titulo": "Audiência de instrução",
        "data": "2026-11-12",
        "hora": "14:30",
        "horaFim": "15:30",
        "local": "Fórum de Timon, sala 3",
        "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
201 Criado. Exemplo de resposta
Resposta 201 Created
{
  "data": {
    "id": "0191c3a2-cc55-7b60-8f00-4a7c1d5e9f06",
    "tipo": "audiencia",
    "titulo": "Audiência de instrução",
    "data": "2026-11-12",
    "hora": "14:30",
    "dataFim": "2026-11-12",
    "horaFim": "15:30",
    "diaInteiro": false,
    "local": "Fórum de Timon, sala 3",
    "descricao": "",
    "status": "agendado",
    "recorrencia": "nenhuma",
    "processo": {
      "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "numeroCnj": "0001234-56.2024.8.10.0001",
      "titulo": "Souza x Empresa Exemplo"
    },
    "cliente": {
      "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
      "nome": "Maria da Silva Souza"
    },
    "link": "https://app.jurispark.com.br/lawyer/calendar",
    "criadoEm": "2026-10-05T18:30:00.000Z"
  }
}
Campos da resposta (21)
  • idtextosempre presente

    Identificador único do compromisso.

  • tipotextosempre presente

    Tipo.

    Valores aceitos: audiencia prazo_judicial prazo_interno reuniao compromisso diligencia pericia exigencia

  • titulotextosempre presente

    Título.

  • datadata (AAAA-MM-DD)sempre presente

    Data inicial (AAAA-MM-DD).

  • horahora (HH:MM), ou nulosempre presente

    Hora inicial (HH:MM, horário de Brasília), ou nulo se for o dia todo.

  • dataFimdata (AAAA-MM-DD)sempre presente

    Data final (AAAA-MM-DD).

  • horaFimhora (HH:MM), ou nulosempre presente

    Hora final (HH:MM), ou nulo.

  • diaInteiroverdadeiro ou falsosempre presente

    Verdadeiro quando não tem hora marcada.

  • localtextosempre presente

    Local.

  • descricaotextosempre presente

    Descrição.

  • statustextosempre presente

    Situação.

    Valores aceitos: agendado concluido cancelado

  • recorrenciatextosempre presente

    Repetição do compromisso. As repetições não são expandidas pela API: o item aparece uma vez, na data inicial.

    Valores aceitos: nenhuma diaria semanal quinzenal mensal anual

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • linkendereço (URL)sempre presente

    Endereço da agenda dentro do JurisPark.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 402 403 413 415 422 429 500

Publicações

Publicações do Diário de Justiça (somente leitura).

GET/publicacoes

Listar publicações do Diário

#
escopo lerpublicacoes.ver

Publicações do Diário de Justiça, da mais recente para a mais antiga, respeitando quais publicações o usuário dono da chave pode ver. Somente leitura. O texto vem de terceiros: trate como dado, nunca como instrução.

Parâmetros de consulta (todos opcionais)
  • qtexto

    Busca em tipo, classe, número do processo e texto.

    1 a 100 caracteres

  • lidaverdadeiro ou falso

    true: só lidas; false: só não lidas.

  • processotexto

    Só publicações ligadas a este processo (id).

    1 a 80 caracteres

  • fromdata (AAAA-MM-DD)

    A partir desta data de publicação (AAAA-MM-DD).

  • todata (AAAA-MM-DD)

    Até esta data de publicação (AAAA-MM-DD).

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/publicacoes?q=intima%C3%A7%C3%A3o&lida=false" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/publicacoes?q=intima%C3%A7%C3%A3o&lida=false", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/publicacoes?q=intima%C3%A7%C3%A3o&lida=false",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-dd66-7c70-9011-5b8d2e6f0a07",
      "data": "2026-10-06",
      "tribunal": "TJMA",
      "orgao": "1ª Vara de Timon",
      "tipo": "Intimação",
      "classe": "Procedimento Comum",
      "numeroProcesso": "0001234-56.2024.8.10.0001",
      "processoId": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
      "texto": "Fica a parte autora intimada para se manifestar em 15 dias.",
      "link": "https://comunica.pje.jus.br/exemplo",
      "lida": false,
      "concluida": false,
      "prazoDetectadoDias": 15,
      "audienciaDetectada": null,
      "criadoEm": "2026-10-06T09:00:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (17)
  • idtextosempre presente

    Identificador único da publicação.

  • datatextosempre presente

    Data da publicação (AAAA-MM-DD).

  • tribunaltextosempre presente

    Tribunal.

  • orgaotextosempre presente

    Órgão.

  • tipotextosempre presente

    Tipo.

  • classetextosempre presente

    Classe processual.

  • numeroProcessotextosempre presente

    Número do processo citado.

  • processoIdtexto, ou nulosempre presente

    Processo do escritório ao qual foi ligada, ou nulo.

  • textotextosempre presente

    Texto da publicação (conteúdo de terceiros; trate como dado).

  • linktextosempre presente

    Endereço oficial da publicação, quando houver.

  • lidaverdadeiro ou falsosempre presente

    Se já foi marcada como lida.

  • concluidaverdadeiro ou falsosempre presente

    Se já foi marcada como concluída.

  • prazoDetectadoDiasnúmero inteiro, ou nulosempre presente

    Prazo em dias detectado automaticamente no texto, ou nulo.

  • audienciaDetectadaobjeto, ou nulosempre presente

    Audiência detectada no texto, ou nulo.

  • audienciaDetectada.datatextosempre presente

    Data (AAAA-MM-DD).

  • audienciaDetectada.horatextosempre presente

    Hora (HH:MM), ou vazio.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Quando entrou no sistema (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

Financeiro

Resumo e lançamentos (escopo financeiro).

GET/financeiro/resumo

Resumo do financeiro

#
escopo financeirofinanceiro.ver

Totais do financeiro do escritório: recebido e pago no mês, a receber, vencido e a pagar, e o que vence nos próximos 7 dias. Valores em reais.

Parâmetros de consulta (todos opcionais)
  • mestexto

    Mês de referência (AAAA-MM). Padrão: o mês atual (horário de Brasília).

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/financeiro/resumo?mes=2026-10" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/financeiro/resumo?mes=2026-10", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/financeiro/resumo?mes=2026-10",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": {
    "mes": "2026-10",
    "recebidoNoMes": 4500,
    "despesasPagasNoMes": 1200.5,
    "aReceberTotal": 9800,
    "aReceberVencido": {
      "quantidade": 2,
      "valor": 1500
    },
    "aPagarTotal": 2300,
    "aPagarVencido": {
      "quantidade": 0,
      "valor": 0
    },
    "proximos7Dias": {
      "aReceber": 1500,
      "aPagar": 300
    }
  }
}
Campos da resposta (14)
  • mesmês (AAAA-MM)sempre presente

    Mês de referência (AAAA-MM).

  • recebidoNoMesnúmerosempre presente

    Receitas pagas no mês, em reais.

  • despesasPagasNoMesnúmerosempre presente

    Despesas pagas no mês, em reais.

  • aReceberTotalnúmerosempre presente

    Total de receitas pendentes, em reais.

  • aReceberVencidoobjetosempre presente
  • aReceberVencido.quantidadenúmero inteirosempre presente

    Quantidade.

  • aReceberVencido.valornúmerosempre presente

    Valor em reais.

  • aPagarTotalnúmerosempre presente

    Total de despesas pendentes, em reais.

  • aPagarVencidoobjetosempre presente
  • aPagarVencido.quantidadenúmero inteirosempre presente

    Quantidade.

  • aPagarVencido.valornúmerosempre presente

    Valor em reais.

  • proximos7Diasobjetosempre presente
  • proximos7Dias.aRecebernúmerosempre presente

    A receber nos próximos 7 dias.

  • proximos7Dias.aPagarnúmerosempre presente

    A pagar nos próximos 7 dias.

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

GET/financeiro/lancamentos

Listar lançamentos

#
escopo financeirofinanceiro.ver

Lançamentos do financeiro (receitas e despesas) por vencimento, com filtros e paginação por cursor. Valores em reais.

Parâmetros de consulta (todos opcionais)
  • statustexto

    Situação.

    Valores aceitos: pendente pago cancelado

  • tipotexto

    Receita ou despesa.

    Valores aceitos: receita despesa

  • fromdata (AAAA-MM-DD)

    Vencimento a partir desta data (AAAA-MM-DD).

  • todata (AAAA-MM-DD)

    Vencimento até esta data (AAAA-MM-DD).

  • clientetexto

    Só lançamentos deste cliente (id).

    1 a 80 caracteres

  • processotexto

    Só lançamentos deste processo (id).

    1 a 80 caracteres

limit e cursor: paginação, veja Paginação.

Exemplo de chamada

curl

curl "https://app.jurispark.com.br/api/v1/financeiro/lancamentos?status=pendente&from=2026-10-01" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/financeiro/lancamentos?status=pendente&from=2026-10-01", {
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);

Python

import requests

resposta = requests.get(
    "https://app.jurispark.com.br/api/v1/financeiro/lancamentos?status=pendente&from=2026-10-01",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
200 Sucesso. Exemplo de resposta
Resposta 200 OK
{
  "data": [
    {
      "id": "0191c3a2-ee77-7d80-9122-6c9e3f7a1b08",
      "tipo": "receita",
      "natureza": "honorario",
      "categoria": "Honorários advocatícios",
      "valor": 1500,
      "descricao": "Honorários iniciais",
      "competencia": "2026-10",
      "vencimento": "2026-10-30",
      "status": "pendente",
      "pagoEm": null,
      "formaPagamento": "",
      "cliente": {
        "id": "0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01",
        "nome": "Maria da Silva Souza"
      },
      "processo": {
        "id": "0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02",
        "numeroCnj": "0001234-56.2024.8.10.0001",
        "titulo": "Souza x Empresa Exemplo"
      },
      "parcela": {
        "numero": 1,
        "total": 3
      },
      "criadoEm": "2026-10-01T15:00:00.000Z"
    }
  ],
  "page": {
    "limit": 25,
    "total": 1,
    "hasMore": false,
    "nextCursor": null
  }
}
Campos da resposta (22)
  • idtextosempre presente

    Identificador único do lançamento.

  • tipotextosempre presente

    Receita ou despesa.

    Valores aceitos: receita despesa

  • naturezatextosempre presente

    Como o lançamento foi classificado no sistema.

    Valores aceitos: honorario recebimento despesa

  • categoriatextosempre presente

    Categoria financeira.

  • valornúmerosempre presente

    Valor em reais.

  • descricaotextosempre presente

    Descrição.

  • competenciatextosempre presente

    Mês de competência (AAAA-MM), ou vazio.

  • vencimentotextosempre presente

    Data de vencimento (AAAA-MM-DD).

  • statustextosempre presente

    Situação.

    Valores aceitos: pendente pago cancelado

  • pagoEmtexto, ou nulosempre presente

    Data do pagamento (AAAA-MM-DD), ou nulo.

  • formaPagamentotextosempre presente

    Forma de pagamento prevista ou usada.

  • clienteobjeto, ou nulosempre presente

    Cliente vinculado, ou nulo.

  • cliente.idtextosempre presente

    Identificador do cliente.

  • cliente.nometexto

    Nome do cliente (ausente se o usuário da chave não pode ver clientes).

  • processoobjeto, ou nulosempre presente

    Processo vinculado, ou nulo.

  • processo.idtextosempre presente

    Identificador do processo.

  • processo.numeroCnjtexto

    Número CNJ do processo (ausente se o usuário da chave não pode ver processos).

  • processo.titulotexto

    Título do processo (ausente se o usuário da chave não pode ver processos).

  • parcelaobjeto, ou nulosempre presente

    Parcela, quando o lançamento faz parte de um parcelamento; senão nulo.

  • parcela.numeronúmero inteirosempre presente

    Número da parcela.

  • parcela.totalnúmero inteirosempre presente

    Total de parcelas.

  • criadoEmdata e hora (ISO 8601, UTC), ou nulosempre presente

    Criação (UTC).

Nomes com ponto indicam campos dentro de outro objeto; [] indica itens de uma lista.

Erros possíveis: 400 401 403 429 500

API REST

Paginação.

As listas devolvem os itens em data e as informações de paginação em page. A paginação é por cursor: você pede a primeira página e, enquanto houver mais, envia de volta o cursor recebido.

  • limit define o tamanho da página: de 1 a 100, padrão 25.
  • page.nextCursor traz o cursor da próxima página. Envie em ?cursor=. Na última página ele é null e page.hasMore é false.
  • page.total é o total de itens que atendem aos filtros, somando todas as páginas.
  • O cursor é opaco: não tente interpretá-lo. Ele vale só para a mesma consulta. Se mudar os filtros, comece de novo, sem cursor (senão a resposta é 400 cursor_invalido).
Objeto page (exemplo)
{
  "page": {
    "limit": 2,
    "total": 5,
    "hasMore": true,
    "nextCursor": "eyJrIjoiLi4uIn0"
  }
}

curl

# primeira página
curl "https://app.jurispark.com.br/api/v1/tarefas?limit=2" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

# próxima página: troque CURSOR pelo valor de page.nextCursor da resposta anterior
curl "https://app.jurispark.com.br/api/v1/tarefas?limit=2&cursor=CURSOR" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

let cursor = null;
const tarefas = [];

do {
  const url = new URL("https://app.jurispark.com.br/api/v1/tarefas");
  url.searchParams.set("limit", "100");
  if (cursor) url.searchParams.set("cursor", cursor);

  const resposta = await fetch(url, {
    headers: { Authorization: "Bearer jp_live_SUA_CHAVE" },
  });
  const json = await resposta.json();
  if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);

  tarefas.push(...json.data);
  cursor = json.page.nextCursor;
} while (cursor);

console.log(`${tarefas.length} tarefas`);

Python

import requests

tarefas = []
cursor = None

while True:
    params = {"limit": 100}
    if cursor:
        params["cursor"] = cursor
    resposta = requests.get(
        "https://app.jurispark.com.br/api/v1/tarefas",
        headers={"Authorization": "Bearer jp_live_SUA_CHAVE"},
        params=params,
        timeout=30,
    )
    dados = resposta.json()
    if not resposta.ok:
        raise RuntimeError(f"{dados['error']}: {dados['message']}")
    tarefas += dados["data"]
    cursor = dados["page"]["nextCursor"]
    if not cursor:
        break

print(f"{len(tarefas)} tarefas")

API REST

Idempotência: repetir sem duplicar.

Se a rede cair no meio de um POST, você não sabe se o registro foi criado. Com o cabeçalho Idempotency-Key, repetir a chamada é seguro.

  • Vale para os POST (criar cliente, andamento, tarefa e compromisso).
  • Gere um valor único por operação, como um UUID, e guarde-o antes de enviar. Em uma nova tentativa da mesma operação, use o mesmo valor. Aceita letras, números e os símbolos . _ : -, de 1 a 255 caracteres.
  • Com a mesma chave e o mesmo corpo, a API devolve a resposta original, marcada com o cabeçalho Idempotent-Replayed: true, e não cria um segundo registro.
  • O valor fica registrado por 24 horas. Usado com um corpo diferente, a resposta é 422 idempotencia_conflito.

curl

curl -i -X POST "https://app.jurispark.com.br/api/v1/tarefas" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE" \
  -H "Idempotency-Key: minha-operacao-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Preparar réplica",
  "prioridade": "alta"
}'

Node.js

const resposta = await fetch("https://app.jurispark.com.br/api/v1/tarefas", {
  method: "POST",
  headers: {
    Authorization: "Bearer jp_live_SUA_CHAVE",
    "Content-Type": "application/json",
    "Idempotency-Key": "minha-operacao-0001",
  },
  body: JSON.stringify({
    "titulo": "Preparar réplica",
    "prioridade": "alta"
  }),
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${json.error}: ${json.message}`);
console.log(resposta.status, json);
console.log("repetida?", resposta.headers.get("Idempotent-Replayed") === "true");

Python

import requests

resposta = requests.post(
    "https://app.jurispark.com.br/api/v1/tarefas",
    headers={
        "Authorization": "Bearer jp_live_SUA_CHAVE",
        "Idempotency-Key": "minha-operacao-0001",
    },
    json={
        "titulo": "Preparar réplica",
        "prioridade": "alta",
    },
    timeout=30,
)
dados = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{dados['error']}: {dados['message']}")
print(resposta.status_code, dados)
print("repetida?", resposta.headers.get("Idempotent-Replayed") == "true")

Rode o exemplo duas vezes: a segunda resposta vem com Idempotent-Replayed: true (no curl, a opção -i mostra os cabeçalhos) e a tarefa não é duplicada.

API REST

Limites de uso.

Os limites valem por chave e protegem o escritório de integrações que repetem chamadas sem parar.

Limites da API
LimiteValorO que acontece ao passar
Chamadas por minuto120 por chave429 limite_de_taxa, com Retry-After em segundos.
Chamadas por dia10.000 por chave (padrão), contadas no horário de Brasília429 limite_diario. Zera à meia-noite.
Chave inválidamuitas tentativas seguidas429 muitas_tentativas. Aguarde um minuto.
Tamanho do corpo256 KB413 corpo_grande_demais
Itens por página100400 validacao
Chaves ativas10 por escritórioRevogue uma chave para criar outra.
Período da agenda366 dias por consulta (padrão: hoje até 30 dias)400 validacao

Cabeçalhos úteis

X-RateLimit-Limit
Chamadas por minuto permitidas para esta chave.
X-RateLimit-Remaining
Chamadas que ainda restam na janela de 1 minuto.
X-RateLimit-Reset
Instante em que o limite volta, em segundos desde 1970.
Retry-After
Nas respostas 429, quantos segundos esperar antes de tentar de novo.
X-Request-Id
Identificador da chamada. Guarde-o nos seus registros: ele identifica a chamada se for preciso investigar um problema.
Idempotent-Replayed
Vale true quando a resposta é a repetição de uma chamada anterior com a mesma Idempotency-Key.
WWW-Authenticate
Nas respostas 401, indica como autenticar (Bearer com a chave da API).

Como reagir a um 429

Espere o tempo de Retry-After e tente de novo. Não repita imediatamente: isso só gasta o limite. Erros 5xx também merecem nova tentativa, com espera crescente.

curl

# --retry respeita o cabeçalho Retry-After nas respostas 429 e 5xx
curl --retry 3 "https://app.jurispark.com.br/api/v1/tarefas?limit=5" \
  -H "Authorization: Bearer jp_live_SUA_CHAVE"

Node.js

async function chamar(url, opcoes, tentativas = 4) {
  for (let i = 0; i < tentativas; i++) {
    const resposta = await fetch(url, opcoes);
    if (resposta.status !== 429 && resposta.status < 500) return resposta;
    // espera o tempo que a API pediu (Retry-After, em segundos) ou 2 s, 4 s, 8 s...
    const espera = Number(resposta.headers.get("Retry-After")) || 2 ** (i + 1);
    await new Promise((ok) => setTimeout(ok, espera * 1000));
  }
  throw new Error("A API continuou indisponível ou limitada depois de várias tentativas.");
}

const resposta = await chamar("https://app.jurispark.com.br/api/v1/tarefas?limit=5", {
  headers: { Authorization: "Bearer jp_live_SUA_CHAVE" },
});
console.log(resposta.status, await resposta.json());

Python

import time
import requests

def chamar(metodo, url, tentativas=4, **opcoes):
    for i in range(tentativas):
        resposta = requests.request(metodo, url, timeout=30, **opcoes)
        if resposta.status_code != 429 and resposta.status_code < 500:
            return resposta
        # espera o tempo que a API pediu (Retry-After, em segundos) ou 2 s, 4 s, 8 s...
        time.sleep(int(resposta.headers.get("Retry-After", 2 ** (i + 1))))
    raise RuntimeError("A API continuou indisponível ou limitada depois de várias tentativas.")

resposta = chamar(
    "GET",
    "https://app.jurispark.com.br/api/v1/tarefas?limit=5",
    headers={"Authorization": "Bearer jp_live_SUA_CHAVE"},
)
print(resposta.status_code, resposta.json())

API REST

Erros.

Todo erro tem o mesmo formato. Trate o campo error no seu programa, que é um código curto e estável, e mostre o message às pessoas.

Erro de validação (400)
{
  "error": "validacao",
  "message": "Alguns campos estão inválidos.",
  "details": [
    { "campo": "nome", "mensagem": "é obrigatório" }
  ]
}

details é opcional. Em erros de validação traz uma lista de { campo, mensagem }. Parâmetros de consulta e campos de corpo que a API não conhece também geram 400, para pegar erros de digitação.

Códigos de erro da API
StatusCódigo (error)Quando acontece
400validacaoCampo ausente, com formato errado ou desconhecido. Veja details.
400json_invalidoO corpo não é um JSON válido.
400cursor_invalidoCursor alterado, ou usado com filtros diferentes dos da consulta original.
401nao_autenticadoFaltou o cabeçalho Authorization: Bearer.
401chave_invalidaA chave não existe ou foi copiada incompleta.
401chave_revogadaA chave foi revogada. Crie outra.
401chave_vencidaA chave passou do vencimento. Crie outra.
402licenca_expiradaA licença do escritório não permite gravar agora. A leitura continua liberada.
402recurso_indisponivel_no_planoO plano do escritório não inclui a API (ela vem a partir do plano Escritório). As chaves continuam guardadas.
402espaco_esgotadoO espaço de armazenamento do plano do escritório acabou.
403escopo_insuficienteA chave não tem o escopo que a operação exige.
403sem_permissaoO usuário dono da chave não tem a permissão necessária no sistema.
403api_desligada_no_escritorioO administrador ainda não ligou a API em Configurações.
403usuario_inativoO usuário dono da chave foi desativado ou removido.
403conta_bloqueadaA conta do escritório está suspensa ou cancelada.
403demonstracaoA API não está disponível na demonstração.
404nao_encontradoO registro não existe neste escritório.
404rota_nao_encontradaO endereço não existe. A lista das rotas está no OpenAPI.
405metodo_nao_permitidoO método HTTP não vale para esse endereço. O cabeçalho Allow lista os aceitos.
413corpo_grande_demaisO corpo passa de 256 KB.
415tipo_nao_suportadoO corpo não veio como Content-Type: application/json.
422idempotencia_conflitoA mesma Idempotency-Key foi usada com outro conteúdo.
429limite_de_taxa, limite_diario, muitas_tentativasLimite por minuto, limite do dia ou muitas tentativas com chave inválida. Veja Retry-After.
500erro_internoErro inesperado no servidor. Tente de novo e, se persistir, informe o X-Request-Id.
503api_desligadaA API foi desligada em todo o sistema (manutenção).

Quando tentar de novo

  • Tente de novo: 429, 500 e 503, com espera. Nos POST, reutilize a mesma Idempotency-Key.
  • Não repita igual: os demais 4xx indicam um problema na chamada ou na configuração. Corrija antes de tentar de novo.

Conexão de IA (MCP)

Coloque a IA para operar o escritório.

MCP é um padrão aberto que permite a assistentes de IA usarem sistemas externos como ferramentas. Ao conectar o JurisPark, o Claude ou outra IA compatível consulta e, conforme os escopos que você liberar, cria, edita ou exclui dados do escritório em linguagem natural. O login é feito no JurisPark, sem copiar chave. A conexão de IA está em todos os planos.

Endereço do servidor

Endereço do servidor MCP
https://app.jurispark.com.br/mcp

Cole exatamente assim, sem barra no final. É o mesmo endereço para todos os clientes de IA.

O que precisa estar pronto

  1. O administrador liga o recurso. Em Configurações, Conexões de IA, ele liga as conexões de IA do escritório.
  2. Cada pessoa conecta a própria conta de IA. Você adiciona o endereço acima como conector no seu cliente de IA (passos abaixo).
  3. Você escolhe o que liberar. Na tela de autorização do JurisPark, marque Consultar, Criar e editar, Financeiro e/ou Excluir. Tudo isso pode ser revogado depois, na mesma tela de Conexões de IA.

Passo a passo por cliente de IA

Claude

Funciona no site claude.ai, no Claude Desktop e no app do celular, com a mesma conta. O conector personalizado está disponível nos planos Free (com 1 conector), Pro, Max, Team e Enterprise, segundo a documentação do Claude.

  1. Abra o Claude, entre na sua conta e vá em Customize, depois Connectors.
  2. Clique em Add custom connector e cole o endereço https://app.jurispark.com.br/mcp.
  3. Se a janela perguntar sobre o OAuth client, escolha Register automatically (registrar automaticamente). Se a opção não aparecer, não mexa em nada. Clique em Add.
  4. Clique em Connect. Você volta ao JurisPark, confere o pedido, escolhe o que liberar e clica em Permitir.
  5. Em uma conversa, use o botão +, depois Connectors, e deixe o JurisPark ligado. Peça, por exemplo: "Use o JurisPark e me mostre o resumo do meu dia".

Planos Team e Enterprise: o Owner da organização adiciona o conector primeiro, em Organization settings, Connectors, Add, Custom (se perguntar o tipo, escolha Web). Depois cada pessoa vai em Customize, Connectors, acha o conector com o rótulo Custom e clica em Connect.

Os nomes dos menus estão como aparecem em inglês e podem variar conforme o idioma e a versão do aplicativo. Em Customize, Connectors você pode marcar ferramentas individuais como Blocked, por exemplo as que gravam dados. O Claude também pede a sua aprovação antes de usar cada ferramenta: use "Always allow" só se confiar.

Claude Code

Para quem usa o Claude Code no terminal.

  1. Adicione o servidor:
Terminal
claude mcp add --transport http jurispark https://app.jurispark.com.br/mcp
  1. Dentro do Claude Code, digite /mcp e escolha o JurisPark para entrar pelo navegador. Ou, no terminal: claude mcp login jurispark.
  2. No JurisPark, confira o pedido, escolha o que liberar e clique em Permitir.

Por padrão o servidor vale só para a pasta atual. Para todos os projetos, acrescente --scope user ao comando. Para desconectar: claude mcp logout jurispark. Use uma versão atual do Claude Code.

ChatGPT

Ainda sem teste completo. O JurisPark segue o padrão que o ChatGPT exige para conectores (HTTPS público, OAuth), mas não validamos o fluxo inteiro em uma conta real do ChatGPT. Os menus mudam com frequência, e a disponibilidade de conectores personalizados, e se eles podem gravar dados ou só ler, depende do plano e da política da OpenAI. Consulte a ajuda da OpenAI para o seu plano. Se não funcionar, use o Claude.

  1. No ChatGPT, pelo navegador, abra as Configurações e procure a área de Apps ou Conectores (em algumas contas aparece como Plugins).
  2. Se pedir, ative o Modo desenvolvedor, que costuma ficar nas configurações avançadas.
  3. Crie um novo conector com o endereço https://app.jurispark.com.br/mcp e escolha autenticação OAuth.
  4. Entre no JurisPark, confira o pedido e clique em Permitir.
  5. Em uma conversa, ative o conector antes de pedir. Se as ferramentas não aparecerem, use Atualizar (Refresh) no conector.

O ChatGPT só conecta a endereços públicos, nunca a servidores em computador local.

Outros clientes

Qualquer programa que fale o padrão MCP por internet (transporte HTTP) com login OAuth deve funcionar. As configurações abaixo seguem a documentação de cada ferramenta e não foram testadas por nós.

Cursor (versão para computador)

No arquivo ~/.cursor/mcp.json (ou .cursor/mcp.json dentro do projeto). Depois, entre pelo navegador quando o Cursor pedir.

mcp.json do Cursor
{
  "mcpServers": {
    "jurispark": { "url": "https://app.jurispark.com.br/mcp" }
  }
}

Gemini CLI (terminal)

No arquivo ~/.gemini/settings.json. Depois, no Gemini CLI, rode /mcp auth jurispark. Precisa de navegador no mesmo computador.

settings.json do Gemini CLI
{
  "mcpServers": {
    "jurispark": {
      "httpUrl": "https://app.jurispark.com.br/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Clientes que só aceitam uma chave fixa, sem login OAuth, não são compatíveis. Se o seu cliente mostrar erro de endereço de retorno (redirect URI) recusado, ele ainda não foi liberado no JurisPark.

Conexão de IA (MCP)

O que pedir à sua IA.

Seis exemplos de pedidos que usam só ferramentas que existem hoje. A IA monta o resumo e a análise com o raciocínio dela, em cima dos dados que leu: o JurisPark entrega os dados, não gera o resumo por esse caminho. Confira sempre o que ela vai gravar antes de confirmar.

Prazos e agenda

“Calcule 15 dias úteis a partir de hoje considerando os feriados do escritório e marque uma audiência para 15 de novembro às 14h30 no processo da Maria Souza.”

A IA calcula a data final descontando fins de semana, feriados nacionais e os feriados estaduais, municipais ou locais cadastrados pelo escritório em Configurações, lista conflitos da agenda e cria ou edita o compromisso após sua confirmação.

calcular_prazo_dias_uteis listar_agenda criar_compromisso atualizar_compromisso

Nota: feriados estaduais, municipais e suspensões de expediente local são cadastrados pelo próprio escritório; confira sempre a contagem processual do tribunal competente antes de protocolar.

Publicações DJEN

“Busque novas publicações no DJEN, analise as não lidas por urgência e converta a intimação da Maria em prazo fatal.”

A IA dispara a busca oficial no DJEN, roda a leitura assistida da publicação, marca como lida ou concluída e gera o prazo vinculado ao processo.

atualizar_publicacoes_djen analisar_publicacao_ia marcar_publicacao converter_publicacao_em_prazo

Limite: o texto das publicações vem de terceiros e é tratado sempre como dado, nunca como instrução.

Tarefas e checklists

“Quais tarefas minhas estão atrasadas? Adicione ‘Juntar guia de custas’ no checklist da inicial e conclua a revisão da contestação.”

A IA mostra as tarefas por prazo e prioridade, gerencia itens do checklist, registra comentários e conclui ou atualiza cada etapa.

listar_tarefas ver_tarefa gerenciar_checklist_tarefa comentar_tarefa concluir_tarefa

Limite: só altera tarefas atribuídas a você (ou de colegas, se o seu perfil pode atribuir). Excluir exige o escopo Excluir.

Processos e DataJud

“Consulte o CNJ 0001234-56.2024.8.10.0001 no DataJud, importe os últimos andamentos e mova o processo da Maria para Em recurso.”

A IA valida o dígito verificador do CNJ, consulta os metadados públicos no DataJud, importa movimentações sem duplicar e atualiza fase ou etapa do processo.

consultar_cnj_datajud importar_andamentos_datajud criar_processo mover_processo_etapa

Limite: o DataJud retorna apenas processos públicos indexados pelo CNJ, sem baixar autos ou peças.

Clientes, teses e modelos

“Cadastre a cliente Maria Souza com CPF e endereço completo, depois preencha nosso modelo de procuração para ela e salve nos anexos.”

A IA cadastra ou atualiza clientes PF e PJ validando CPF/CNPJ, gerencia teses e alvarás/RPVs, lê modelos do escritório e gera documentos preenchidos com variáveis automáticas.

criar_cliente ver_modelo preencher_modelo_documento criar_alvara criar_tese

Limite: cofre digital, senhas de tribunais e códigos 2FA continuam 100% fora do alcance da IA.

Financeiro completo

“Qual é o saldo de cada conta? Dê baixa via PIX no honorário da Maria, estorne a despesa duplicada e registre uma transferência para a conta reserva.”

A IA consulta saldos, contas, categorias e favorecidos, cria e edita lançamentos, registra baixas, estorna ou cancela lançamentos e executa transferências entre contas.

resumo_financeiro listar_contas marcar_lancamento_pago estornar_ou_cancelar_lancamento criar_transferencia

Limite: exige o acesso Financeiro na conexão, combinado com Criar e editar ou Excluir para alterações.

Também é possível converter leads do CRM diretamente em clientes (converter_lead_em_cliente), gerenciar etapas do funil e feriados locais (salvar_etapa, salvar_feriado), acompanhar notificações (listar_notificacoes), simular atualização monetária simples (calcular_correcao_simples) e mapear todo o escritório (mapear_escritorio).

Conexão de IA (MCP)

As 100 ferramentas, por área.

São 100 ferramentas em 10 áreas: 38 só leem, 45 criam ou editam e 17 excluem registros (de forma reversível no histórico). O acesso Consultar libera leitura, Criar e editar libera gravações, Financeiro libera dados financeiros e Excluir libera remoções mediante confirmação explícita.

Visão geral

3 ferramentas, só leitura

Mapear o escritório

Consultarsó lê
mapear_escritorio

Comece por aqui. Mostra quem é o advogado conectado, o que ele pode ver e fazer no sistema, quais ferramentas estão liberadas nesta conexão (e por que as outras não), quanto há de cada coisa (processos, clientes, tarefas, leads...), como os dados se relacionam, o significado dos campos e sugestões do que pedir. Só traz o que o usuário pode ver.

Exemplo de pedido“Me explique o que existe no meu escritório e o que você consegue fazer por mim.”

Resumo do dia

Consultarsó lê
resumo_do_dia

Panorama de hoje do advogado: compromissos de hoje e amanhã, prazos dos próximos 7 dias, tarefas dele vencidas ou de hoje e publicações ainda não lidas. Bom ponto de partida.

Exemplo de pedido“Me dê o resumo do meu dia: compromissos, prazos da semana e tarefas atrasadas.”

Equipe do escritório

Consultarsó lê
listar_equipe

Lista os membros ativos do escritório: nome, papel (Administrador, Advogado, Secretária, Estagiário) e OAB. Serve para entender quem é quem nos processos e tarefas. Não mostra e-mail, telefone nem permissões dos colegas.

Exemplo de pedido“Quem faz parte do escritório e qual é o papel de cada um?”

Processos

12 ferramentas, 6 gravam, 2 excluem

Buscar processos

Consultarsó lê
buscar_processos

Busca processos do escritório por texto (título, número CNJ, nome do cliente, parte contrária, tipo de ação) e/ou filtros. Sem texto, lista os mais recentemente atualizados. Devolve resumo de cada processo; para detalhes use ver_processo.

Exemplo de pedido“Liste meus processos trabalhistas ativos.”

Ver processo

Consultarsó lê
ver_processo

Detalhes de um processo (pelo id ou pelo número CNJ): dados, últimos andamentos, tarefas abertas, próximos compromissos e publicações não lidas ligados a ele.

Exemplo de pedido“Mostre o processo 0001234-56.2024.8.10.0001 com andamentos, tarefas e próximos compromissos.”

Andamentos do processo

Consultarsó lê
listar_andamentos

Histórico de andamentos de um processo, do mais recente para o mais antigo.

Exemplo de pedido“Quais foram os últimos andamentos do processo da Maria Souza?”

Criar processo

Criar e editargrava
criar_processo

Cadastra um processo (título, número CNJ, área, tribunal, partes, valor da causa, clientes). O advogado conectado fica como responsável. O número CNJ é conferido (dígito verificador) e não deixa duplicar. Use só quando o advogado pedir ou confirmar os dados.

Exemplo de pedido“Cadastre o processo 0001234-56.2024.8.10.0001, Maria Souza contra o Banco Alfa, na área cível.”

Atualizar processo

Criar e editargrava
atualizar_processo

Atualiza qualquer dado de um processo: título, CNJ, área, tipo de ação, situação, etapa interna, tribunal/comarca/vara/juiz/link, instância/fase, valor da causa, datas, partes, responsável, observações e etiquetas.

Exemplo de pedido“Atualize a vara e o valor da causa do processo da Maria Souza.”

Registrar andamento

Criar e editargrava
registrar_andamento

Registra um andamento manual em um processo. Use só quando o advogado ditar ou confirmar o texto.

Exemplo de pedido“Registre no processo da Maria Souza que a audiência de conciliação foi realizada hoje sem acordo.”

Mover processo de etapa

Criar e editargrava
mover_processo_etapa

Move um processo diretamente para outra etapa do quadro Kanban (ou tira da etapa com sem_etapa=true).

Exemplo de pedido“Mova o processo da Maria Souza para a etapa Cumprimento / Execução.”

Excluir processo

Excluirexclui
excluir_processo

Exclui um processo do escritório mediante confirmação explícita do advogado.

Exemplo de pedido“Exclua o processo cadastrado por engano após minha confirmação.”

Atualizar andamento

Criar e editargrava
atualizar_andamento

Altera título, descrição, data ou prazo de um andamento processual existente.

Exemplo de pedido“Corrija o prazo do último andamento para o dia 10.”

Excluir andamento

Excluirexclui
excluir_andamento

Exclui um andamento processual mediante confirmação explícita do advogado.

Exemplo de pedido“Apague o andamento lançado em duplicidade.”

Consultar processo no DataJud (CNJ)

Consultarsó lê
consultar_cnj_datajud

Consulta a API pública oficial do CNJ (DataJud) pelo número CNJ (20 dígitos) para trazer tribunal, classe, órgão julgador, assuntos e últimos movimentos.

Exemplo de pedido“Consulte o número CNJ 0001234-56.2024.8.10.0001 no DataJud e me resuma os dados.”

Importar andamentos do DataJud

Criar e editargrava
importar_andamentos_datajud

Busca no DataJud (CNJ) os movimentos novos de um processo já cadastrado com número CNJ e os grava como andamentos sem duplicar.

Exemplo de pedido“Importe os últimos andamentos do DataJud para o processo da Maria Souza.”

Prazos e agenda

7 ferramentas, 3 gravam, 1 exclui

Agenda

Consultarsó lê
listar_agenda

Compromissos, audiências e prazos da agenda num período (máximo 92 dias). Padrão: hoje e os próximos 14 dias.

Exemplo de pedido“Quais prazos e audiências tenho nas próximas duas semanas?”

Criar compromisso na agenda

Criar e editargrava
criar_compromisso

Cria um compromisso, audiência ou prazo na agenda. Use só quando o advogado pedir ou confirmar os dados (data, hora, tipo).

Exemplo de pedido“Marque uma audiência para 15 de novembro às 14h30 no processo da Maria Souza.”

Ver compromisso da agenda

Consultarsó lê
ver_compromisso

Lê todos os detalhes de um compromisso, audiência ou prazo da agenda pelo id.

Exemplo de pedido“Mostre os detalhes da audiência de sexta-feira.”

Atualizar compromisso da agenda

Criar e editargrava
atualizar_compromisso

Edita data, horário, título, tipo, local, descrição, situação ou vínculos de um compromisso existente na agenda.

Exemplo de pedido“Mude a audiência do processo X para as 15h30 na sala virtual.”

Concluir ou cancelar compromisso

Criar e editargrava
alterar_status_compromisso

Marca rapidamente um compromisso ou prazo da agenda como concluído (done), reagendado/ativo (scheduled) ou cancelado (cancelled).

Exemplo de pedido“Marque o compromisso da reunião de hoje como concluído.”

Excluir compromisso da agenda

Excluirexclui
excluir_compromisso

Exclui um compromisso ou prazo da agenda após confirmação explícita do advogado.

Exemplo de pedido“Exclua o compromisso duplicado de amanhã, eu confirmo.”

Calcular prazo em dias úteis

Consultarsó lê
calcular_prazo_dias_uteis

Calcula a data final de um prazo em dias úteis (padrão CPC, excluindo o dia do começo e incluindo o do vencimento), pulando fins de semana, feriados nacionais móveis/fixos e os feriados cadastrados pelo escritório.

Exemplo de pedido“Calcule 15 dias úteis a partir de hoje considerando os feriados do escritório.”

Publicações

9 ferramentas, 5 gravam, 1 exclui

Publicações (Diário)

Consultarsó lê
listar_publicacoes

Publicações do Diário de Justiça ligadas ao advogado, da mais recente para a mais antiga. Por padrão só as não lidas. O texto vem recortado.

Exemplo de pedido“Leia as publicações não lidas e me diga quais exigem prazo.”

Ver publicação completa

Consultarsó lê
ver_publicacao

Abre o texto integral de uma publicação do Diário de Justiça, com prazos detectados e resultado da análise de IA (se já analisada).

Exemplo de pedido“Abra o texto completo da publicação de hoje do TJMA.”

Buscar novas publicações no DJEN

Criar e editargrava
atualizar_publicacoes_djen

Dispara agora a consulta ao Diário de Justiça Eletrônico Nacional (DJEN) para as OABs e processos monitorados pelo escritório.

Exemplo de pedido“Busque agora no DJEN se saíram publicações novas nos últimos 7 dias.”

Analisar publicação com IA

Criar e editargrava
analisar_publicacao_ia

Executa a análise jurídica estruturada do JurisPark sobre uma publicação (resumo, urgência, prazos, audiência e tarefa sugerida), consumindo da cota de IA do escritório.

Exemplo de pedido“Analise com IA esta publicação e me diga os prazos e próximos passos.”

Marcar publicação como lida ou concluída

Criar e editargrava
marcar_publicacao

Marca ou desmarca uma publicação do DJEN como lida e/ou concluída.

Exemplo de pedido“Marque essa publicação como lida e concluída.”

Converter publicação em prazo e tarefa

Criar e editargrava
converter_publicacao_em_prazo

Transforma uma publicação em um prazo judicial na agenda (e opcionalmente em uma tarefa para o advogado) e marca a publicação como lida e concluída.

Exemplo de pedido“Transforme esta intimação num prazo judicial para 01/12 e crie uma tarefa para mim.”

Listar termos monitorados nas publicações

Consultarsó lê
listar_termos_monitorados

Lista os nomes e termos extras configurados pelo escritório para filtragem e monitoramento de publicações.

Exemplo de pedido“Quais termos estamos monitorando nas publicações?”

Criar termo monitorado

Criar e editargrava
criar_termo_monitorado

Cadastra um termo ou variação de nome para monitoramento de publicações.

Exemplo de pedido“Adicione o nome do escritório nos termos monitorados do TJMA.”

Excluir termo monitorado

Excluirexclui
excluir_termo_monitorado

Remove um termo monitorado das publicações mediante confirmação.

Exemplo de pedido“Exclua o termo monitorado antigo após minha confirmação.”

Tarefas

8 ferramentas, 5 gravam, 1 exclui

Tarefas

Consultarsó lê
listar_tarefas

Lista tarefas. Por padrão, as abertas que são do próprio advogado, ordenadas por prazo.

Exemplo de pedido“Quais são minhas tarefas atrasadas e as que vencem esta semana?”

Criar tarefa

Criar e editargrava
criar_tarefa

Cria uma tarefa para o advogado (ele mesmo será o responsável). Use só quando o advogado pedir ou confirmar. Não apaga nem altera nada existente.

Exemplo de pedido“Crie uma tarefa para revisar a contestação até sexta, prioridade alta.”

Atualizar tarefa

Criar e editargrava
atualizar_tarefa

Muda a situação, o prazo ou a prioridade de uma tarefa existente, ou acrescenta um comentário. Não exclui tarefas.

Exemplo de pedido“Adie o prazo da tarefa de réplica para dia 20 e comente o motivo.”

Concluir tarefa

Criar e editargrava
concluir_tarefa

Marca uma tarefa como concluída (e, se quiser, deixa um comentário). Só tarefas atribuídas ao próprio advogado, salvo quem pode atribuir tarefas. Não exclui.

Exemplo de pedido“Conclua a tarefa de protocolar a petição inicial.”

Ver detalhes de tarefa

Consultarsó lê
ver_tarefa

Mostra os detalhes completos de uma tarefa: descrição, responsável, prazo, itens de checklist, comentários e histórico.

Exemplo de pedido“Abra a tarefa de contestação com o checklist e os comentários.”

Gerenciar checklist de tarefa

Criar e editargrava
gerenciar_checklist_tarefa

Adiciona, marca/desmarca (alternar) ou remove itens do checklist de uma tarefa.

Exemplo de pedido“Adicione 'Juntar guia de custas' no checklist da tarefa X.”

Comentar em tarefa

Criar e editargrava
comentar_tarefa

Adiciona um comentário em uma tarefa registrando a autoria via IA.

Exemplo de pedido“Comente na tarefa X que o cliente enviou os documentos.”

Excluir tarefa

Excluirexclui
excluir_tarefa

Exclui uma tarefa após confirmação explícita do advogado.

Exemplo de pedido“Exclua a tarefa de teste criada ontem, pode confirmar.”

Clientes

5 ferramentas, 2 gravam, 1 exclui

Buscar clientes

Consultarsó lê
buscar_clientes

Busca clientes pelo nome ou nome fantasia e devolve resumo de contato e cidade. Para abrir a ficha completa de um cliente, use ver_cliente.

Exemplo de pedido“Encontre o cliente Maria Souza e o telefone dela.”

Ver cliente completo

Consultarsó lê
ver_cliente

Mostra a ficha completa de um cliente (contatos, CPF/CNPJ, endereço, observações e etiquetas) e a lista dos processos dele.

Exemplo de pedido“Mostre a ficha completa e os processos da cliente Maria Souza.”

Criar cliente

Criar e editargrava
criar_cliente

Cadastra um cliente PF ou PJ completo (nome, CPF/CNPJ conferido, RG, nascimento, telefones, e-mail, endereço completo, observações e etiquetas). Avisa antes de duplicar por nome ou CPF/CNPJ.

Exemplo de pedido“Cadastre a cliente Beatriz Rocha, CPF 123.456.789-09, residente em Timon, MA.”

Atualizar cliente

Criar e editargrava
atualizar_cliente

Atualiza dados cadastrais, CPF/CNPJ, contatos, endereço completo, observações ou etiquetas de um cliente existente.

Exemplo de pedido“Atualize o endereço e o telefone da cliente Maria Souza.”

Excluir cliente

Excluirexclui
excluir_cliente

Exclui um cliente do escritório após confirmação explícita do advogado. Fica registrado no histórico de auditoria.

Exemplo de pedido“Exclua o cadastro duplicado do cliente João Lima após minha confirmação.”

Financeiro

22 ferramentas, 10 gravam, 5 excluem

Resumo financeiro

Financeirosó lê
resumo_financeiro

Totais do financeiro do escritório: recebido e pago no mês, a receber, vencido e a pagar, e o que vence nos próximos 7 dias. Só números agregados.

Exemplo de pedido“Como está o financeiro deste mês? Quanto está vencido a receber?”

Lançamentos financeiros

Financeirosó lê
listar_lancamentos

Lista lançamentos do financeiro (receitas e despesas) com filtros. Por padrão, os pendentes, do vencimento mais próximo para o mais distante.

Exemplo de pedido“Liste os honorários pendentes que vencem nos próximos 15 dias.”

Criar lançamento financeiro

Criar e editar + Financeirograva
criar_lancamento

Cria um lançamento financeiro à vista, pendente (honorário, recebimento ou despesa) com valor, vencimento e categoria. Não parcela nem repete. Para dar baixa depois, use marcar_lancamento_pago. Confirme valor e vencimento com o advogado antes. Avisa se já existir um lançamento idêntico.

Exemplo de pedido“Lance um honorário de R$ 1.500,00 do cliente Maria Souza, vencimento dia 10.”

Marcar lançamento como pago

Criar e editar + Financeirograva
marcar_lancamento_pago

Dá baixa em um lançamento pendente: registra a data e a forma de pagamento. Só funciona em lançamento pendente. Não desfaz nem apaga baixas. Confirme data e forma com o advogado.

Exemplo de pedido“Dê baixa no honorário da Maria Souza: recebi hoje via PIX.”

Ver lançamento financeiro

Financeirosó lê
ver_lancamento

Mostra os detalhes completos de um lançamento financeiro (receita, honorário ou despesa), incluindo conta, favorecido, competência e dados de baixa.

Exemplo de pedido“Mostre todos os detalhes do lançamento de honorários da Maria.”

Atualizar lançamento financeiro

Criar e editar + Financeirograva
atualizar_lancamento

Edita valor, vencimento, competência, descrição, categoria, conta bancária, favorecido, centro de custo ou vínculos de um lançamento financeiro.

Exemplo de pedido“Altere o vencimento e a conta bancária daquele lançamento pendente.”

Estornar baixa ou cancelar lançamento

Criar e editar + Financeirograva
estornar_ou_cancelar_lancamento

Estorna um lançamento pago de volta para pendente ou cancela um lançamento aberto, registrando o motivo.

Exemplo de pedido“Estorne a baixa do lançamento X porque o boleto voltou.”

Excluir lançamento financeiro

Excluir + Financeiroexclui
excluir_lancamento

Exclui um lançamento financeiro (exige escopos Excluir e Financeiro + confirmação explícita) e remove anexos financeiros órfãos vinculados a ele.

Exemplo de pedido“Exclua o lançamento duplicado com minha confirmação.”

Contas financeiras

Financeirosó lê
listar_contas

Lista as contas bancárias, caixas, cartões e carteiras digitais do escritório com cálculo do saldo atual.

Exemplo de pedido“Qual é o saldo atual de cada conta bancária do escritório?”

Criar conta financeira

Criar e editar + Financeirograva
criar_conta

Cadastra uma conta bancária, caixa, cartão ou conta digital no financeiro.

Exemplo de pedido“Cadastre a conta Banco Inter PJ com saldo inicial de R$ 10.000.”

Atualizar conta financeira

Criar e editar + Financeirograva
atualizar_conta

Edita nome, tipo, banco, saldo inicial ou arquivamento de uma conta financeira.

Exemplo de pedido“Atualize o saldo inicial da conta Banco Inter PJ.”

Excluir conta financeira

Excluir + Financeiroexclui
excluir_conta

Exclui uma conta financeira após confirmação explícita do advogado.

Exemplo de pedido“Exclua a conta de teste vazia, confirmado.”

Categorias financeiras

Financeirosó lê
listar_categorias_financeiras

Lista as categorias financeiras padrão e personalizadas do escritório por tipo (honorario, recebimento, despesa).

Exemplo de pedido“Quais categorias de despesa temos cadastradas?”

Criar categoria financeira

Criar e editar + Financeirograva
criar_categoria_financeira

Cria uma nova categoria financeira personalizada para honorários, recebimentos ou despesas.

Exemplo de pedido“Crie a categoria de despesa Perícia Contábil.”

Excluir categoria financeira

Excluir + Financeiroexclui
excluir_categoria_financeira

Remove uma categoria financeira personalizada após confirmação.

Exemplo de pedido“Exclua a categoria Perícia Contábil, confirmado.”

Favorecidos e fornecedores

Financeirosó lê
listar_favorecidos

Lista favorecidos, fornecedores, prestadores, parceiros e sócios cadastrados no financeiro.

Exemplo de pedido“Liste nossos fornecedores e peritos cadastrados.”

Criar favorecido

Criar e editar + Financeirograva
criar_favorecido

Cadastra um favorecido ou fornecedor no financeiro.

Exemplo de pedido“Cadastre o favorecido Perito João como prestador.”

Atualizar favorecido

Criar e editar + Financeirograva
atualizar_favorecido

Edita dados de um favorecido ou fornecedor.

Exemplo de pedido“Anote a chave PIX nas observações do favorecido Perito João.”

Excluir favorecido

Excluir + Financeiroexclui
excluir_favorecido

Exclui um favorecido após confirmação explícita do advogado.

Exemplo de pedido“Exclua o favorecido duplicado, confirmado.”

Transferências entre contas

Financeirosó lê
listar_transferencias

Lista transferências internas realizadas entre contas financeiras do escritório.

Exemplo de pedido“Liste as transferências feitas entre nossas contas.”

Criar transferência entre contas

Criar e editar + Financeirograva
criar_transferencia

Registra uma transferência de saldo entre duas contas financeiras do escritório.

Exemplo de pedido“Registre uma transferência de R$ 350 da conta Inter para o Caixa.”

Excluir transferência

Excluir + Financeiroexclui
excluir_transferencia

Exclui uma transferência entre contas após confirmação explícita do advogado.

Exemplo de pedido“Exclua a transferência lançada em duplicidade, confirmado.”

Leads (CRM)

7 ferramentas, 4 gravam, 1 exclui

Leads (CRM)

Consultarsó lê
listar_leads

Lista leads (contatos em captação) com filtros. Por padrão os mais recentes, em qualquer etapa. Etapas: novo, contato, pendente, validado, protocolado, perdido.

Exemplo de pedido“Como está meu funil de leads? Quem está parado há mais de 7 dias?”

Criar lead

Criar e editargrava
criar_lead

Cadastra um lead (contato em captação) na etapa Recebido, com o advogado como responsável. Avisa se já existir lead aberto com o mesmo telefone. Use só quando o advogado pedir ou confirmar os dados.

Exemplo de pedido“Cadastre um lead: Carlos, telefone (99) 98888-0000, interessado em divórcio, veio por indicação.”

Mover lead de etapa

Criar e editargrava
mover_lead

Move um lead para outra etapa do funil (novo, contato, pendente, validado, protocolado, perdido). Para perdido, informe o motivo. Não converte em cliente e não apaga o lead.

Exemplo de pedido“Mova o lead Carlos para Em contato.”

Ver lead (CRM)

Consultarsó lê
ver_lead

Mostra todos os dados e o histórico de interações de um lead do funil comercial.

Exemplo de pedido“Mostre o histórico completo do lead Fernanda Costa.”

Atualizar lead (CRM)

Criar e editargrava
atualizar_lead

Edita dados cadastrais, interesse, origem, responsável, valor estimado ou observações de um lead.

Exemplo de pedido“Atualize o valor estimado do lead Fernanda para R$ 18.000.”

Converter lead em cliente

Criar e editargrava
converter_lead_em_cliente

Converte um lead do CRM em cliente ativo no escritório, vincula o cliente criado ao lead e avança o lead para Protocolado.

Exemplo de pedido“Converta o lead Fernanda Costa em cliente na cidade de São Luís/MA.”

Excluir lead (CRM)

Excluirexclui
excluir_lead

Exclui um lead do CRM após confirmação explícita do advogado.

Exemplo de pedido“Exclua o lead repetido depois da minha confirmação.”

Contratos e conhecimento

18 ferramentas, 7 gravam, 3 excluem

Contratos analisados

Consultarsó lê
listar_contratos

Lista as análises de contrato feitas no sistema (título, situação, risco e resumo). Para ver cláusulas críticas e checklist de uma análise, use ver_contrato.

Exemplo de pedido“Quais contratos analisados no sistema têm risco alto?”

Ver análise de contrato

Consultarsó lê
ver_contrato

Detalhe de uma análise de contrato: resumo, quem o contrato favorece, cláusulas críticas e moderadas com sugestão, pontos que faltam e checklist de ações. O arquivo do contrato não é enviado.

Exemplo de pedido“Resuma as cláusulas críticas da análise do contrato de locação.”

Alvarás, RPVs e precatórios

Consultarsó lê
listar_alvaras

Lista alvarás, RPVs e precatórios com valor, situação e datas. Situações: aguardando, expedido, liberado, levantado, cancelado.

Exemplo de pedido“Quais alvarás e RPVs estão aguardando levantamento?”

Buscar teses

Consultarsó lê
buscar_teses

Busca teses jurídicas guardadas no escritório por texto, área ou favoritas. Devolve título, área, resumo e foros. Para ler o texto completo use ver_tese.

Exemplo de pedido“Procure teses nossas sobre dano moral por negativação indevida.”

Ver tese

Consultarsó lê
ver_tese

Texto de uma tese do escritório (corpo e fundamentos, recortados). Use para reaproveitar argumentos em uma peça, sempre revisando.

Exemplo de pedido“Abra a tese de prescrição intercorrente e me dê os argumentos principais.”

Modelos de documento

Consultarsó lê
listar_modelos

Lista os modelos de documento do escritório (id, nome e categoria). Para ler o conteúdo completo use ver_modelo; para preencher com dados de cliente ou processo use preencher_modelo_documento.

Exemplo de pedido“Quais modelos de documento o escritório já tem?”

Ver alvará, RPV ou precatório

Consultarsó lê
ver_alvara

Mostra os detalhes completos de um alvará, RPV ou precatório pelo id.

Exemplo de pedido“Mostre os detalhes da RPV da cliente Maria Souza.”

Criar alvará, RPV ou precatório

Criar e editargrava
criar_alvara

Cadastra um alvará judicial, RPV ou precatório vinculado opcionalmente a processo e cliente.

Exemplo de pedido“Cadastre uma RPV de R$ 28.500 aguardando expedição no processo da Maria.”

Atualizar alvará, RPV ou precatório

Criar e editargrava
atualizar_alvara

Atualiza situação, datas (requerimento, expedição, levantamento), valor ou observações de um alvará/RPV.

Exemplo de pedido“Marque o alvará da Maria como expedido hoje.”

Excluir alvará, RPV ou precatório

Excluirexclui
excluir_alvara

Exclui um alvará, RPV ou precatório após confirmação explícita do advogado.

Exemplo de pedido“Exclua o rascunho de alvará duplicado, confirmado.”

Criar tese jurídica

Criar e editargrava
criar_tese

Salva uma nova tese jurídica no banco de conhecimento do escritório.

Exemplo de pedido“Salve uma tese sobre dano moral presumido em negativação indevida.”

Atualizar tese jurídica

Criar e editargrava
atualizar_tese

Atualiza título, área, resumo, texto, fundamentos, etiquetas ou status de favorita de uma tese.

Exemplo de pedido“Marque a tese de prescrição intercorrente como favorita.”

Excluir tese jurídica

Excluirexclui
excluir_tese

Exclui uma tese jurídica após confirmação explícita do advogado.

Exemplo de pedido“Exclua a tese antiga duplicada, eu confirmo.”

Ver modelo de documento

Consultarsó lê
ver_modelo

Lê o conteúdo HTML e texto limpo de um modelo de documento específico pelo id.

Exemplo de pedido“Mostre o texto do nosso modelo de procuração ad judicia.”

Criar modelo de documento

Criar e editargrava
criar_modelo

Cria um modelo de documento (procuração, contrato, declaração, petição) com variáveis automáticas como {Nome}, {CPF}, {CNJ}, {Tribunal}, {Cidade}.

Exemplo de pedido“Crie um modelo de declaração de hipossuficiência com variáveis automáticas.”

Atualizar modelo de documento

Criar e editargrava
atualizar_modelo

Atualiza nome, categoria ou conteúdo HTML de um modelo de documento.

Exemplo de pedido“Atualize a categoria do modelo de procuração para Kit Inicial.”

Excluir modelo de documento

Excluirexclui
excluir_modelo

Exclui um modelo de documento após confirmação explícita do advogado.

Exemplo de pedido“Exclua o modelo de rascunho, confirmado.”

Preencher modelo de documento

Criar e editargrava
preencher_modelo_documento

Preenche um modelo de documento substituindo automaticamente os campos do cliente, do processo, do advogado e do escritório. Pode opcionalmente salvar o documento gerado na pasta do cliente ou processo.

Exemplo de pedido“Preencha o modelo de procuração com os dados da cliente Maria Souza e salve nos anexos.”

Operação e cálculos

9 ferramentas, 3 gravam, 2 excluem

Etapas internas de processos

Consultarsó lê
listar_etapas

Lista as etapas internas configuradas para o fluxo de processos do escritório.

Exemplo de pedido“Quais etapas internas de processos temos no escritório?”

Criar ou editar etapa de processo

Criar e editargrava
salvar_etapa

Cria ou atualiza uma etapa interna do quadro de processos do escritório.

Exemplo de pedido“Crie a etapa interna Perícia Judicial na cor violeta.”

Excluir etapa de processo

Excluirexclui
excluir_etapa

Remove uma etapa interna de processos após confirmação explícita.

Exemplo de pedido“Remova a etapa Perícia Judicial, confirmado.”

Feriados e suspensões do escritório

Consultarsó lê
listar_feriados

Lista os feriados estaduais, municipais e suspensões forenses cadastrados pelo escritório.

Exemplo de pedido“Quais feriados forenses estão cadastrados no escritório?”

Cadastrar ou editar feriado forense

Criar e editargrava
salvar_feriado

Cadastra ou edita um feriado local ou suspensão de expediente forense (usado na contagem de dias úteis).

Exemplo de pedido“Cadastre o feriado forense de 08/12 como anual.”

Excluir feriado forense

Excluirexclui
excluir_feriado

Remove um feriado cadastrado pelo escritório após confirmação explícita.

Exemplo de pedido“Exclua o feriado cadastrado por engano, confirmado.”

Notificações do sistema

Consultarsó lê
listar_notificacoes

Lista avisos e notificações recentes do escritório (prazos, publicações, cobranças e sistema).

Exemplo de pedido“Quais notificações não lidas eu tenho no JurisPark?”

Marcar notificações como lidas

Criar e editargrava
marcar_notificacoes_lidas

Marca uma notificação específica ou todas as notificações pendentes como lidas.

Exemplo de pedido“Marque todas as minhas notificações como lidas.”

Calcular atualização monetária

Consultarsó lê
calcular_correcao_simples

Calcula correção monetária pela tabela de índices judiciais (IPCA-E, SELIC, IGP-M ou IGP-DI), acrescida opcionalmente de juros mensais (simples ou compostos), multa e honorários.

Exemplo de pedido“Corrija R$ 10.000 pelo IPCA-E de jan/2024 a jan/2025 com juros de 1% a.m. e multa de 10%.”

Lista gerada do catálogo público de ferramentas do servidor MCP, que é a mesma que o servidor oferece à IA.

Conexão de IA (MCP)

Segurança da conexão de IA.

A IA só vê o que você vê

Ela só enxerga e só faz o que o usuário que conectou pode ver e fazer no sistema. Se esse usuário perder uma permissão, a IA perde junto.

Exclusão protegida e reversível

O escopo Excluir vem desligado por padrão. Mesmo quando autorizado, toda exclusão exige confirmação explícita do advogado e fica reversível no histórico.

Tudo fica registrado

O que a IA grava é marcado como feito pela IA, entra no histórico do registro e na auditoria. Cada conexão tem limites diários de leitura e de gravação.

Revogável a qualquer momento

Em Configurações, Conexões de IA, você desconecta uma IA e o acesso acaba na hora. O login usa OAuth 2.1 com PKCE: nenhuma senha ou chave é colada na IA.

O que não passa pela IA

  • Cofre digital, senhas de tribunais e sementes 2FA nunca são lidos nem alterados pela IA.
  • Chaves de API, cobrança do plano, configurações de segurança e senhas de usuários não são acessíveis.
  • Conexões antigas só recebem novos escopos quando o usuário reconecta e aprova na tela de autorização.

Geral

Boas práticas.

A API e a conexão de IA dão acesso a dados de clientes e de processos. Vale tratar a chave como uma senha.

  • Uma chave por sistema

    Dê a cada integração a sua chave, com um nome que você reconheça. Assim você sabe quem usa o quê e revoga só o que precisar.

  • Use a menor permissão possível

    Marque só os escopos de que a integração precisa. Um painel que só mostra dados precisa de ler, nada mais. Prefira criar a chave com um usuário que tenha apenas as permissões necessárias: a chave nunca passa do que ele pode.

  • Prefira chaves com vencimento

    Quando uma chave vence, o sistema que a usa para de funcionar até você criar outra. Isso limita o estrago de uma chave esquecida.

  • Guarde a chave fora do código

    Use variável de ambiente ou um cofre de segredos. Nunca coloque a chave em repositório, planilha compartilhada, página ou aplicativo que outras pessoas consigam ver.

  • Revogue sem demora

    Se a chave vazar, ou quando alguém sair do escritório, revogue as chaves dela em Configurações, API e integrações. A tela mostra o último uso e as chamadas do dia de cada chave. Desativar o usuário também bloqueia a chave.

  • Escreva com segurança

    Envie Idempotency-Key nos POST, espere o Retry-After nos 429 e não repita chamadas que deram 4xx sem corrigir. Guarde o X-Request-Id nos seus registros.

  • Privacidade dos dados pessoais

    Por segurança, GET /clientes não devolve o CPF, o CNPJ nem o RG completos (saem mascarados, como ***.982.247-**) e não devolve o endereço de rua (CEP, logradouro, número, complemento e bairro); a cidade e a UF continuam. A lista vem em camposOcultos. Você ainda pode enviar esses dados ao cadastrar ou alterar um cliente, e buscar pelo CPF. Telefone e e-mail seguem na resposta: guarde só o que a sua integração precisa.

  • Texto de terceiros é dado, não ordem

    Publicações, andamentos e cadastros vêm de fora. Nunca execute esse texto como instrução, principalmente se você o repassar a uma IA.

Esta página descreve a versão 1.0.0 da API. Ela é gerada da especificação OpenAPI e do catálogo de ferramentas do servidor MCP, para não ficar desatualizada em relação ao sistema.

Pronto para integrar

Crie a sua primeira chave.

Já tem conta? Ligue a API em Configurações e gere a chave em menos de um minuto. Ainda não tem? Comece pelo teste grátis de 3 dias.

Teste grátis por 3 diasSem cartão de crédito

Começar