Histórico de etapas (BI)

GET/api/v1/reporting/stage-history

Histórico de entrada de deals em etapas · crítico pra calcular Lead Time. É obrigatório informar `deal_id` OU `updated_since` (sem nenhum dos dois: 422).

Parâmetros de query

`deal_id` string	Entradas de 1 deal · aceita tanto o ID externo (ex.: Pipedrive) quanto o ID nativo do CRM.
`updated_since` string (ISO 8601)	Entradas com `entered_at >=` esta data (sync incremental).
`page` number	Número da página (≥ 1). default: `1`
`per_page` number	Itens por página (1-200). default: `100`

Ordenação: entered_at ASC (linha do tempo).

Autenticação: header Authorization: Bearer rmk_... · veja Introdução e autenticação.

curl "https://crmdojordao.com.br/api/v1/reporting/stage-history" \
  -H "Authorization: Bearer rmk_SUA_CHAVE"

Resposta · GET /api/v1/reporting/stage-history

{
  "data": [
    {
      "id": "dsh_001",
      "deal_id": "12345",
      "stage_id": "stg_novo_lead",
      "stage": "Novo lead",
      "entered_at": "2026-07-01T13:30:00.000Z"
    },
    {
      "id": "dsh_002",
      "deal_id": "12345",
      "stage_id": "stg_proposta_enviada",
      "stage": "Proposta enviada",
      "entered_at": "2026-07-08T16:40:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 100,
    "has_more": false,
    "next_page": null
  }
}