Sudoku of the Day API

Documentation

Base URL

https://sudoku.freeapi.me/

All API requests should be made to this endpoint. HTTPS is required for all API calls.

Request Methods

The Sudoku of the Day API accepts GET requests only.

Parameters

This API does not accept any query parameters. A simple GET request to the base URL will return the current Sudoku of the Day.

Example Requests

# Get the Sudoku of the Day
curl https://sudoku.freeapi.me/

// Get the Sudoku of the Day
fetch('https://sudoku.freeapi.me/')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

# Get the Sudoku of the Day
response = requests.get('https://sudoku.freeapi.me/')
data = response.json()
print(data)

// Get the Sudoku of the Day
$response = file_get_contents('https://sudoku.freeapi.me/');
$data = json_decode($response, true);
print_r($data);

Response Format

The API returns a JSON object containing the Sudoku puzzle of the Day and related details.

{
  "date": "2025-04-25",                  // string | The date (YYYY-MM-DD) for this puzzle
  "puzzle_url": "https://sudoku-qr...",  // string | URL to the puzzle image
  "difficulty": "Medium",                 // string | Difficulty level of the puzzle
  "generation_timestamp": 1745540448,    // number | Unix timestamp when created
  "e_ink_optimized": true,               // boolean | Whether optimized for e-ink displays
  "solution_url": "https://sudoku-qr..." // string | URL to the solution image
}

Key Response Properties

• date - The date (YYYY-MM-DD) for which this puzzle is featured.
• puzzle_url - A URL to the puzzle image in PNG format.
• difficulty - The difficulty level of the puzzle (e.g., "Easy", "Medium", "Hard").
• generation_timestamp - Unix timestamp indicating when the puzzle was generated.
• e_ink_optimized - Boolean value indicating whether the puzzle images are optimized for e-ink displays.
• solution_url - A URL to the solution image in PNG format.

Error Responses

The API may return the following error responses:

• 403 Forbidden - Returned if the request is made over HTTP instead of HTTPS.
• 500 Internal Server Error - Returned if the service encounters an unexpected error or cannot generate the puzzle data. The response body may contain more details in a JSON format: `{"error": "...", "details": "..."}`.