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

# List revision entries

> Returns the history of fields you can read, newest first.

A field's history is its entries for one resource:
`GET /v1/revision-entries?subject=wr_xyz789&attribute=number`. Entries for
resources or fields you can't read are left out.

### Parameters

**subject** `string`

Only entries for this resource, such as a worker ID.

**attribute** `string`

Only entries for this field, by its key (`number`) or its Attribute ID
(`attr_…`).

**revision** `string`

Only entries of this revision.

**expand\[]** `string`

`revision` returns each entry's revision object instead of its ID.

**limit** `number`

The number of entries to return. Defaults to 10; a value above 100 is
treated as 100.

**cursor** `string`

The `next_cursor` from the previous page. It carries this request's filters,
so send it alone, or with a new `limit`. See [pagination](https://docs.plane.com/reference/pagination.md).

### Returns

`data`, an array of [revision entries](https://docs.plane.com/reference/revision-entries/object.md),
and `next_cursor`: pass it as `cursor` for the next page; it is null at the end.

```json Response theme={null}
{
  "data": [
    {
      "id": "rve_3Kd9P",
      "object": "revision_entry",
      "revision": {
        "id": "rv_8Hd2K",
        "object": "revision",
        "workspace": "wsp_456def",
        "status": "applied",
        "cancelled_reason": null,
        "reason": "Renumbered after the merger",
        "actor": "mem_3Jq8T",
        "via": "api",
        "created": "2026-11-07T12:00:00Z",
        "applied": "2026-11-07T12:00:00Z",
        "cancelled": null
      },
      "workspace": "wsp_456def",
      "subject": "wr_xyz789",
      "attribute": "number",
      "before": "E-1041",
      "after": "E-1042",
      "applied": "2026-11-07T12:00:00Z"
    }
  ],
  "next_cursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.