REST API Reference
WittyStatus API provides structured, developer-friendly JSON payloads and self-contained HTML pages for HTTP error handling, maintenance alerts, and downtime reassurance.
Returns a complete diagnostic error response with a randomized witty message, technical root cause, and concrete user recovery advice.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | integer | Yes | Target HTTP status code (must be between 400 and 599). Graceful fallback generated if unmapped. |
Example Response (HTTP 404)
{
"success": false,
"status": 404,
"title": "Not Found",
"headline": "This page went on an existential walk",
"wittyMessage": "We searched every digital nook and database cranny. This page appears to have vanished into thin air.",
"technicalDetails": "Target route is missing from active Fastify route tables.",
"actionAdvice": "Verify your path segments or return to the base application url.",
"suggestedAction": "back",
"timestamp": "2026-08-31T12:00:00.000Z",
"requestId": "req_a8x9z"
}
Fetches a single random witty status quote object. Supports optional filtering by status code or category.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | integer | No | Filter by HTTP code (e.g. 404, 500, 429). |
| category | string | No | Filter by category: client_error, server_error, or maintenance. |
Returns an array containing all status quotes currently registered in the quote bank (394 quotes total).
Returns live structured maintenance status with simulated progress percentage, current technical task, and estimated completion time with HTTP 503 status.
System health check endpoint returning server status, uptime seconds, and ISO timestamp.
{
"status": "healthy",
"uptime": 142.5,
"timestamp": "2026-08-31T12:00:00.000Z"
}
Status Code Catalog (394 Quotes Bank)
Each major status code includes exactly 30 human-crafted quotes covering engineering themes, plus dedicated teasers and maintenance responses.
| Code | Standard Name | Quotes | Themes Covered | Action |
|---|