AGENTUTIL
DocsTools Reference

URL Status

$0.005per call
url.status

Check if a URL is reachable and get response details

Endpoint
POST /v1/tools/url.status/tasks

Input

FieldTypeRequiredDescription
urlstringyesURL to check (http or https)
follow_redirectsbooleannoWhether to follow redirects
timeout_msintegernoRequest timeout in milliseconds (max 30000)

Output

FieldTypeDescription
urlstringOriginal URL requested
final_urlstringFinal URL after any redirects
status_codeintegerHTTP status code (0 if unreachable/timeout)
status_textstringHTTP status text or error message on failure
reachablebooleanWhether the URL returned a successful (2xx) response
headersobjectResponse headers as key-value pairs
sslobjectSSL info for https:// URLs (null for http://)
response_time_msintegerTime taken in milliseconds
checked_atstring

Example

Request
{
  "url": "https://example.com"
}
Response
{
  "url": "https://example.com",
  "final_url": "https://example.com/",
  "status_code": 200,
  "status_text": "OK",
  "reachable": true,
  "headers": {
    "content-type": "text/html; charset=UTF-8",
    "server": "ECS"
  },
  "ssl": {
    "valid": true
  },
  "response_time_ms": 156,
  "checked_at": "2026-03-07T08:00:00.000Z"
}