Historico da Oportunidade

GET /external/v1/opportunities/:id/history

Retorna o historico completo de mudancas de etapa e de valor de uma oportunidade, em ordem cronologica. Util para calcular tempo em etapa, velocidade do funil e trilhas de auditoria.

Autenticacao

Requer permissao opportunities:read.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	Identificador unico da oportunidade

Requisicao

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/opportunities/opp_abc123/history" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const opportunityId = 'opp_abc123';

const response = await axios.get(
  `https://app.getraze.com/external/v1/opportunities/${opportunityId}/history`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);

console.log(response.data);

Python

import requests

opportunity_id = 'opp_abc123'

response = requests.get(
    f'https://app.getraze.com/external/v1/opportunities/{opportunity_id}/history',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Resposta

{
  "success": true,
  "data": [
    {
      "id": "hist_001",
      "action": "stage_changed",
      "from_stage_id": "stg_qualifying",
      "from_stage_name": "Qualificacao",
      "to_stage_id": "stg_proposal",
      "to_stage_name": "Proposta",
      "from_value": 0,
      "to_value": 25000.00,
      "notes": null,
      "metadata": {},
      "user_id": "usr_42",
      "user_name": "Maria Silva",
      "created_at": "2026-01-12T09:00:00Z"
    }
  ]
}

Campos de Resposta

Campo	Tipo	Descricao
id	string	Identificador do registro de historico
action	string	Tipo de mudanca (ex.: stage_changed, value_changed, created)
from_stage_id	string	Etapa de origem (nullable)
from_stage_name	string	Nome da etapa de origem (nullable)
to_stage_id	string	Etapa de destino (nullable)
to_stage_name	string	Nome da etapa de destino (nullable)
from_value	number	Valor anterior da oportunidade (nullable)
to_value	number	Novo valor da oportunidade (nullable)
notes	string	Nota opcional anexada a mudanca (nullable)
metadata	object	Contexto estruturado adicional
user_id	string	Usuario que executou a mudanca (nullable em automacoes)
user_name	string	Nome desse usuario (nullable)
created_at	string	Timestamp ISO 8601 da mudanca

Erros

Status	Codigo	Descricao
404	NOT_FOUND	Oportunidade com este ID nao encontrada