Sudoku API

Generate Sudoku puzzles for your app or website. Validate grids, analyze difficulty, export worksheets and publish playable links through REST or MCP.

https://sudokumax.com/api/v1JSON · Bearer authentication

Make your first request

Create your free account and API key. Save the key on your server.
Send a request with Authorization: Bearer YOUR_API_KEY.
Use the returned grid in your app. Include the required Sudokumax attribution when publishing it.

Terminal · SUDOKUMAX_API_KEY must be set in your environment

curl https://sudokumax.com/api/v1/generate \
  -H "Authorization: Bearer $SUDOKUMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 1, "difficulty": "beginner"}'

POST /api/v1/generate → 200 application/json

Explore input fields, response fields and a live request →

Choose an endpoint

POST /generate

Generate puzzles

Puzzle grids, solutions and technique analysis for your own game.

Reference & playground →POST /check

Check uniqueness

Find out whether a grid has exactly one solution.

Reference & playground →POST /analyze

Analyze difficulty

Inspect clues, solving techniques and measured difficulty.

Reference & playground →POST /validate

Validate progress

Check player entries, changed givens and puzzle completion.

Reference & playground →POST /hint

Get a hint

Return one explained singles placement for the current board.

Reference & playground →POST /publish

Publish puzzles

Get a hosted playable link for each grid and a collection URL.

Reference & playground →POST /worksheets

Export worksheets

Turn your own grids into branded PDFs with answer sheets.

Reference & playground →POST /packs

Create worksheet pack

Generate up to 20 puzzles, PDFs and playable links in one call.

Reference & playground →

Building a Sudoku app?

The API provides the puzzles

Generate verified grids and solutions, inspect difficulty, create printable content and offer hosted links. Use your own interface and branding while retaining the required Sudokumax credit.

Your app provides the player experience

Build your own grid UI, player accounts, saved progress, timer and scoring. Use the progress validation and singles-hint endpoints for player feedback. Keep solutions and API keys on your server.

Free, with attribution

API calls cost $0. Everything you publish must reference Sudokumax: a visible hyperlink online, and the website address offline. Pricing & attribution details →