Developer API

Machine-readable error knowledge for IDE plugins, support bots, monitoring tools and AI assistants.

Authentication

Get a key from your account page (Developer plan) and send it on every request:

http

Authorization: Bearer wime_xxxxxxxxxxxxxxxxxxxx

Each plan has a daily call limit; the remaining quota is returned in the X-RateLimit-Remaining header. Errors return JSON with an error field and a matching HTTP status (401, 404, 422, 429).

POST /analyze

Send a raw error message, log excerpt or stack trace; get the detected error, likely area, causes and checks.

bash

curl -X POST https://demo.whatismyerror.com/api/v1/analyze \
  -H "Authorization: Bearer $WIME_KEY" \
  -H "Content-Type: application/json" \
  -d '{"error": "HTTP 403 Forbidden\nnginx/1.24\nGET /api/users", "language": "PHP"}'

Response

{
    "detected": {
        "code": "403",
        "title": "HTTP 403 Forbidden",
        "category": "http",
        "url": "https://demo.whatismyerror.com/errors/http/403-forbidden",
        "meaning": "The server understood the request but refuses to authorize it.",
        "confidence": 97
    },
    "likely_area": "authorization",
    "causes": [
        "Missing permissions for the authenticated user",
        "…"
    ],
    "quick_fix": [
        "…"
    ],
    "platform_fixes": {
        "Nginx": [
            "…"
        ]
    },
    "checks": [
        {
            "step": "Request",
            "check": "…"
        }
    ],
    "signals": {
        "http_status": [
            "403"
        ],
        "platforms": [
            "Nginx"
        ],
        "request": {
            "method": "GET",
            "path": "/api/users"
        }
    },
    "alternatives": []
}

Add "ai": true to include an AI deep analysis in an ai field (counts against your AI quota).

GET /errors/{category}/{slug-or-code}

bash

curl https://demo.whatismyerror.com/api/v1/errors/mysql/1045 -H "Authorization: Bearer $WIME_KEY"

Returns the full error record: meaning, causes, quick fix, platform fixes, examples, diagnostics and related errors.

GET /search?q=

bash

curl "https://demo.whatismyerror.com/api/v1/search?q=invalid%20token&limit=5" -H "Authorization: Bearer $WIME_KEY"

GET /categories

bash

curl https://demo.whatismyerror.com/api/v1/categories -H "Authorization: Bearer $WIME_KEY"