> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-caio-sd-2792-selection-active-ids.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# trackChanges.get

> Retrieve a single tracked change by ID.

## Summary

Retrieve a single tracked change by ID.

* Operation ID: `trackChanges.get`
* API member path: `editor.doc.trackChanges.get(...)`
* Mutates document: `no`
* Idempotency: `idempotent`
* Supports tracked mode: `no`
* Supports dry run: `no`
* Deterministic target resolution: `yes`

## Expected result

Returns a TrackChangeInfo object with the change type, author, date, affected content, and raw imported Word OOXML revision IDs (`w:id`) when available.

## Input fields

| Field   | Type         | Required | Description  |
| ------- | ------------ | -------- | ------------ |
| `id`    | string       | yes      |              |
| `story` | StoryLocator | no       | StoryLocator |

### Example request

```json theme={null}
{
  "id": "id-001",
  "story": {
    "kind": "story",
    "storyType": "body"
  }
}
```

## Output fields

| Field                    | Type                 | Required | Description                        |
| ------------------------ | -------------------- | -------- | ---------------------------------- |
| `address`                | TrackedChangeAddress | yes      | TrackedChangeAddress               |
| `address.entityId`       | string               | yes      |                                    |
| `address.entityType`     | `"trackedChange"`    | yes      | Constant: `"trackedChange"`        |
| `address.kind`           | `"entity"`           | yes      | Constant: `"entity"`               |
| `address.story`          | StoryLocator         | no       | StoryLocator                       |
| `author`                 | string               | no       |                                    |
| `authorEmail`            | string               | no       |                                    |
| `authorImage`            | string               | no       |                                    |
| `date`                   | string               | no       |                                    |
| `excerpt`                | string               | no       |                                    |
| `id`                     | string               | yes      |                                    |
| `type`                   | enum                 | yes      | `"insert"`, `"delete"`, `"format"` |
| `wordRevisionIds`        | object               | no       |                                    |
| `wordRevisionIds.delete` | string               | no       |                                    |
| `wordRevisionIds.format` | string               | no       |                                    |
| `wordRevisionIds.insert` | string               | no       |                                    |

### Example response

```json theme={null}
{
  "address": {
    "entityId": "entity-789",
    "entityType": "trackedChange",
    "kind": "entity",
    "story": {
      "kind": "story",
      "storyType": "body"
    }
  },
  "author": "Jane Doe",
  "id": "id-001",
  "type": "insert",
  "wordRevisionIds": {
    "delete": "example",
    "insert": "example"
  }
}
```

## Pre-apply throws

* `TARGET_NOT_FOUND`

## Non-applied failure codes

* None

## Raw schemas

<Accordion title="Raw input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "id": {
        "type": "string"
      },
      "story": {
        "$ref": "#/$defs/StoryLocator"
      }
    },
    "required": [
      "id"
    ],
    "type": "object"
  }
  ```
</Accordion>

<Accordion title="Raw output schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "address": {
        "$ref": "#/$defs/TrackedChangeAddress"
      },
      "author": {
        "type": "string"
      },
      "authorEmail": {
        "type": "string"
      },
      "authorImage": {
        "type": "string"
      },
      "date": {
        "type": "string"
      },
      "excerpt": {
        "type": "string"
      },
      "id": {
        "type": "string"
      },
      "type": {
        "enum": [
          "insert",
          "delete",
          "format"
        ]
      },
      "wordRevisionIds": {
        "additionalProperties": false,
        "description": "Raw imported Word OOXML revision IDs (`w:id`) from the source document when available. This is provenance metadata, not the canonical SuperDoc tracked-change ID. Replacements may include both `insert` and `delete` IDs.",
        "properties": {
          "delete": {
            "description": "Raw imported Word OOXML revision ID (`w:id`) from a `<w:del>` element when this logical change includes a deletion.",
            "type": "string"
          },
          "format": {
            "description": "Raw imported Word OOXML revision ID (`w:id`) from a `<w:rPrChange>` element when this logical change includes a formatting revision.",
            "type": "string"
          },
          "insert": {
            "description": "Raw imported Word OOXML revision ID (`w:id`) from a `<w:ins>` element when this logical change includes an insertion.",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "required": [
      "address",
      "id",
      "type"
    ],
    "type": "object"
  }
  ```
</Accordion>
