Skip to main content
GET
/
api
/
crm
/
crmopportunityhistories
/
{id}
Get one CrmOpportunityHistory
curl --request GET \
  --url https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "CrmOpportunityId": 123,
  "OldCrmBoardColumnId": 123,
  "OldCrmBoardColumnName": "<string>",
  "FromTime": "<string>",
  "ToTime": "<string>",
  "NewCrmBoardColumnId": 123,
  "NewCrmBoardColumnName": "<string>",
  "UserId": 123,
  "UserFullName": "<string>",
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}
A CrmOpportunityHistory records a single stage transition for a CRM opportunity. Each time an opportunity moves from one CRM stage to another, a history entry is created capturing the previous stage, the new stage, when the move happened, and which admin user triggered it. Use this entity to audit the movement of opportunities across a CRM board over time. The History tab on an opportunity in the Nexudus UI displays these records.

​
Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CrmOpportunityHistory-Read role.

​
Path Parameters

​
id
integer
required
The Id of the CrmOpportunityHistory record to retrieve.

​
Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/crm/crmopportunityhistories/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
200

​
CrmOpportunityId
integer
The opportunity this history entry belongs to.
​
OldCrmBoardColumnId
integer
CRM stage the opportunity moved from (null for the initial placement).
​
OldCrmBoardColumnName
string
Name of the previous CRM stage.
​
FromTime
string
When the opportunity entered the previous stage.
​
ToTime
string
When the opportunity left the previous stage and entered the new one.
​
NewCrmBoardColumnId
integer
CRM stage the opportunity moved to.
​
NewCrmBoardColumnName
string
Name of the new CRM stage.
​
UserId
integer
Admin user who triggered the stage transition (null if moved automatically).
​
UserFullName
string
Full name of the admin user who triggered the transition.
​
Id
integer
Unique record identifier.
​
UniqueId
string
UUID of the record.
​
CreatedOn
string
Date and time the record was created (ISO 8601).
​
UpdatedOn
string
Date and time the record was last updated (ISO 8601).
​
UpdatedBy
string
Email of the user who last updated this record.
​
IsNew
boolean
Whether the record was recently created.
​
SystemId
string
External system identifier.
Example Response
{
  "CrmOpportunityId": null,
  "OldCrmBoardColumnId": null,
  "OldCrmBoardColumnName": null,
  "FromTime": null,
  "ToTime": null,
  "NewCrmBoardColumnId": 0,
  "NewCrmBoardColumnName": null,
  "UserId": null,
  "UserFullName": null,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "CrmOpportunityHistory Example",
  "LocalizationDetails": null,
  "CustomFields": null
}