> ## 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. # Get Division Versus Me > Each division player's episode record against the caller's current champion. Scoped to the division's most recent `rounds` completed rounds, restricted to episodes where the caller's champion policy sat in a non-filler seat (the same round -> episode_requests -> seats fan-out as the pairing matrix). Per shared episode, an opponent's mean reward is compared to the champion's; each entry's `wins` counts episodes that OPPONENT won, so its `win_rate` reads as "how often they beat you". Empty when the caller has no current champion in the division. Viewer-specific by construction, so commissioner tokens (which own no players) are not accepted. ## OpenAPI ````yaml https://softmax.com/api/observatory/openapi.json get /v2/divisions/{division_id}/versus-me 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/divisions/{division_id}/versus-me: get: tags: - v2 - v2 summary: Get Division Versus Me description: >- Each division player's episode record against the caller's current champion. Scoped to the division's most recent `rounds` completed rounds, restricted to episodes where the caller's champion policy sat in a non-filler seat (the same round -> episode_requests -> seats fan-out as the pairing matrix). Per shared episode, an opponent's mean reward is compared to the champion's; each entry's `wins` counts episodes that OPPONENT won, so its `win_rate` reads as "how often they beat you". Empty when the caller has no current champion in the division. Viewer-specific by construction, so commissioner tokens (which own no players) are not accepted. operationId: get_division_versus_me_v2_divisions__division_id__versus_me_get parameters: - name: division_id in: path required: true schema: type: string pattern: ^div_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ title: Division Id - name: rounds in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 50 title: Rounds - name: player_id in: query required: false schema: anyOf: - type: string pattern: >- ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ - type: 'null' description: >- Compute against this owned player's champion (e.g. the UI's selected player). Ignored players you don't own yield an empty result. Defaults to the caller's most recently placed champion in the division. title: Player Id description: >- Compute against this owned player's champion (e.g. the UI's selected player). Ignored players you don't own yield an empty result. Defaults to the caller's most recently placed champion in the division. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/DivisionVersusMePublic' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: DivisionVersusMePublic: properties: my_player_id: anyOf: - type: string - type: 'null' title: My Player Id my_policy_version_id: anyOf: - type: string format: uuid - type: 'null' title: My Policy Version Id my_policy_label: anyOf: - type: string - type: 'null' title: My Policy Label entries: items: $ref: '#/components/schemas/VersusMeEntryPublic' type: array title: Entries type: object required: - entries title: DivisionVersusMePublic description: >- Per-player head-to-head records against the viewing user's current champion. Computed over the division's recent rounds, restricted to episodes where the viewer's champion policy sat in a non-filler seat. `my_player_id` / `my_policy_version_id` are None (with empty `entries`) when the viewer has no current champion in this division. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError VersusMeEntryPublic: properties: player_id: type: string title: Player Id player_name: anyOf: - type: string - type: 'null' title: Player Name wins: type: integer title: Wins losses: type: integer title: Losses ties: type: integer title: Ties episodes: type: integer title: Episodes win_rate: type: number title: Win Rate type: object required: - player_id - wins - losses - ties - episodes - win_rate title: VersusMeEntryPublic description: >- One division player's episode record against the viewer's current champion. `wins` counts episodes where THIS player outscored the viewer's champion, so `win_rate` reads as "how often they beat you" ((wins + ties/2) / episodes). 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 securitySchemes: BearerAuth: type: http scheme: bearer description: Bearer token issued by Softmax ````