docsgetting-startederror-handling

Error Handling

The API uses standard HTTP status codes: 200 success, 400 bad request, 401 unauthorized (missing or invalid session/API key), 402 payment required (plan past_due or cancelled), 500 server error. Data and accuracy endpoints require authentication. Rate limits apply per plan. Responses may be cached for up to 5 minutes. Data refreshes every 5 minutes from upstream NWS feeds.

← Response Format

Station Metadata →

cURL

# Bad request (HTTP 400)
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/accuracy/summary?format=xml" | jq

{
  "success": false,
  "error": "format must be json or csv",
  "metadata": {
    "generated_at": "2026-02-20T23:55:00Z",
    "endpoint": "/api/v1/accuracy/summary"
  }
}

# Rate limited — 1,000 req/hour per IP
# Contact us for enterprise tiers

# Caching
# Responses cached up to 5 minutes
# Data refreshes every 5 minutes from NWS

cURL

# Bad request (HTTP 400)
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/accuracy/summary?format=xml" | jq

{
  "success": false,
  "error": "format must be json or csv",
  "metadata": {
    "generated_at": "2026-02-20T23:55:00Z",
    "endpoint": "/api/v1/accuracy/summary"
  }
}

# Rate limited — 1,000 req/hour per IP
# Contact us for enterprise tiers

# Caching
# Responses cached up to 5 minutes
# Data refreshes every 5 minutes from NWS