# GET /v1/history/{entity_ref}/revisions/{revision} - The entity at one revision
Source:
GET
/v1/history/{entity\_ref}/revisions/{revision}
Select code samplecURL (shell:curl)
```js
const url = 'https://app.everruns.com/api/v1/history/example/revisions/1';
const options = {method: 'GET'};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
```
```sh
curl --request GET \
--url https://app.everruns.com/api/v1/history/example/revisions/1
```
* Production APIapp.everruns.com/api/v1/history/{entity\_ref}/revisions/{revision}
## Parameters
### Path Parameters
**entity\_ref**
required
string
The entity’s public id
**revision**
required
integer format: int64
Revision number
### Query Parameters
**kind**
string
Entity kind, needed only for kinds whose ids have no prefix.
## Responses
### 200
The entity as it stood after that change
Media typeapplication/json
One revision of an entity: the entry that made it and the entity as it stood after it.
object
**change**
required
One recorded change to an entity.
object
**action**
required
What happened: `created`, `updated`, `deleted`, …
string
**actor\_kind**
required
`user`, `api_key`, `agent_session` or `system`.
string
**actor\_user\_id**
The user the change was made as (for an agent, the user it acted for).
string | null format: uuid
**changed\_fields**
required
Fields the caller asked to change.
Array\
**command**
required
Wire name of the command that made the change.
string
**created\_at**
required
string format: date-time
**entity\_kind**
required
Kind of entity changed, e.g. `agent`.
string
**entity\_ref**
required
The entity’s public id.
string
**id**
required
Id of this history entry.
string format: uuid
**reason**
Why, in the caller’s words. Caller text, not verified.
string | null
**request\_id**
Correlation id of the HTTP request, when there was one.
string | null
**restored\_from\_revision**
For a restore, the revision it brought back.
integer | null format: int64
**revision**
The entity’s revision after this change; absent when the change left the entity as it was, or its kind keeps no snapshots.
integer | null format: int64
**surface**
required
Where the change came in: `api`, `commands`, `mcp`, `platform`, `worker` or `internal`.
string
**via\_agent\_id**
The agent of that session.
string | null
**via\_session\_id**
The session through which an agent made the change.
string | null
**revision**
required
integer format: int64
**snapshot**
The entity after the change, secrets as markers under `$secrets`. `null` once the revision is older than the snapshots kept.
##### Example
```json
{
"change": {
"action": "updated",
"actor_kind": "agent_session",
"command": "update_agent",
"entity_kind": "agent",
"entity_ref": "agent_01933b5a000070008000000000000001",
"surface": "platform"
}
}
```
### 404
No such revision
Media typeapplication/json
Standard error response.
Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.
object
**allowed\_actions**
Recovery actions the caller can take next.
Array\