Retrieve puzzle metadata
GET/api/v1/puzzles
Retrieves puzzle metadata based on specific criteria. Supports two mutually exclusive request types:
1. Specific Puzzle Request: Returns metadata for a single puzzle.
- Requires
series
andid
.
2. Time Range Request: Returns a list of puzzles within a given time range, sorted by publish time in descending order (newest first).
- Requires
series
. from
andto
define the time range (both must be in ISO 8601 format with a timezone offset).limit
andoffset
can be used for pagination.
Request
Responses
- 200
- 400
- 401
- 403
Successful response with puzzle metadata
Bad request (missing/invalid parameters)
Unauthorized (invalid or missing API token)
Forbidden (no access to series)