Our APIs may raise errors for many reasons, such as a failed pathing, invalid parameters, authentication errors, and network unavailability. When a request returns an error, the system will provide a message to indicate more details about the failure. If there are particular errors found, they will be listed in the Errors
array. Note that the Errors
array is optional and will only be present when detailed error information is available.
HTTP Status Code Summary
Code | Status | Description |
---|---|---|
🟢 200 | OK | Everything worked as expected. |
🔴 400 | Bad Request | Often missing a required parameter. |
🔴 401 | Unauthorized | No valid API key provided. |
🔴 402 | Request Failed | Parameters were valid but request failed. |
🔴 403 | Forbidden | Returned by open endpoints if they are disabled. |
🔴 404 | Not Found | The requested item doesn’t exist. |
🔴 500, 502, 503, 504 | Server errors | Something went wrong on impact.com’s end. |
While system errors are rare, we recommend writing code that gracefully handles all possible API exceptions. In many cases, these means implementing a retry mechanism with an exponential drop-off in frequency.
Detailed Error Response
{
"Status": "ERROR",
"Message": "Validation Failed",
"Errors": [
{
"Field": "AccountId",
"Message": "Not a numeric value"
}
]
}
<ImpactRadiusResponse>
<Status>ERROR</Status>
<Message>Validation Failed</Message>
<Errors>
<Error>
<Field>AccountId</Field>
<Message>Not a numeric value</Message>
</Error>
</Errors>
</ImpactRadiusResponse>