Skip to main content
Errors return JSON with a detail field. 
{
  "detail": "Rate limit exceeded. pro tier: 300 req/min."
}

​
Status codes

CodeMeaning
200Success
201Created (webhooks)
401No API key provided
403Bad key or wrong tier for this feature
404Alert or resource doesn’t exist
429Rate limited — Retry-After header included
500Server error — DM @alrerat

​
Handling errors

r = requests.get(url, headers=headers)

if r.status_code == 429:
    wait = int(r.headers.get("Retry-After", 60))
    time.sleep(wait)
elif r.status_code == 403:
    print("Wrong tier or bad key")
elif r.status_code != 200:
    print(f"Error {r.status_code}: {r.json()['detail']}")