Fetch a URL and report status, timing, and redirect info.
This GET-first endpoint downloads a public URL (HEAD+GET fallback) and returns status metadata, response headers, and optional body snippet. Useful for uptime checks and lightweight monitors.
/checks/status-checkWhere this helper shines
Fetch a URL and report status, timing, and redirect info. keeps checks helpers on autopilot. Use it whenever you need to fetch a URL and report status, timing, and redirect info without pausing a sprint or asking design/dev to jump in.
- Trigger this helper whenever you need to fetch a URL and report status, timing, and redirect info without waiting on a full deploy.
- Drop it into automations (Zapier, Make, workers) to fetch a URL and report status, timing, and redirect info as part of your workflow.
- Share the GET URL so support and success can fetch a URL and report status, timing, and redirect info safely using their Dataczar API key.
Copy & ship snippets
GET
Instant link
GET https://api.dataczar.app/checks/status-check?url=https%3A%2F%2Fexample.com%2Fsample.png&method=GET&timeout=5&max_redirects=5&ak=demoOpen directly in any browser, webhook, or low-code workflow.
curl
curl GET
curl "https://api.dataczar.app/checks/status-check?url=https%3A%2F%2Fexample.com%2Fsample.png&method=GET&timeout=5&max_redirects=5&ak=demo"Swap ak=demo with your Dataczar API key.
curl
curl POST
curl -X POST "https://api.dataczar.app/checks/status-check?ak=demo" \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com/sample.png",
"method": "sample_method",
"timeout": 30,
"max_redirects": 40,
"include_body": true,
"dryrun": true
}'Send JSON payloads from back-end jobs, queues, or workers.
Parameters
Query Parameters
| Name | Type | Description |
|---|---|---|
| url | string · required | Absolute URL to fetch (http/https). |
| method | string | HTTP method to use. |
| timeout | number | Timeout in seconds (max 30). |
| max_redirects | integer | Maximum redirects to follow. |
| include_body | boolean | When true, include first 1024 bytes of body (text only). |
| dryrun | boolean | Dryrun simulates the response shape without performing network I/O. |
All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.
Responses
Status 200
Status fetched (or simulated in dryrun).
{
"ok": true,
"data": {
"url": "https://www.dataczar.com/",
"status_code": 200,
"final_url": "https://www.dataczar.com/",
"redirect_count": 0,
"duration_ms": 231,
"headers": {
"content-type": "text/html; charset=utf-8"
},
"body_preview": "<!doctype html>..."
},
"meta": {
"service": "test/status-check",
"dryrun": false,
"request_id": "req_123"
}
}Examples
Request
"GET /test/status-check?url=https://example.com&ak=demo"Response
{
"ok": true,
"data": {
"url": "https://example.com",
"status_code": 200,
"final_url": "https://example.com",
"redirect_count": 0,
"duration_ms": 180,
"headers": {
"server": "ECS"
}
},
"meta": {
"dryrun": false
}
}Request
"GET /test/status-check?url=https://example.com&dryrun=1"Response
{
"ok": true,
"data": {
"url": "https://example.com",
"status_code": 200,
"final_url": "https://example.com",
"redirect_count": 0,
"duration_ms": 0,
"headers": {}
},
"meta": {
"dryrun": true
}
}Test Contracts
[
{
"name": "reject_missing_url",
"method": "GET",
"params": {},
"expect_status": 400
},
{
"name": "dryrun_skip_fetch",
"method": "GET",
"params": {
"url": "https://example.com",
"dryrun": true
},
"expect": {
"status_code": 200
}
}
]Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.