HTTP Status Code
GET/v0/http-status
Validates an HTTP status code against the list of standard codes defined by IANA. When valid, returns the numeric code, its reason phrase, and the category (informational, success, redirection, client-error, or server-error).
Try it
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| value | string | Yes | HTTP status code as a numeric string (e.g. 200, 404, 503) |
Example Requests
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.isvalid.dev/v0/http-status?value=200"
Response Fields
| Field | Type | Description |
|---|---|---|
| valid | boolean | Whether the value is a standard HTTP status code |
| code | number | Numeric HTTP status code |
| reasonPhrase | string | Standard reason phrase (e.g. OK, Not Found) |
| category | string | Category: informational, success, redirection, client-error, or server-error |
Example Response
{
"valid": true,
"code": 200,
"reasonPhrase": "OK",
"category": "success"
}Example Response — invalid
{
"valid": false
}GET/v0/http-status/list
Returns the complete list of all standard HTTP status codes with their reason phrases and categories.
Example Request
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.isvalid.dev/v0/http-status/list"
Object Fields
| Field | Type | Description |
|---|---|---|
| code | number | HTTP status code |
| reasonPhrase | string | Standard reason phrase |
| category | string | Status category |
Example Response
[
{ "code": 100, "reasonPhrase": "Continue", "category": "informational" },
{ "code": 200, "reasonPhrase": "OK", "category": "success" },
{ "code": 301, "reasonPhrase": "Moved Permanently", "category": "redirection" },
{ "code": 404, "reasonPhrase": "Not Found", "category": "client-error" },
{ "code": 500, "reasonPhrase": "Internal Server Error", "category": "server-error" },
...
]