Skip to main content
This page demonstrates how to interact with the ARC-AGI-3 API directly using HTTP requests. This is useful for understanding what happens “under the hood” when running a game.
Recommended approach: For most use cases, we recommend using the ARC-AGI Toolkit instead of calling the API directly. The Toolkit handles authentication, error handling, and provides a simpler interface.

Direct API Workflow

Below is the full workflow for running a game programmatically via the API.

Game State Enumeration

Full Playtest Example

This is a bare-bones example (for educational purposes) also available as a notebook.
This workflow ensures your plays are tracked officially. For parallel playtests across games, use a swarm to handle the orchestration automatically.