---
title: "Read the full world and event history"
method: GET
path: "/api/control/snapshot"
tags: ["Operator"]
---

# Read the full world and event history

`GET /api/control/snapshot`

## Request

- Base URL: `https://sim.animahealth.com`
- URL: `https://sim.animahealth.com/api/control/snapshot`
- Auth: HTTP bearer

May be large for a published population. Prefer paged site views for participant applications.

## Query parameters

- `world` string

## Response `200`

Success

- object
  - `world` object, required
  - `events` Event[], required
    - `id` string, required
    - `time` number, required: Simulation Unix timestamp in milliseconds.
    - `type` string, required
    - `actor` string, required
    - `resourceId` string
    - `patientId` string
    - `detail` string, required
    - `visibleTo` string[], required

## Other responses

- `400`: Invalid input or unsupported workflow
- `401`: Missing or invalid credentials
- `403`: Scope, origin or operator restriction
- `404`: Unknown resource
- `409`: Stale version, invalid transition or unavailable capacity
- `413`: Request exceeds this operation's body-size limit
- `429`: Deployment has reached its 5,000-team capacity
- `500`: Internal simulation error

---

[API](https://skmtc.dev/animahealth/apis/nhs-sim-api.md) - [All operations](https://skmtc.dev/animahealth/apis/nhs-sim-api/llms.txt) - [OpenAPI document](https://skmtc.dev/animahealth/apis/nhs-sim-api/revisions/c7803d7a3e58?raw)