Error Codes

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>