Endpoint

Adicionar cliente ao processo

POST/api/v1/{escritorio}/processos/{id}/clientes

Põe um cliente com contrato fechado no processo, como litisconsorte. 409 se ele já está no processo.

Permissão exigida

Operacional: Gerenciar partes e litisconsortes

Só leitura recusa com 403

Parâmetros de caminho

escritoriotextoobrigatório
Código do escritório, com 5 dígitos. Os escritórios em que o token vale estão em GET /api/v1/eu.
idtextoobrigatório
Identificador do processo.

Parâmetros de cabeçalho

Idempotency-Keytexto
Opcional. Uma chave única por operação (por exemplo, um UUID). Se o mesmo pedido for reenviado com a mesma chave em até 24 horas, a resposta da primeira vez é devolvida e nada é criado de novo.

Corpo

codigotextoobrigatório
Código do cliente.

Testar

Exemplo

cURL

curl -X POST "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/clientes" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "codigo": "EX-0001"
}'

Node

// Node 18 ou mais novo, em um arquivo .mjs
const resposta = await fetch("https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/clientes", {
  method: "POST",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "codigo": "EX-0001"
  }),
});
console.log(resposta.status, await resposta.json());

Python

import requests

resposta = requests.post(
    "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/clientes",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    json={
        "codigo": "EX-0001",
    },
)
print(resposta.status_code)
print(resposta.json())

Respostas

201

Sucesso.

{
  "id": "0190a000-0000-7000-8000-000000000001",
  "clienteCodigo": "EX-0001",
  "clientes": [
    {
      "codigo": "EX-0001",
      "nome": "Maria Oliveira",
      "principal": true
    }
  ],
  "departamentoId": "0190a000-0000-7000-8000-000000000002",
  "natureza": "JUDICIAL",
  "origemId": null,
  "raizId": null,
  "tipoRelacao": null,
  "statusId": "0190a000-0000-7000-8000-000000000003",
  "descricao": "Horas extras",
  "assunto": null,
  "numeroCnj": "00012342720265020001",
  "tribunalSigla": "TRT2",
  "grau": "PRIMEIRO_GRAU",
  "justica": "TRABALHO",
  "enteDevedor": null,
  "comarca": "São Paulo",
  "vara": null,
  "magistrado": null,
  "classe": null,
  "autor": "Maria Oliveira",
  "autorDoc": null,
  "reu": "Empresa Exemplo Ltda.",
  "reuDoc": null,
  "partes": [],
  "dtDistribuicao": "2026-02-10",
  "dtSentenca": null,
  "resultadoSentenca": null,
  "dtTransito": null,
  "dtArquivamento": null,
  "numeroAdm": null,
  "orgao": null,
  "dtDer": null,
  "tipoBeneficio": null,
  "statusGerid": null,
  "etiquetas": [],
  "contagens": {
    "andamentos": 3,
    "prazosAbertos": 1,
    "trabalhosAbertos": 0
  },
  "criadoEm": "2026-11-06T12:00:00.000Z"
}

Campos da resposta

idtextoobrigatório
clienteCodigotextoobrigatório
Código do cliente principal.
clienteslista de objetosobrigatório
O cliente principal e os litisconsortes.
- codigotextoobrigatório
- nometextoobrigatório
- principalverdadeiro ou falsoobrigatório
departamentoIdtextoobrigatório
naturezatextoobrigatório
Valores: JUDICIALADMINISTRATIVOCONSULTIVO
origemIdtexto ou nuloobrigatório
Processo de origem, quando este é um processo relacionado.
raizIdtexto ou nuloobrigatório
Processo raiz da árvore; nulo na própria raiz e em processo sem relacionados.
tipoRelacaotexto ou nuloobrigatório
Tipo de relação com o processo de origem; nulo na raiz e em processo sem relacionados.
Valores: CUMPRIMENTO_SENTENCARECURSOAGRAVO_INSTRUMENTORPVPRECATORIOALVARAOUTRO
statusIdtextoobrigatório
descricaotexto ou nuloobrigatório
assuntotexto ou nuloobrigatório
Pedido no caso consultivo.
numeroCnjtexto ou nuloobrigatório
Só os 20 dígitos.
tribunalSiglatexto ou nuloobrigatório
grautexto ou nuloobrigatório
Valores: PRIMEIRO_GRAUSEGUNDO_GRAU
justicatexto ou nuloobrigatório
Valores: SUPERIORFEDERALTRABALHOELEITORALMILITAR_UNIAOESTADUALMILITAR_ESTADUAL
enteDevedortexto ou nuloobrigatório
Valores: FEDERALESTADUALMUNICIPALPARTICULAR
comarcatexto ou nuloobrigatório
varatexto ou nuloobrigatório
magistradotexto ou nuloobrigatório
classetexto ou nuloobrigatório
autortexto ou nuloobrigatório
autorDoctexto ou nuloobrigatório
reutexto ou nuloobrigatório
reuDoctexto ou nuloobrigatório
parteslista de objetosobrigatório
- idtextoobrigatório
- polotextoobrigatório
  Valores: ATIVOPASSIVO
- nometextoobrigatório
- documentotexto ou nuloobrigatório
- ordemnúmero inteiroobrigatório
dtDistribuicaotexto ou nuloobrigatório
AAAA-MM-DD.
dtSentencatexto ou nuloobrigatório
AAAA-MM-DD.
resultadoSentencatexto ou nuloobrigatório
Valores: PROCEDENTEPARCIALMENTE_PROCEDENTEIMPROCEDENTE
dtTransitotexto ou nuloobrigatório
AAAA-MM-DD.
dtArquivamentotexto ou nuloobrigatório
AAAA-MM-DD.
numeroAdmtexto ou nuloobrigatório
orgaotexto ou nuloobrigatório
dtDertexto ou nuloobrigatório
AAAA-MM-DD.
tipoBeneficiotexto ou nuloobrigatório
statusGeridtexto ou nuloobrigatório
etiquetaslista de textosobrigatório
Identificadores das etiquetas.
contagensobjetoobrigatório
- andamentosnúmero inteiroobrigatório
- prazosAbertosnúmero inteiroobrigatório
- trabalhosAbertosnúmero inteiroobrigatório
  Só os do caso, no consultivo.
criadoEmtextoobrigatório

400

Corpo ou parâmetro inválido.

INVALIDO

{
  "codigo": "INVALIDO",
  "mensagem": "Confira os dados informados.",
  "campos": {
    "departamentoId": "Valor inválido."
  }
}

CHAVE_IDEMPOTENCIA_INVALIDA

{
  "codigo": "CHAVE_IDEMPOTENCIA_INVALIDA",
  "mensagem": "A Idempotency-Key deve ter de 1 a 255 caracteres visíveis, sem espaços."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

401

Sem token, ou token revogado ou expirado, ou pessoa desativada.

TOKEN_INVALIDO

{
  "codigo": "TOKEN_INVALIDO",
  "mensagem": "Token de API inválido, expirado ou revogado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

403

A pessoa não pode fazer isto, o token é só de leitura, foi bloqueado neste escritório, não tem esta operação, quem o gerou saiu do escritório ou o acesso ao escritório está suspenso.

SEM_PERMISSAO

{
  "codigo": "SEM_PERMISSAO",
  "mensagem": "Sem permissão para esta alteração."
}

TOKEN_SO_LEITURA

{
  "codigo": "TOKEN_SO_LEITURA",
  "mensagem": "Este token é só de leitura."
}

TOKEN_SEM_ESCOPO

{
  "codigo": "TOKEN_SEM_ESCOPO",
  "mensagem": "Este token não tem permissão para esta operação."
}

TOKEN_BLOQUEADO

{
  "codigo": "TOKEN_BLOQUEADO",
  "mensagem": "Este token foi bloqueado pela administração deste escritório."
}

TOKEN_AUTOR_INATIVO

{
  "codigo": "TOKEN_AUTOR_INATIVO",
  "mensagem": "Quem gerou este token não está mais ativo neste escritório."
}

ESCRITORIO_SUSPENSO

{
  "codigo": "ESCRITORIO_SUSPENSO",
  "mensagem": "O acesso a este escritório está suspenso. Fale com a IA2S."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

404

Não existe, está fora do alcance da pessoa, ou o escritório do caminho não é dela.

NAO_ENCONTRADO

{
  "codigo": "NAO_ENCONTRADO",
  "mensagem": "Não encontrado."
}

ESCRITORIO_NAO_ENCONTRADO

{
  "codigo": "ESCRITORIO_NAO_ENCONTRADO",
  "mensagem": "Escritório não encontrado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

409

Conflito: veja o campo `codigo`.

TENTE_NOVAMENTE

{
  "codigo": "TENTE_NOVAMENTE",
  "mensagem": "Outra pessoa alterou isto ao mesmo tempo. Tente novamente."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

413

Corpo da requisição grande demais.

CORPO_GRANDE

{
  "codigo": "CORPO_GRANDE",
  "mensagem": "O corpo da requisição é grande demais."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

422

A `Idempotency-Key` já foi usada com outro pedido.

CHAVE_IDEMPOTENCIA_REUTILIZADA

{
  "codigo": "CHAVE_IDEMPOTENCIA_REUTILIZADA",
  "mensagem": "Esta Idempotency-Key já foi usada com outro pedido."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

429

Limite de 120 requisições por minuto.

Cabeçalho Retry-After: Segundos até poder tentar de novo.

LIMITE_TOKEN

{
  "codigo": "LIMITE_TOKEN",
  "mensagem": "Muitas requisições com este token. Tente de novo em um minuto."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

503

O sistema está ocupado. Tente em instantes.

SISTEMA_OCUPADO

{
  "codigo": "SISTEMA_OCUPADO",
  "mensagem": "O sistema está ocupado. Tente em instantes."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório