HTTP Status Lookup API

Development

Free HTTP status code lookup tool. Search, understand, and debug API responses with comprehensive status code meanings.

Authentication

All API requests require a valid API key passed in the Authorization header as a Bearer token.

Rate Limit

100 requests per minute

Endpoints

1 endpoint available

Overview

The HTTP Status Lookup API provides detailed information about HTTP status codes. Query by status code number or search by keyword to get comprehensive details including title, description, category, and RFC reference.

Status Code Categories

1xx Informational - Request received, continuing process
2xx Success - Request successfully received, understood, and accepted
3xx Redirection - Further action required to complete the request
4xx Client Error - Request contains bad syntax or cannot be fulfilled
5xx Server Error - Server failed to fulfill a valid request

Response Data

Each status code includes:

code - The numeric HTTP status code
title - Short name (e.g., "Not Found")
description - Detailed explanation of the status
category - Informational, Success, Redirection, Client Error, or Server Error
reference - RFC specification reference

Use Cases

API error handling and debugging
Building developer documentation
Educational tools for web development
Automated error message generation

Endpoints

GET

/v1/tools/http-status-lookup

Look up HTTP status code(s) by code or search query

Request Body

Content-Type: application/json

Parameter	Type	Required	Description
code	number	Optional	Specific HTTP status code to look up (e.g., 404)
query	string	Optional	Search query to find matching status codes by title or description

Response Example

{
  "success": true,
  "results": [
    {
      "code": 404,
      "title": "Not Found",
      "description": "The requested resource could not be found but may be available in the future.",
      "category": "Client Error",
      "reference": "RFC9110, Section 15.5.5"
    }
  ],
  "total": 1
}

Error Codes

400

Invalid request parameters

401

Missing or invalid API key

429

Rate limit exceeded

500

Internal server error

Code Examples

# Look up a specific status code
curl -X GET "https://api.opentools.ca/v1/tools/http-status-lookup?code=404" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Search for status codes by keyword
curl -X GET "https://api.opentools.ca/v1/tools/http-status-lookup?query=unauthorized" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get all status codes
curl -X GET "https://api.opentools.ca/v1/tools/http-status-lookup" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ready to get started?

Create an API key to start using the HTTP Status Lookup API.