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

ParameterTypeRequiredDescription
valuestringYesHTTP 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

FieldTypeDescription
validbooleanWhether the value is a standard HTTP status code
codenumberNumeric HTTP status code
reasonPhrasestringStandard reason phrase (e.g. OK, Not Found)
categorystringCategory: 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

FieldTypeDescription
codenumberHTTP status code
reasonPhrasestringStandard reason phrase
categorystringStatus 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" },
  ...
]