Get one CrmOpportunityHistory

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>'

import requests

url = "https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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

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"

const response = await fetch(
  'https://spaces.nexudus.com/api/crm/crmopportunityhistories/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/crm/crmopportunityhistories/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

integer

The opportunity this history entry belongs to.

integer

CRM stage the opportunity moved from (null for the initial placement).

string

Name of the previous CRM stage.

string

When the opportunity entered the previous stage.

string

When the opportunity left the previous stage and entered the new one.

integer

CRM stage the opportunity moved to.

string

Name of the new CRM stage.

integer

Admin user who triggered the stage transition (null if moved automatically).

string

Full name of the admin user who triggered the transition.

integer

Unique record identifier.

string

UUID of the record.

string

Date and time the record was created (ISO 8601).

string

Date and time the record was last updated (ISO 8601).

string

Email of the user who last updated this record.

boolean

Whether the record was recently created.

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
}

Get multiple CrmOpportunityHistoriesRetrieve multiple CrmOpportunityHistory records by their Ids in a single request.

Get one CrmOpportunityHistory

curl --request GET \
  --url https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/crm/crmopportunityhistories/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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>"
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Get one CrmOpportunityHistory

Authentication

Path Parameters

Code Examples

Response

200

​Authentication

​Path Parameters

​Code Examples

​Response

​200

Authentication

Path Parameters

Code Examples

Response

200