> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one CrmOpportunityHistory

> Retrieve a single CrmOpportunityHistory record by its Id.

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

<Note>
  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.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the CrmOpportunityHistory record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/crm/crmopportunityhistories/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

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

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

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

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="CrmOpportunityId" type="integer">
  The opportunity this history entry belongs to.
</ResponseField>

<ResponseField name="OldCrmBoardColumnId" type="integer">
  CRM stage the opportunity moved from (null for the initial placement).
</ResponseField>

<ResponseField name="OldCrmBoardColumnName" type="string">
  Name of the previous CRM stage.
</ResponseField>

<ResponseField name="FromTime" type="string">
  When the opportunity entered the previous stage.
</ResponseField>

<ResponseField name="ToTime" type="string">
  When the opportunity left the previous stage and entered the new one.
</ResponseField>

<ResponseField name="NewCrmBoardColumnId" type="integer">
  CRM stage the opportunity moved to.
</ResponseField>

<ResponseField name="NewCrmBoardColumnName" type="string">
  Name of the new CRM stage.
</ResponseField>

<ResponseField name="UserId" type="integer">
  Admin user who triggered the stage transition (null if moved automatically).
</ResponseField>

<ResponseField name="UserFullName" type="string">
  Full name of the admin user who triggered the transition.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "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
}
```