HTTP
HTTP Status Code API
/status/:codeRequest a supported HTTP status code for client testing.
No signup or API key required.
Parameters
codeenumrequired · path- HTTP status to return. 204, 205, and 304 have no body. Redirect statuses do not include a Location header.
200201202204205301302303304307308400401403404405408409410413414415418422425429451500501502503504507511 formatenumoptional · query- Response format. Defaults to json.
jsontext
No request body. Unknown or repeated query parameters return HTTP 400.
Returns requested status
A JSON object, except for 204, 205, and 304, which have no body. Error status codes are intentional test responses.
statusinteger- The requested HTTP status code. No response body for 204, 205, or 304.
Plain text
With format=text: The numeric status code. 204, 205, and 304 still have no response body.
Errors
Validation and service errors always return JSON, including when format=text. Requested test statuses use the response structure above instead.
errorstring- A machine-readable error code, such as invalid_parameter or rate_limited.
messagestring- A description of the problem.
400 Invalid parameters.
414 Query string exceeds 2048 characters.
429 Rate limit reached. Wait the seconds in Retry-After before retrying.
Usage notes
Supported: 200, 201, 202, 204, 205, 301, 302, 303, 304, 307, 308, 400, 401, 403, 404, 405, 408, 409, 410, 413, 414, 415, 418, 422, 425, 429, 451, 500, 501, 502, 503, 504, 507, 511. 204, 205, 304 have no body. Redirect statuses have no Location header.
Exercise success and error handling in an HTTP client. A 418 response is intentional, not a service failure; redirect statuses have no Location header.
Responses are not cached. Browser requests are supported through open CORS.
120 requests per minute per IP, with up to 30 per 10 seconds, shared across APIs. Limits are approximate per Cloudflare location. Full usage limits ↗