> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcprize.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve game metadata

> Retrieves metadata for one game. You may pass either the complete
versioned game ID or its stable ID prefix.




## OpenAPI

````yaml /arc3v1.yaml get /api/games/{game_id}
openapi: 3.0.3
info:
  title: ARC‑AGI‑3 REST API
  version: 1.0.0
  description: >
    Programmatic interface for running agents against ARC‑AGI‑3 games,
    opening/closing score‑cards and driving game state with actions.

    All requests **require** an `X‑API‑Key` header issued from the ARC‑AGI‑3 web
    console.


    **Important: Session Affinity via Cookies**  

    Games are stateful and require session affinity. The server sets cookies
    (especially `AWSALB*` cookies) in responses that **must be included in all
    subsequent requests** for the same game session. These cookies route
    requests to the correct backend instance maintaining your game state. Most
    HTTP clients handle cookies automatically, but ensure your client preserves
    and sends cookies received from RESET and ACTION responses.
servers:
  - url: https://three.arcprize.org
security: []
tags:
  - name: Games
  - name: Scorecards
  - name: Commands
paths:
  /api/games/{game_id}:
    get:
      tags:
        - Games
      summary: Retrieve game metadata
      description: |
        Retrieves metadata for one game. You may pass either the complete
        versioned game ID or its stable ID prefix.
      operationId: getGame
      parameters:
        - name: game_id
          in: path
          required: true
          schema:
            type: string
          description: Complete game ID or stable ID prefix (for example, `ls20`).
      responses:
        '200':
          description: Game metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Game'
        '401':
          description: Missing or invalid **X-API-Key** header.
        '404':
          description: No matching game was found.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Game:
      type: object
      description: >
        Human-readable name/identifier pair for an ARC-AGI-3 game.  

        Used when listing available titles or embedding game metadata in other
        payloads.
      properties:
        game_id:
          type: string
          example: ls20-016295f7601e
          description: Stable, globally unique ID combining slug and version/hash.
        title:
          type: string
          nullable: true
          example: LS20
          description: Display title shown in UIs and scorecards.
        default_fps:
          type: integer
          nullable: true
          description: Default playback frame rate for the game.
        tags:
          type: array
          nullable: true
          items:
            type: string
          description: Public labels associated with the game.
        date_downloaded:
          type: string
          format: date-time
          nullable: true
          description: Timestamp associated with the available game metadata.
        class_name:
          type: string
          nullable: true
          description: >-
            Python game class name derived from the game ID when omitted in
            metadata.
      required:
        - game_id
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````