> ## Documentation Index > Fetch the complete documentation index at: https://docs.softmax.com/llms.txt > Use this file to discover all available pages before exploring further. # List Round Episodes > Present a round's episodes without exposing its execution model to clients. ## OpenAPI ````yaml https://softmax.com/api/observatory/openapi.json get /v2/rounds/{round_id}/episodes openapi: 3.1.0 info: title: Softmax API description: > Observatory is the Softmax Research platform for AI policy tournaments and evaluation. Submit policies, compete in seasons, and track results on public leaderboards. --- ## Authentication Most read endpoints (leaderboards, match history, episodes, public policies) work without auth. Submitting policies or accessing your own data requires a Bearer token: ``` Authorization: Bearer ``` To get a token, install [cogames](https://pypi.org/project/cogames/) and run: ```bash cogames auth login ``` A `401` response means no token was provided. A `403` means the token is invalid or expired. ### Verify your token ```bash curl -H "Authorization: Bearer " \ https://softmax.com/api/observatory/whoami ``` Returns `{"user_email": "you@example.com"}` on success. version: 1.0.0 servers: - url: https://softmax.com/api/observatory security: [] paths: /v2/rounds/{round_id}/episodes: get: tags: - v2 - v2 summary: List Round Episodes description: >- Present a round's episodes without exposing its execution model to clients. operationId: list_round_episodes_v2_rounds__round_id__episodes_get parameters: - name: round_id in: path required: true schema: type: string pattern: >- ^round_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ title: Round Id - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 default: 50 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset - name: completed_only in: query required: false schema: type: boolean default: false title: Completed Only responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/RoundEpisodePage' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] - {} components: schemas: RoundEpisodePage: properties: entries: items: $ref: '#/components/schemas/V2RoundEpisodeRow' type: array title: Entries total_count: type: integer title: Total Count limit: type: integer title: Limit offset: type: integer title: Offset type: object required: - entries - total_count - limit - offset title: RoundEpisodePage HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError V2RoundEpisodeRow: properties: id: type: string title: Id inspect_url: type: string title: Inspect Url episode_id: anyOf: - type: string format: uuid - type: 'null' title: Episode Id coworld_id: anyOf: - type: string - type: 'null' title: Coworld Id coworld_name: anyOf: - type: string - type: 'null' title: Coworld Name coworld_version: anyOf: - type: string - type: 'null' title: Coworld Version variant_name: anyOf: - type: string - type: 'null' title: Variant Name job_index: anyOf: - type: integer - type: 'null' title: Job Index status: $ref: '#/components/schemas/EpisodeRequestStatus' policy_version_ids: items: type: string format: uuid type: array title: Policy Version Ids participants: items: oneOf: - $ref: '#/components/schemas/V2EpisodeRequestPolicyParticipant' - $ref: '#/components/schemas/V2EpisodeRequestHumanParticipant' discriminator: propertyName: kind mapping: human: $ref: '#/components/schemas/V2EpisodeRequestHumanParticipant' policy: $ref: '#/components/schemas/V2EpisodeRequestPolicyParticipant' type: array title: Participants replay_url: anyOf: - type: string - type: 'null' title: Replay Url live_url: anyOf: - type: string - type: 'null' title: Live Url error_type: anyOf: - type: string - type: 'null' title: Error Type error: anyOf: - type: string - type: 'null' title: Error failed_policy_index: anyOf: - type: integer - type: 'null' title: Failed Policy Index failed_agent_index: anyOf: - type: integer - type: 'null' title: Failed Agent Index scores: items: $ref: '#/components/schemas/EpisodeRequestScore' type: array title: Scores participant_scores: items: $ref: '#/components/schemas/CoworldEpisodeParticipantScore' type: array title: Participant Scores created_at: type: string format: date-time title: Created At dispatched_at: anyOf: - type: string format: date-time - type: 'null' title: Dispatched At running_at: anyOf: - type: string format: date-time - type: 'null' title: Running At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At type: object required: - id - inspect_url - status - policy_version_ids - participants - scores - created_at title: V2RoundEpisodeRow description: >- One round episode presentation, independent of how its evidence was produced. This row is served anonymously (see `list_round_episodes` in routes/rounds.py, which uses OPTIONAL auth). `job_index`, `participant_scores`, `dispatched_at`, and `running_at` are per-episode execution facts already exposed to every signed-in submitter via the episode-requests list (`V2EpisodeRequestListRow`); they carry no requester identity, game config, or infrastructure detail, so they are safe here. 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 EpisodeRequestStatus: type: string enum: - pending - submitted - running - completed - failed - cancelled title: EpisodeRequestStatus V2EpisodeRequestPolicyParticipant: properties: position: type: integer title: Position kind: type: string const: policy title: Kind default: policy policy_version_id: type: string format: uuid title: Policy Version Id policy_id: type: string format: uuid title: Policy Id policy_name: type: string title: Policy Name version: type: integer title: Version player_id: anyOf: - type: string - type: 'null' title: Player Id player_name: anyOf: - type: string - type: 'null' title: Player Name is_filler: type: boolean title: Is Filler default: false is_seed: type: boolean title: Is Seed default: false type: object required: - position - policy_version_id - policy_id - policy_name - version title: V2EpisodeRequestPolicyParticipant V2EpisodeRequestHumanParticipant: properties: position: type: integer title: Position kind: type: string const: human title: Kind default: human user_id: type: string title: User Id name: type: string title: Name type: object required: - position - user_id - name title: V2EpisodeRequestHumanParticipant EpisodeRequestScore: properties: policy_version_id: type: string format: uuid title: Policy Version Id score: type: number title: Score type: object required: - policy_version_id - score title: EpisodeRequestScore CoworldEpisodeParticipantScore: properties: position: type: integer minimum: 0 title: Position score: type: number title: Score additionalProperties: false type: object required: - position - score title: CoworldEpisodeParticipantScore securitySchemes: BearerAuth: type: http scheme: bearer description: Bearer token issued by Softmax ````