openthorDocumentação
Abrir o painel

GET /v1/agg/goals/mine

Meta × realizado da PRÓPRIA marca do fornecedor (venda + positivação), murada. · domínio Metas

Exemplo

cURL
curl -H "Authorization: Bearer ot_live_SEU_TOKEN_AQUI" \
  "https://api.openthor.dev/v1/agg/goals/mine?from=2026-06-01&to=2026-06-30&limit=5"

A autenticação e o formato do envelope { data, meta } são comuns a todos os endpoints — veja Autenticação e Resposta e metadados.

Filtros e período

Este endpoint não aceita filtros por campo.

Janela de datas: from/to (inclusivos, formato YYYY-MM-DD) sobre period.

Métricas

Selecione com metrics=m1,m2 (padrão: todas):

  • target_value — Meta (R$)
  • realized_value — Realizado bruto (R$)
  • pct_attained — % atingido (bruto)
  • customers_target — Meta de positivação
  • customers_realized — Positivação realizada
  • pct_attained_customers

Ordenação e paginação

Ordene com sort=coluna (crescente) ou sort=-coluna (decrescente). Colunas ordenáveis: target_value · realized_value · pct_attained. Limite padrão 1, máximo 1 linhas por chamada; pagine com offset enquanto meta.has_more for true.

O que sua chave enxerga

O recorte da credencial (filial, vendedor, cliente, fornecedor, janela de datas) é aplicado no servidor e não pode ser ampliado por filtros — dois usuários podem ver totais diferentes no mesmo endpoint, por desenho.