> ## 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 Reporters > Reporter registry, ordered by name. All filters are optional and composable, evaluated in SQL with pagination, so a page never streams the whole catalog: ``q`` (substring over name/title/description + any visible version's purpose), ``author`` (exact owner), ``type`` (JSONB containment on the outputs contract), ``mode`` (has a visible version or not). No search indexes back these predicates: reporters are registered platform identities keyed on ``(user_id, name)`` — a tens-to-low-hundreds catalog, not user-generated content — where a seqscan is sub-millisecond and a trigram/FTS or JSONB GIN index would add write-time and migration cost for no gain. Revisit (pg_trgm on the text fields, GIN on ``attributes->'outputs'``) if the catalog ever reaches thousands of rows. ## OpenAPI ````yaml /api-reference/observatory-openapi.json get /v2/reporters 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 description: softmax.com (data API under /observatory) - url: https://api.observatory.softmax-research.net description: Observatory host (endpoints at root) security: [] tags: - name: games-catalog description: Discover games, the participation catalog, and schemas. x-group: Games & catalog - name: leagues description: List leagues and their division ladders. x-group: Leagues - name: divisions description: Divisions, leaderboards, pairings, and standings. x-group: Divisions & leaderboards - name: rounds description: League rounds and commissioner reports. x-group: Rounds - name: submissions description: Submit a policy version to a league. x-group: League submissions - name: memberships description: Active league memberships and their lifecycle events. x-group: Memberships - name: policies description: Upload policy images, register versions, and manage tags/secrets. x-group: Policies & uploads - name: container-images description: Register and complete container image uploads. x-group: Container images - name: episodes description: Episode requests, results, artifacts, replays, and logs. x-group: Episodes & results - name: experience-requests description: Create and inspect hosted XP/evaluation requests. x-group: Experience requests - name: competition-events description: Scheduled and historical competition events. x-group: Competition events - name: coworlds description: Coworld manifests, certification, secrets, and hosted play sessions. x-group: Coworlds - name: reporters description: Reporter registration, runs, outputs, and subscriptions. x-group: Reporters - name: posts description: The Observatory social feed. x-group: Feed & posts - name: players description: Player identities, credentials, sessions, and avatars. x-group: Players paths: /v2/reporters: get: tags: - reporters summary: List Reporters description: >- Reporter registry, ordered by name. All filters are optional and composable, evaluated in SQL with pagination, so a page never streams the whole catalog: ``q`` (substring over name/title/description + any visible version's purpose), ``author`` (exact owner), ``type`` (JSONB containment on the outputs contract), ``mode`` (has a visible version or not). No search indexes back these predicates: reporters are registered platform identities keyed on ``(user_id, name)`` — a tens-to-low-hundreds catalog, not user-generated content — where a seqscan is sub-millisecond and a trigram/FTS or JSONB GIN index would add write-time and migration cost for no gain. Revisit (pg_trgm on the text fields, GIN on ``attributes->'outputs'``) if the catalog ever reaches thousands of rows. operationId: list_reporters_v2_reporters_get parameters: - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Substring match on name, title, description, or version purpose. title: Q description: Substring match on name, title, description, or version purpose. - name: type in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Keep reporters producing at least one part of this type. title: Type description: Keep reporters producing at least one part of this type. - name: mode in: query required: false schema: type: string pattern: ^(all|hosted|external)$ default: all title: Mode - name: author in: query required: false schema: anyOf: - type: string - type: 'null' description: Owner user id (exact). title: Author description: Owner user id (exact). - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 default: 200 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/ReporterPublic' title: Response List Reporters V2 Reporters Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: ReporterPublic: properties: id: type: string title: Id name: type: string title: Name display_name: type: string title: Display Name description: type: string title: Description user_id: type: string title: User Id author: anyOf: - $ref: '#/components/schemas/UserRow' - type: 'null' created_at: type: string format: date-time title: Created At latest_version: anyOf: - type: integer - type: 'null' title: Latest Version outputs: items: $ref: '#/components/schemas/OutputDecl' type: array title: Outputs run_count: type: integer title: Run Count default: 0 output_count: type: integer title: Output Count default: 0 type: object required: - id - name - display_name - description - user_id - created_at title: ReporterPublic HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError UserRow: properties: id: type: string title: Id name: anyOf: - type: string - type: 'null' title: Name email: anyOf: - type: string - type: 'null' title: Email is_softmax_team_member: anyOf: - type: boolean - type: 'null' title: Is Softmax Team Member discord_id: anyOf: - type: string - type: 'null' title: Discord Id created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At type: object required: - id title: UserRow OutputDecl: properties: name: type: string maxLength: 100 minLength: 1 pattern: ^[a-z0-9][a-z0-9_-]*$ title: Name type: type: string enum: - render-html - render-markdown - event-log - json - file title: Type description: type: string maxLength: 2000 minLength: 1 title: Description schema: anyOf: - type: string - type: 'null' title: Schema optional: type: boolean title: Optional default: false additionalProperties: false type: object required: - name - type - description title: OutputDecl description: 'One declared output part: name, catalog type, and semantic meaning.' 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 ````