Error Codes
| HTTP Status | Description |
| 400 |
Bad Request – Please check the request that is submitted. |
| 403 |
Forbidden – Server failed to authenticate for the given appkey or the resources. |
| 503 |
Service Unavailable – The server is currently unable to receive requests. Please retry your request. |
| 596 |
Service Not Found – The specified resource is not found. Please check the request. |
Common error reasons
1. Invalid API Key is specified in URI.
Example:
https://datafied.api.edgar-online.com/v2/corefinancials/ann.json?Primarysymbols=msft&appkey={INVALIDAPPKEY}
Response:
403 Forbidden
X-DataFied-Error-Code: ERR_403_DEVELOPER_INACTIVE
{
"StatusCode": 403,
"Message": "Application Key does not exist. Please contact contactsupport@edgar-online.com for support."
}
2. Limit of calls per second is exceed.
Example of Response:
403 Forbidden
X-DataFied-Error-Code: ERR_403_DEVELOPER_OVER_QPS
{
"StatusCode": 403,
"Message": "You've exceed the per second rate limit. Please review the documentation or contact support at contactsupport@edgar-online.com."
}
3. Rate Limit of calls is exceed.
Example of Response:
403 Forbidden
X-DataFied-Error-Code: ERR_403_DEVELOPER_OVER_RATE
{
"StatusCode": 403,
"Message": "You've exceed the rate limit. Please review the documentation or contact support at contactsupport@edgar-online.com."
}
4. URI path contains a mistake:
Example:
https://datafied.api.edgar-online.com/v2/companies123?primarysymbols=aapl&appkey={APPKEY}
Response:
596 596
X-DataFied-Error-Code: ERR_596_SERVICE_NOT_FOUND
<h1>596 Service Not Found</h1>