Best Practices
Use ISIN and ticker together
Supplying both isin and ticker is recommended. Some tickers map to multiple companies across exchanges — the ISIN guarantees a unique match.
Guard against null fields
Either actual or estimate may be null for a given document. Always use .get() or optional chaining before accessing nested fields. ai_insights may also be null if the document has not yet been processed.
Rate limiting
If you receive a 429 response, back off and retry after a short delay. Implement exponential back-off for high-volume integrations.
Error codes
200OKRequest succeeded.400Bad RequestMissing or invalid identifier parameters.401UnauthorizedMissing or invalid api_key.404Not FoundNo company found for the supplied identifier.429Rate LimitedToo many requests. Back off and retry.500Server ErrorUnexpected server error. Contact support.Reporting issues
When reporting an issue, include the request URL (with API key redacted), the HTTP status code, and the approximate UTC timestamp. Contact sahng.ibrahim@eqlglobal.com for technical support.