Obtenha uma lista de tarefas com filtros opcionais
Retorna lista de tarefas do escritório com múltiplos filtros opcionais.
📋 Comportamento do filtro de status:
- Sem filtros: retorna todas as tarefas (pendentes e concluídas)
- Com
user_nameouuser_id: retorna APENAS tarefas onde aquele usuário específico está pendente - Com
lawsuit_id: retorna APENAS tarefas pendentes do processo - Com
completed_start/completed_end: retorna APENAS tarefas concluídas no período
Nota: Tarefas podem ter múltiplos usuários com status diferentes. O filtro por usuário considera o status individual daquele usuário na tarefa.
⚠️ IMPORTANTE - Filtros de Data:
- Cada par de datas deve ser usado completo (start + end juntos)
- Usar apenas 1 parâmetro do par (ex: só
date_startsemdate_end) faz a API IGNORAR o filtro - Pares disponíveis:
date_start/date_end,created_start/created_end,deadline_start/deadline_end,completed_start/completed_end - Você pode usar um ou mais pares ao mesmo tempo
Como funcionam os filtros:
- Múltiplos filtros são combinados com AND (interseção)
- Todos os parâmetros são opcionais
user_name: busca parcial (LIKE)user_id,id,task_id,lawsuit_id: busca exata
Paginação:
- Default: limit=1000, offset=0
- Limit recomendado: entre 1 e 100
Estrutura da resposta:
- Cada tarefa inclui objeto
lawsuitcom dados do processo - Cada tarefa inclui array
userscom responsáveis
Authorization
BearerAuth In: header
Query Parameters
[Optional] Data inicial para filtrar por data da tarefa (formato: YYYY-MM-DD). Deve ser usado com date_end.
date[Optional] Data final para filtrar por data da tarefa (formato: YYYY-MM-DD). Deve ser usado com date_start.
date[Optional] Data inicial para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado com created_end.
date[Optional] Data final para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado com created_start.
date[Optional] Data inicial para filtrar por prazo (formato: YYYY-MM-DD). Deve ser usado com deadline_end.
date[Optional] Data final para filtrar por prazo (formato: YYYY-MM-DD). Deve ser usado com deadline_start.
date[Optional] Data inicial para filtrar por data de conclusão (formato: YYYY-MM-DD). Deve ser usado com completed_end.
date[Optional] Data final para filtrar por data de conclusão (formato: YYYY-MM-DD). Deve ser usado com completed_start.
date[Optional] ID exato do usuário responsável.
[Optional] Nome do usuário responsável (busca parcial case-insensitive).
[Optional] ID exato do tipo de tarefa.
[Optional] ID exato de uma tarefa específica.
[Optional] ID exato do processo associado.
[Optional] Número de itens por página (recomendado: 1-100).
10001 <= value <= 100[Optional] Número de itens a pular antes de iniciar a resposta (paginação).
00 <= valueResponse Body
application/json
application/json
application/json
curl -X GET "https://app.advbox.com.br/api/v1/posts"{
"offset": 0,
"limit": 100,
"totalCount": 532,
"data": [
{
"id": 123456789,
"date": "2025-05-12 00:00:00",
"date_deadline": null,
"task": "AUDIÊNCIA PRELIMINAR",
"reward": 0,
"notes": "Comparecer à audiência preliminar do processo. Levar documentos de identificação do cliente e procuração.",
"local": null,
"lawsuits_id": 1234567,
"created_at": "2025-05-12 15:47:45",
"lawsuit": {
"id": 1234567,
"process_number": "0001234-56.2025.8.26.0100",
"protocol_number": null,
"customers": [
{
"customer_id": 1234567,
"name": "João Silva",
"identification": null,
"customers_origins_id": null
}
]
},
"users": [
{
"user_id": 163,
"name": "Maria Oliveira",
"completed": null,
"important": 1,
"urgent": 0
}
]
}
]
}{
"error": "Invalid date format. Use YYYY-MM-DD"
}{
"error": "Unauthenticated."
}