Endpoint

Minhas tarefas

GET/api/v1/{escritorio}/minhas-tarefas

Meus Prazos e Tarefas: os trabalhos e prazos abertos da pessoa, por vencimento, com os indicadores. tipo filtra a lista (os indicadores contam tudo); concluidos=1 inclui os concluídos. pessoa é meus (padrão), equipe ou o identificador de um membro, e os dois últimos exigem Ver dados de toda a equipe (403 SEM_PERMISSAO).

Permissão exigida

Painel, Agenda e Tarefas: Acessar as Tarefas; `pessoa` diferente de `meus` exige Ver dados de toda a equipe

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.

Parâmetros de consulta

tipotexto
O que listar.
Valores: tudotrabalhosprazos
Padrão: tudo
pessoatexto
meus, equipe ou o identificador de um membro (listar_membros).
Padrão: meus
concluidostexto
1 inclui os concluídos.
Valores: 01
Padrão: 0

Testar

Exemplo

cURL

curl -X GET "https://developer.jur.ia2s.com.br/api/v1/10345/minhas-tarefas" \
  -H "Authorization: Bearer SEU_TOKEN"

Node

// Node 18 ou mais novo, em um arquivo .mjs
const resposta = await fetch("https://developer.jur.ia2s.com.br/api/v1/10345/minhas-tarefas", {
  method: "GET",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
  },
});
console.log(resposta.status, await resposta.json());

Python

import requests

resposta = requests.get(
    "https://developer.jur.ia2s.com.br/api/v1/10345/minhas-tarefas",
    headers={"Authorization": "Bearer SEU_TOKEN"},
)
print(resposta.status_code)
print(resposta.json())

Respostas

200

Sucesso.

{
  "itens": [
    {
      "tipo": "PRAZO",
      "id": "0190a000-0000-7000-8000-000000000001",
      "nome": "Réplica",
      "prioridade": "ALTA",
      "responsaveis": [
        "0190a000-0000-7000-8000-000000000003"
      ],
      "vencimento": "2026-11-20",
      "dataFatal": "2026-11-25",
      "concluido": false,
      "cliente": {
        "codigo": "EX-0001",
        "nome": "Maria Oliveira"
      },
      "processo": {
        "id": "0190a000-0000-7000-8000-000000000002",
        "rotulo": "0001234-56.2026.5.02.0001",
        "departamentoId": "0190a000-0000-7000-8000-000000000003",
        "departamento": "Trabalhista"
      },
      "pendentes": []
    }
  ],
  "kpis": {
    "abertos": 1,
    "trabalhosAbertos": 0,
    "prazosAbertos": 1,
    "atrasados": 0,
    "fatais7": 0,
    "concluidos": 0
  }
}

Campos da resposta

itenslista de objetosobrigatório
- tipotextoobrigatório
  Valores: TRABALHOPRAZO
- idtextoobrigatório
- nometextoobrigatório
- prioridadetextoobrigatório
  Normal, alta ou urgente.
  Valores: NORMALALTAURGENTE
- responsaveislista de textosobrigatório
  Identificadores dos responsáveis.
- vencimentotextoobrigatório
  AAAA-MM-DD.
- dataFataltexto ou nuloobrigatório
  AAAA-MM-DD; só nos prazos.
- concluidoverdadeiro ou falsoobrigatório
  Concluído, no trabalho; cumprido, no prazo.
- clienteobjetoobrigatório
  - codigotextoobrigatório
  - nometextoobrigatório
- processoobjeto ou nuloobrigatório
  O processo do prazo; nulo no trabalho.
  - idtextoobrigatório
  - rotulotextoobrigatório
  - departamentoIdtextoobrigatório
  - departamentotextoobrigatório
- pendenteslista de objetosobrigatório
  - idtextoobrigatório
    Identificador da solicitação.
  - campotextoobrigatório
    Qual data foi pedida.
    Valores: VENCIMENTOFATAL
  - dataNovatextoobrigatório
    AAAA-MM-DD; só vale depois da aprovação.
  - solicitanteIdtextoobrigatório
  - criadoEmtextoobrigatório
kpisobjetoobrigatório
- abertosnúmero inteiroobrigatório
- trabalhosAbertosnúmero inteiroobrigatório
- prazosAbertosnúmero inteiroobrigatório
- atrasadosnúmero inteiroobrigatório
  Abertos com vencimento antes de hoje.
- fatais7número inteiroobrigatório
  Abertos com data fatal em até 7 dias.
- concluidosnúmero inteiroobrigató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

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