Free HTTP Status Code API - Codes Explained

Parameters

name	in	type	required	description
`code`	query	number	required	Enter a status code between 100 and 599 range `100 to 599`

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/http-status?code=404" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://apixies.io/api/v1/http-status?code=404", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

$ch = curl_init("https://apixies.io/api/v1/http-status?code=404");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: YOUR_API_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);

import requests

res = requests.get(
    "https://apixies.io/api/v1/http-status",
    params={"code": "404"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(res.json())

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.name: Official name, like Too Many Requests.
data.description: Plain explanation of what the code means.
data.common_causes: Usual reasons you'd see this code.
data.how_to_fix: Practical steps to resolve it.
data.category: Class name like Client Error, with 4xx in category_code.
data.is_error: True for 4xx and 5xx codes.

example response 200

{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "HTTP status code found",
    "data": {
        "code": 429,
        "name": "Too Many Requests",
        "category": "Client Error",
        "category_code": "4xx",
        "description": "The user has sent too many requests in a given amount of time.",
        "common_causes": [
            "API rate limit exceeded",
            "Too many login attempts",
            "Aggressive web scraping or crawling",
            "Missing or incorrect rate limit handling in client code"
        ],
        "how_to_fix": [
            "Implement exponential backoff and retry logic",
            "Check the Retry-After response header for wait time",
            "Reduce request frequency or batch requests",
            "Contact the API provider to request higher rate limits"
        ],
        "is_error": true,
        "is_cacheable": false,
        "spec": "RFC 6585"
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

related endpoints

GET SSL Health Inspector Inspect SSL certificate details for a domain, including validity, expiry and chain health GET Security Headers Inspector Inspect security headers for a URL to check for adherence to current best practices GET Email Inspector Inspect email address details including format validation, MX record checks, and disposable email de... GET User Agent Inspector Parse a User-Agent string to detect browser, operating system, device type and bot status

getting started

authentication code examples response format

explore

all api endpoints guides and tutorials online tools

resources

homepage changelog suggest an endpoint

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

get a temporary key create an account