Listar e consultar metas

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo objectives:read e a permissão Metas (visualizar).
Só vêm as metas que a pessoa pode ver, pela visibility de cada uma: rascunho só para quem criou; criador, responsável e participantes sempre veem.
Filtros: type (resultado, projeto, rotina, sim_nao), priority (baixa, media, alta, critica), owner_scope (empresa, time, quadro), team_id, board_id, parent_id (metas-filhas de uma meta maior), status (open junta não iniciada e em andamento, ou rascunho, nao_iniciada, em_andamento, concluida, cancelada), situation (on_track, at_risk, late, done, canceled), metric_key (metas com métrica por integração com essa chave) e search (nome).
progress.percent tem teto de 100; progress.achievement não tem teto; progress.suggested_result é o resultado pelas faixas da meta; progress.source diz de onde vem o progresso (metrics, tasks, marcos, checkins ou confirmacao). No projeto por marcos, progress.items_total e progress.items_done contam as tarefas principais e os marcos sem tarefas. Meta medida por métricas sem métrica fica em 0.
pace é o ritmo: elapsed_percent, ideal_percent, days_left, days_total, days_elapsed, projection_percent e achievement.
A resposta é paginada: até 100 por página com per_page (padrão 20).
Meta arquivada não aparece na lista e responde 404 na consulta.

Referência

GET /objectives na Referência da API GET /objectives/{objective} na Referência da API

Como fazer

Metas de resultado da empresa, abertas e em risco:

cURL

curl "$MICORE_BASE_URL/objectives?owner_scope=empresa&type=resultado&status=open&situation=at_risk" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Uma meta:

cURL

curl "$MICORE_BASE_URL/objectives/58" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Resposta

Resposta · 200

{
    "data": [
        {
            "id": 58,
            "name": "Disponibilidade do sistema Novembro",
            "type": "resultado",
            "priority": "alta",
            "owner_scope": "quadro",
            "team": null,
            "visibility": "empresa",
            "parent": null,
            "progress_mode": "metricas",
            "routine": null,
            "bands": {
                "partial_from": 80,
                "exceeded_from": 120
            },
            "checkin": {
                "cadence": null,
                "weekday": null
            },
            "alerts": {
                "off_pace": {
                    "on": true,
                    "pct": 10
                },
                "deadline": {
                    "on": true,
                    "days": 3
                },
                "milestone": {
                    "on": false
                },
                "checkin_late": {
                    "on": false
                },
                "recipients": [
                    "responsavel",
                    "gestor"
                ]
            },
            "on_complete": {
                "next": true,
                "notify": true,
                "report": false,
                "archive_open_tasks": false
            },
            "participants": [],
            "milestones": [],
            "confirmation": null,
            "recurrence": "monthly",
            "recurrence_name": "Disponibilidade do sistema",
            "recurrence_source_id": 41,
            "description": null,
            "achievement_criteria": "Servidores no ar 99,9% do mês.",
            "board": {
                "id": 2,
                "name": "Operação"
            },
            "responsible": {
                "id": 7,
                "name": "Ana Souza"
            },
            "date_start": "2026-11-01",
            "date_end": "2026-11-30",
            "status": "em_andamento",
            "situation": "on_track",
            "progress": {
                "percent": 100,
                "achievement": 100,
                "suggested_result": "atingida",
                "source": "metrics"
            },
            "pace": {
                "elapsed_percent": 40,
                "ideal_percent": 40,
                "days_left": 18,
                "days_total": 30,
                "days_elapsed": 12,
                "projection_percent": 100,
                "achievement": 100
            },
            "closure": null,
            "metrics": [
                {
                    "id": 131,
                    "name": "Disponibilidade dos servidores",
                    "source": "integration",
                    "integration_key": "sentinel.availability",
                    "indicator_key": null,
                    "indicator_filters": null,
                    "direction": "manter",
                    "baseline_value": null,
                    "tolerance_min": 99.900000000000005684341886080801486968994140625,
                    "tolerance_max": 100,
                    "weight": null,
                    "count_scope": null,
                    "target_value": 99.900000000000005684341886080801486968994140625,
                    "current_value": 99.9500000000000028421709430404007434844970703125,
                    "unit": "%",
                    "percent": 100,
                    "task_template_id": null,
                    "user_id": null,
                    "frequency": null,
                    "frequency_target": null,
                    "updated_at": "2026-11-12T09:00:00-03:00"
                }
            ],
            "created_at": "2026-11-01T01:00:00-03:00",
            "updated_at": "2026-11-12T09:00:00-03:00"
        }
    ],
    "links": {
        "first": "...",
        "last": "...",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "per_page": 20,
        "total": 1
    }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.