Opportunity History

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

Returns the full stage-change and value-change history of an opportunity, in chronological order. Useful to compute time-in-stage, funnel velocity and audit trails.

Authentication

Requires opportunities:read permission.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the opportunity

Request

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())

Response

{
  "success": true,
  "data": [
    {
      "id": "hist_001",
      "action": "stage_changed",
      "from_stage_id": "stg_qualifying",
      "from_stage_name": "Qualifying",
      "to_stage_id": "stg_proposal",
      "to_stage_name": "Proposal",
      "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"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	History entry identifier
action	string	Type of change (e.g. stage_changed, value_changed, created)
from_stage_id	string	Stage the opportunity moved from (nullable)
from_stage_name	string	Name of the origin stage (nullable)
to_stage_id	string	Stage the opportunity moved to (nullable)
to_stage_name	string	Name of the destination stage (nullable)
from_value	number	Previous opportunity value (nullable)
to_value	number	New opportunity value (nullable)
notes	string	Optional note attached to the change (nullable)
metadata	object	Additional structured context
user_id	string	User who performed the change (nullable for automations)
user_name	string	Name of that user (nullable)
created_at	string	ISO 8601 timestamp of the change

Errors

Status	Code	Description
404	NOT_FOUND	Opportunity with this ID was not found