> ## 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.

# Get Simulation Snapshot

> Returns a Snapshot.



## OpenAPI

````yaml /openapi/simulation.yaml get /v1/simulation-snapshots/{id}
openapi: 3.1.0
info:
  description: >-
    Build Simulators from OpenAPI, WSDL or GraphQL 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, WSDL or GraphQL documents, check or cancel
      a build, clone Simulators into other workspaces, and rename and delete
      Simulators.
    name: simulators
    x-group: Simulators
  - description: >-
      Create Simulations from ready Simulators or Snapshots, then rename, stop,
      start, and delete them.
    name: simulations
    x-group: Simulations
  - description: >-
      Save a running Simulation's state as a Snapshot, create Simulations from
      it, and rename and delete it.
    name: simulation-snapshots
    x-group: Simulation Snapshots
  - description: >-
      Build Worlds from one or more Simulators, rename them, and start or stop
      their Simulations together.
    name: worlds
    x-group: Worlds
  - description: >-
      Store connections to real systems: a base URL, the header that carries the
      credential, and its value. The API never returns a value.
    name: credentials
    x-group: Credentials
paths:
  /v1/simulation-snapshots/{id}:
    get:
      tags:
        - simulation-snapshots
      summary: Get Simulation Snapshot
      description: Returns a Snapshot.
      operationId: get-simulation-snapshot
      parameters:
        - description: Snapshot ID.
          in: path
          name: id
          required: true
          schema:
            pattern: ^sns_[0-9A-HJKMNP-TV-Z]{26}$
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimulationSnapshot'
          description: OK
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          content:
            application/problem+json:
              examples:
                snapshot_not_found:
                  $ref: '#/components/examples/snapshot_not_found'
              schema:
                $ref: '#/components/schemas/Error'
          description: Not Found
        '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:
    SimulationSnapshot:
      additionalProperties: false
      examples:
        - at_step: 42
          created_at: '2026-01-15T12:00:00Z'
          current_time: '2024-01-03T00:00:00Z'
          id: sns_01J8Z5X4K7M2N9P0Q1R2S3T4VC
          name: before-refund
          simulation_id: sim_01J8Z5X4K7M2N9P0Q1R2S3T4V8
          simulator_id: smr_01J8Z5X4K7M2N9P0Q1R2S3T4V5
          start_time: '2024-01-01T00:00:00Z'
      properties:
        at_step:
          description: >-
            Completed step the Snapshot saved, or null for the state that was
            latest when it was saved.
          format: int64
          type:
            - integer
            - 'null'
        created_at:
          description: Snapshot creation time.
          format: date-time
          type: string
        current_time:
          description: >-
            Simulated time of the saved state, where a Simulation created from
            the Snapshot starts.
          format: date-time
          type: string
        id:
          description: Snapshot ID.
          pattern: ^sns_[0-9A-HJKMNP-TV-Z]{26}$
          type: string
        name:
          description: Snapshot name. The ID is its identity, and names need not be unique.
          maxLength: 128
          type: string
        simulation_id:
          description: >-
            ID of the Simulation the Snapshot saved, or null once that
            Simulation is deleted.
          pattern: ^sim_[0-9A-HJKMNP-TV-Z]{26}$
          type:
            - string
            - 'null'
        simulator_id:
          description: >-
            ID of the Simulator a Simulation created from the Snapshot runs, at
            the digest its source pinned.
          pattern: ^smr_[0-9A-HJKMNP-TV-Z]{26}$
          type: string
        start_time:
          description: Initial simulated time of a Simulation created from the Snapshot.
          format: date-time
          type: string
      required:
        - id
        - name
        - simulation_id
        - simulator_id
        - at_step
        - start_time
        - current_time
        - created_at
      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
    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
  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
  examples:
    snapshot_not_found:
      value:
        code: snapshot_not_found
        detail: No Snapshot was found with ID "sns_01J8Z5X4K7M2N9P0Q1R2S3T4VC".
        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
  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

````

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