API ADVBOX
Tasks

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_name ou user_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_start sem date_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 lawsuit com dados do processo
  • Cada tarefa inclui array users com responsáveis
GET
/posts

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

date_start?string

[Optional] Data inicial para filtrar por data da tarefa (formato: YYYY-MM-DD). Deve ser usado com date_end.

Formatdate
date_end?string

[Optional] Data final para filtrar por data da tarefa (formato: YYYY-MM-DD). Deve ser usado com date_start.

Formatdate
created_start?string

[Optional] Data inicial para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado com created_end.

Formatdate
created_end?string

[Optional] Data final para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado com created_start.

Formatdate
deadline_start?string

[Optional] Data inicial para filtrar por prazo (formato: YYYY-MM-DD). Deve ser usado com deadline_end.

Formatdate
deadline_end?string

[Optional] Data final para filtrar por prazo (formato: YYYY-MM-DD). Deve ser usado com deadline_start.

Formatdate
completed_start?string

[Optional] Data inicial para filtrar por data de conclusão (formato: YYYY-MM-DD). Deve ser usado com completed_end.

Formatdate
completed_end?string

[Optional] Data final para filtrar por data de conclusão (formato: YYYY-MM-DD). Deve ser usado com completed_start.

Formatdate
user_id?string

[Optional] ID exato do usuário responsável.

user_name?string

[Optional] Nome do usuário responsável (busca parcial case-insensitive).

task_id?string

[Optional] ID exato do tipo de tarefa.

id?integer

[Optional] ID exato de uma tarefa específica.

lawsuit_id?string

[Optional] ID exato do processo associado.

limit?integer

[Optional] Número de itens por página (recomendado: 1-100).

Default1000
Range1 <= value <= 100
offset?integer

[Optional] Número de itens a pular antes de iniciar a resposta (paginação).

Default0
Range0 <= value

Response 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."
}