> ## Documentation Index > Fetch the complete documentation index at: https://docs.continuouslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Clock Advance Events > Returns the ordered event trace for a committed advance. The Simulation must be running or paused. Forks retain traces in their inherited state. ## OpenAPI ````yaml /openapi/simulation.yaml get /v1/simulations/{id}/advances/{advance_id}/events openapi: 3.1.0 info: description: >- Build Simulators from OpenAPI or WSDL documents, create Simulations from them, and build Worlds that run Simulations together. Authenticate every request with an API key sent as a Bearer token. title: Continuous Simulation API version: v1 servers: - description: Continuous production API. url: https://api.continuouslabs.ai security: [] tags: - description: >- Build Simulators from OpenAPI or WSDL documents, check or cancel a build, and delete Simulators. name: simulators x-group: Simulators - description: >- Create Simulations from ready Simulators, then fork, stop, start, and delete them. name: simulations x-group: Simulations - description: >- Build Worlds from one or more Simulators and start or stop their Simulations together. name: worlds x-group: Worlds paths: /v1/simulations/{id}/advances/{advance_id}/events: get: tags: - simulations summary: List Clock Advance Events description: >- Returns the ordered event trace for a committed advance. The Simulation must be running or paused. Forks retain traces in their inherited state. operationId: list-simulation-advance-events parameters: - description: Simulation ID. in: path name: id required: true schema: pattern: ^sim_[0-9A-HJKMNP-TV-Z]{26}$ type: string - description: Advance ID. A historical fork can read inherited runtime receipts. in: path name: advance_id required: true schema: pattern: ^adv_[0-9A-HJKMNP-TV-Z]{26}$ type: string - description: Page size. Values below 1 use 50. Values above 200 use 200. explode: false in: query name: limit schema: default: 50 format: int64 type: integer - description: Opaque next_cursor value from a previous page. explode: false in: query name: cursor schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListClockAdvanceEventsResponse' description: OK '400': content: application/problem+json: examples: bad_request: $ref: '#/components/examples/bad_request' schema: $ref: '#/components/schemas/Error' description: Bad Request '401': $ref: '#/components/responses/Unauthorized' '403': content: application/problem+json: examples: auth_forbidden_simulation: $ref: '#/components/examples/auth_forbidden_simulation' schema: $ref: '#/components/schemas/Error' description: Forbidden '404': content: application/problem+json: examples: clock_advance_not_found: $ref: '#/components/examples/clock_advance_not_found' simulation_not_found: $ref: '#/components/examples/simulation_not_found' schema: $ref: '#/components/schemas/Error' description: Not Found '409': content: application/problem+json: examples: simulation_stopped: $ref: '#/components/examples/simulation_stopped' schema: $ref: '#/components/schemas/Error' description: Conflict '422': content: application/problem+json: examples: validation_list_limit: $ref: '#/components/examples/validation_list_limit' schema: $ref: '#/components/schemas/Error' description: Unprocessable Entity '500': $ref: '#/components/responses/InternalServerError' '503': content: application/problem+json: examples: auth_provider_unavailable: $ref: '#/components/examples/auth_provider_unavailable' internal_unavailable: $ref: '#/components/examples/internal_unavailable' schema: $ref: '#/components/schemas/Error' description: Service Unavailable security: - apiKeyAuth: [] components: schemas: ListClockAdvanceEventsResponse: additionalProperties: false properties: events: description: Committed events in execution order. items: $ref: '#/components/schemas/ClockEvent' type: array next_cursor: description: Cursor for the next page, or null. type: - string - 'null' required: - events - next_cursor type: object Error: additionalProperties: false properties: code: description: Stable machine-readable error code. minLength: 1 type: string detail: description: Safe human-readable error detail. minLength: 1 type: string validation: $ref: '#/components/schemas/SpecificationValidation' description: >- Safe specification diagnostics for a rejected build request, when available. required: - validation - code - detail type: object ClockEvent: additionalProperties: false properties: at: description: Simulated time observed by this event handler. format: date-time type: string event_id: description: Scheduled event ID. type: string sequence: description: Persisted insertion order for events due at the same time. format: int64 type: integer type: description: Declared event type. type: string required: - event_id - type - at - sequence type: object SpecificationValidation: additionalProperties: false properties: issues: description: Specification validation problems. At most 20 are returned. items: $ref: '#/components/schemas/SpecificationIssue' maxItems: 20 type: array required: - issues type: - object - 'null' SpecificationIssue: additionalProperties: false properties: code: description: Stable validation rule code. type: string kind: description: >- Whether the input is invalid, unsupported, incomplete, or has no specific diagnosis. enum: - invalid - unsupported - incomplete - unknown type: string location: description: Readable endpoint or field affected by this issue. maxLength: 512 type: string message: description: What needs attention at this location. type: string operation: description: >- Affected operation ID or method and path, when available. Empty for document-level issues. maxLength: 243 type: string suggestion: description: How to correct or address the problem. type: string required: - code - operation - location - kind - message - suggestion type: object examples: bad_request: value: code: bad_request detail: The cursor is invalid. validation: null auth_forbidden_simulation: value: code: auth_forbidden detail: >- The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" belongs to another workspace. validation: null clock_advance_not_found: value: code: clock_advance_not_found detail: The clock advance was not found. validation: null simulation_not_found: value: code: simulation_not_found detail: No Simulation was found with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6". validation: null simulation_stopped: value: code: simulation_stopped detail: >- The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" is stopped. Start it before you retry this request. validation: null validation_list_limit: value: code: validation detail: 'validation failed: invalid integer at query.limit' validation: null auth_provider_unavailable: value: code: auth_provider_unavailable detail: >- The authentication provider is unavailable. Retry the request after a short delay. validation: null internal_unavailable: value: code: internal_unavailable detail: >- The service is temporarily unavailable. Retry the request after a short delay. validation: null auth_invalid: value: code: auth_invalid detail: The authentication credential is invalid. validation: null auth_missing: value: code: auth_invalid detail: Authentication credentials are required. validation: null internal: value: code: internal detail: The server encountered an unexpected error. validation: null responses: Unauthorized: content: application/problem+json: examples: auth_invalid: $ref: '#/components/examples/auth_invalid' auth_missing: $ref: '#/components/examples/auth_missing' schema: $ref: '#/components/schemas/Error' description: Unauthorized InternalServerError: content: application/problem+json: examples: internal: $ref: '#/components/examples/internal' schema: $ref: '#/components/schemas/Error' description: Internal Server Error securitySchemes: apiKeyAuth: bearerFormat: Continuous API key description: >- Use a Continuous API key. Send it in the Authorization header as a Bearer token. scheme: bearer type: http ````