---
title: "Listar metas"
method: GET
path: "/api/management/goals"
tags: ["goals"]
---

# Listar metas

`GET /api/management/goals`

Retorna a lista paginada de metas, ordenada por status (ativas primeiro) e por data de criação decrescente. Cada meta inclui suas metas filhas, a contagem de resultados e a variação percentual de progresso em relação ao último resultado registrado.

## Query parameters

- `filter[title]` string
- `filter[status]` 'active' | ' inactive' | ' completed'
- `filter[type]` string
- `filter[comparison_mode]` string
- `filter[periodicity]` string
- `filter[user_id]` string
- `filter[funnel_step_id]` string
- `filter[start_date_gte]` string
- `filter[end_date_lte]` string
- `filter[trashed]` string
- `sort` string
- `page` string
- `perPage` string

## Response `200`

Sucesso

- object
  - `goals` object[]
    - `id` string
    - `title` string
    - `description` string
    - `status` string
    - `start_date` string, date
    - `end_date` string, date
    - `periodicity` integer
    - `type` string
    - `user_id` string, uuid — ID do usuário associado à meta (tipos projects_created_by_user e funnel_steps_links_by_user).
    - `funnel_step_id` integer — ID da etapa do funil (tipos funnel_steps_links e funnel_steps_links_by_user).
    - `target` integer
    - `unit` string
    - `comparison_mode` string
    - `progress` integer
    - `children` unknown[]
      - unknown
    - `progress_change_percentage` integer
    - `percentage` integer
    - `results_count` integer
    - `is_past_calculable` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `per_page` integer
    - `to` integer
    - `total` integer
  - `response` boolean

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/4859f7ec8b64/schema)