---
title: "GET /api/companies/{id}/history"
method: GET
path: "/api/companies/{id}/history"
tags: ["Companies"]
---

# GET /api/companies/{id}/history

`GET /api/companies/{id}/history`

The change history of company `:id`'s profile as this caller sees it — who changed which data points, and when — newest first. Covers the caller's own edits of its view of the company, plus the company's own changes to GLOBAL data points, which reach every company connected to it. Keyset-paginated: pass the returned `nextCursor` back as `cursor`. Edits other companies made to their own private views are never visible, and a caller with no connection to the company gets an empty page.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string, uuid
- `limit` integer
- `templateId` string

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `items` object[], required
      - `id` string, required
      - `entityType` string, required
      - `entityId` string, required
      - `entitySubType` string, nullable, required
      - `eventType` string, required
      - `source` string, required
      - `correlationId` string, nullable, required
      - `forCompanyId` string, required
      - `byCompanyId` string, required
      - `onBehalfOfCompanyId` string, required
      - `changes` object[], nullable, required
        - `field` string, required
        - `from` unknown, required
        - `to` unknown, required
      - `metadata` object, required
        - `entityType` 'COMPANY_PROFILE', required
        - `templateId` string, nullable, required
        - `source` object
          - `from` string
          - `id` string
          - `requestId` string
          - `forCompanyId` string
        - `connectionType` string
        - `assetId` string
        - `assetLabel` string, nullable
      - `createdAt` string, date-time, required
      - `createdBy` object, required
        - `userId` string, nullable, required
        - `userName` string, nullable, required
        - `companyId` string, nullable, required
        - `companyName` string, nullable, required
        - `impersonateId` string, nullable, required
        - `impersonateName` string, nullable, required
        - `apiKeyId` string, nullable, required
        - `apiKeyLabel` string, nullable, required
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401` — Default Response
- `403` — Default Response

## Changes

> 38 revisions in range; 1 not diffed.

- **2026-09-12** `329f5bd4d114` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/companies/:id/history/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/retraced/apis/api-reference/revisions/5605195a7af2?raw)