> ## Documentation Index > Fetch the complete documentation index at: https://docs.twinbay.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve an evaluator version ## OpenAPI ````yaml https://api.twinbay.ai/openapi.json get /evaluator-versions/{evaluator_version_id} openapi: 3.1.0 info: title: Twinbay description: Backend API version: 0.1.0 servers: - url: https://api.twinbay.ai description: Production security: [] tags: - name: healthchecks description: Healthcheck endpoints - name: users description: >- The current user. Sign-up and sign-in happen in WorkOS AuthKit, which issues the access tokens this API accepts. - name: organizations description: >- Organizations the caller belongs to. Every authenticated request acts inside exactly one organization — the one its access token names — so these routes address it as `current`. - name: api-keys description: >- Long-lived credentials for callers that cannot hold an AuthKit session — agents, SDKs, CI. A key is accepted wherever an access token is, and acts with the role its creator holds when the request arrives. - name: environments description: >- Create and edit isolated provider environments. Each environment contains behavioural twins from the `twins` package. - name: twins description: Manage provisioned twins by their IDs. - name: catalog description: Browse the digital twins available for new environments. - name: scenarios description: Reusable starting setups of provider twins and optional seeds. - name: seeds description: >- Starting states for a twin. Describe the data you want in your own words, and a worker expands it into rows once; pass the seed's id when you create an environment to start a twin holding it. - name: tests description: >- Outcomes described in natural language, compiled once into request matchers, and evaluated deterministically against the traffic an attempt was served. paths: /evaluator-versions/{evaluator_version_id}: get: tags: - tests summary: Retrieve an evaluator version operationId: get_evaluator_version parameters: - name: evaluator_version_id in: path required: true schema: type: string format: uuid title: Evaluator Version Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EvaluatorVersionResponse' '401': description: The credential is missing, malformed, expired, or not trusted '403': description: The credential does not act inside an organization '404': description: Evaluator version not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - Access token: [] - Organization API key: [] components: schemas: EvaluatorVersionResponse: properties: id: type: string format: uuid title: Id test_version_id: type: string format: uuid title: Test Version Id version: type: integer title: Version status: type: string enum: - pending - running - ready - error title: Status twins: items: type: string type: array title: Twins rules: anyOf: - items: $ref: '#/components/schemas/Rule' type: array - type: 'null' title: Rules description: The frozen matchers, once the bundle is ready. error_message: anyOf: - type: string - type: 'null' title: Error Message created_at: type: string format: date-time title: Created At type: object required: - id - test_version_id - version - status - twins - created_at title: EvaluatorVersionResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Rule: properties: outcome_id: type: string format: uuid title: Outcome Id matcher: $ref: '#/components/schemas/Matcher' type: object required: - outcome_id - matcher title: Rule ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError Matcher: properties: twin: type: string maxLength: 100 minLength: 1 title: Twin description: Catalog slug of the twin that served the call. method: type: string enum: - GET - POST - PUT - PATCH - DELETE - HEAD - OPTIONS title: Method path: type: string maxLength: 500 pattern: ^/ title: Path description: >- The provider path without a query string. A `{name}` segment matches any single segment, e.g. `/v1/charges/{id}/refund`. predicates: items: $ref: '#/components/schemas/Predicate' type: array maxItems: 20 title: Predicates additionalProperties: false type: object required: - twin - method - path title: Matcher Predicate: properties: source: type: string enum: - query - request_body - response title: Source field: type: string maxLength: 200 minLength: 1 title: Field description: >- A key of the decoded query, form or JSON body; dots descend into nested objects and arrays (`metadata.order_id`, `items.0.price`). On `response`, `status_code` is the HTTP status and any other field addresses the response body. operator: type: string enum: - eq - ne - gt - gte - lt - lte - in - contains - exists title: Operator value: anyOf: - type: string - type: integer - type: number - type: boolean - items: anyOf: - type: string - type: integer - type: number - type: boolean - type: 'null' type: array - type: 'null' title: Value description: >- A list for `in`, a number for `gt`/`gte`/`lt`/`lte`, a boolean for `exists`. additionalProperties: false type: object required: - source - field - operator - value title: Predicate description: One condition on a captured call. Data, never code or SQL. securitySchemes: Access token: type: http description: Access token issued by WorkOS AuthKit. scheme: bearer Organization API key: type: apiKey description: >- An organization API key. Create one at https://console.twinbay.ai/api-keys in: header name: X-API-Key ````