Prophecies

Prophecy records store results from simulation stepping or runs. Their payload contains the completed tick count and the final engine tick result.

Prophecies are read-only. The runner creates them. The caller can not submit them.

Authentication is required. Scope checks apply to API keys only. API keys access their own organization’s simulations. JWT callers need organization membership or ownership of a personal simulation. This endpoint can return 401, 403, 404, 429, or 500. See HTTP Status Codes. Replace <api-key> and <simulation-id> in the example with your key and simulation UUID.

List Prophecies

GET /v1/simulations/{id}/prophecies

Returns a paginated list of prophecy records stored for a simulation.

Scope required (API key): simulation:read

Path Parameters

Parameter	Type	Description
id	uuid	Simulation ID

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Results per page, clamped to 1 to 200
offset	integer	0	Pagination offset, clamped to 0 or greater
order	string	"asc"	Creation-time order: "asc" or "desc"

limit and offset use integer parsing. Zero or an unparseable limit uses 50. An unparseable offset uses 0. Only order=desc selects descending order. All other values select ascending order.

Response

The example omits the final tick result fields rather than showing an empty result.

{
  "data": [
    {
      "id": "b1b2c3d4-1111-4111-8111-111111111111",
      "simulationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "data": {
        "ticks": 100,
        "result": { /* Final engine tick result omitted */ }
      },
      "createdAt": "2025-06-15T10:36:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 1
  }
}

Response Fields

Field	Type	Description
id	uuid	Prophecy identifier
simulationId	uuid	Parent simulation
data	object	Prophecy payload (structure varies by engine version)
createdAt	string	ISO 8601 timestamp
data.ticks	number	Completed ticks in the step or run request
data.result	object	Final engine tick result

Example

curl "https://api.anankelabs.io/v1/simulations/<simulation-id>/prophecies?limit=10" \
  -H "X-Api-Key: <api-key>"