# HTTP Status Code Checker
> Check the live status of up to 10 URLs at once and detect redirects instantly.

## Agent Summary
- FQN: `http-status-checker.underscoredone.com`
- Category: network
- Operator: _done
- Version: 1.0.0
- Endpoints: 1
- Pricing: $0.01
- Page: https://underscoredone.com/http_status_checker
- Markdown: https://http-status-checker.underscoredone.com/index.md
- OpenAPI: https://http-status-checker.underscoredone.com/openapi.json

## Service URL
https://http-status-checker.underscoredone.com

## Use Case
Give this API a list of up to 10 web addresses and it will visit each one to tell you whether it is working, broken, or redirecting visitors somewhere else. You get back the exact status number (like 200 for OK, 404 for not found, 500 for server error), whether the address redirects, and where it redirects to. Great for finding broken links, verifying website migrations, and running quick SEO audits without writing any code.

## How to Call
POST a JSON body with a field called 'urls' containing a list of 1 to 10 fully-qualified web addresses (must start with http:// or https://). Each URL is checked independently. The response is a list of result objects in the same order as the input. Each result includes the final status code seen, whether a redirect happened, and the destination URL if redirected. If a URL could not be reached at all, the error field explains why. Use statusCode to determine health: 2xx means OK, 3xx means redirect, 4xx means client error, 5xx means server error. Never assume the output order differs from input order.

## Endpoint
| Method | URL | Price | Description |
|--------|-----|-------|-------------|
| POST | `https://http-status-checker.underscoredone.com/check` | $0.01/request | Check live status and redirects for up to 10 URLs in one call. |

## Example Request
```json
{
  "urls": [
    "https://onescales.com",
    "https://onescales.com/pages/contact"
  ]
}
```

## Example Response
```json
{
  "api_version": "1.0.0",
  "results": [
    {
      "url": "https://onescales.com",
      "statusCode": 200,
      "isRedirect": false,
      "redirectURL": "",
      "error": ""
    },
    {
      "url": "https://onescales.com/pages/contact",
      "statusCode": 200,
      "isRedirect": false,
      "redirectURL": "",
      "error": ""
    }
  ]
}
```

## Errors
| Status | Meaning |
|--------|---------|
| 400 | Something was wrong with your request — for example, you sent zero URLs, more than 10 URLs, an address that does not start with http:// or https://, or a value that is not a valid web address at all. |
| 422 | The request body is missing the 'urls' field entirely, or 'urls' is not a list. |
| 402 | Payment required — send X-PAYMENT header |