Diagnostic API Responses

At times, server sends diagnostic responses instead of requested data. Please find below list of possible informational messages (returns as text/plain) by our server. Most of these responses are self-explanatory. Your code should be designed to handle these responses which are returned as text/plain .

400 – Bad Request

These errors occur when the request contains invalid parameters or parameter combinations.

Error Message	Description
Invalid API key	Returned when the provided API key is invalid.
Use exactly one of: symbol, isin, company, scrip_code	Please provide only one company identifier in the request.
Use only one of: symbols, isins, scrip_codes	Please provide only one type of identifier in a multi-company request.
Please provide either 'symbols', 'scrip_codes', or 'isins' parameter	At least one identifier must be provided in a multi-company request.
Company name search is not supported in multi-company requests	Please use the single company endpoint for company name search.
No identifiers provided	Please provide valid symbols, ISINs, or scrip codes.
Too many identifiers provided. Maximum allowed: 20	Please limit the number of identifiers to 20 per request.
'from' date must be before 'to' date	Please ensure the 'from' date is earlier than the 'to' date.
Invalid date format	Please provide dates in ISO 8601 format (e.g., 2025-01-01T00:00:00+05:30).
Invalid date range	Please request 'from' and 'to' parameter values within the allowed period.
limit/offset must be non-negative integers	Please provide valid non-negative numeric values for pagination.
Invalid sentiment. Allowed: positive, negative, neutral	Please provide a valid sentiment value.
Invalid article_type for company-specific news	Please use valid article types applicable for company-specific news.
Invalid article_type for general news	Please use valid article types applicable for general news.

404 – Not Found

These errors occur when the requested resource does not exist.

Error Message	Description
Company with symbol '{symbol}' not found	No company found for the provided symbol.
Company with ISIN '{isin}' not found	No company found for the provided ISIN.
No companies found with name matching '{company}'	No matching company found for the provided name.
No valid companies found for the provided symbols	None of the provided symbols are valid.
No valid companies found for the provided ISINs	None of the provided ISINs are valid.
Invalid symbols: {symbol1, symbol2}	Some of the provided symbols are invalid.

500 – Internal Server Error

These errors indicate server-side issues.

Error Message	Description
Internal server error	An unexpected error occurred. Please try again later or contact support if the issue persists.

Webhook Error Responses

400 – Bad Request

{
"error": "Invalid webhook URL. Must be a valid HTTPS URL"
}

Please provide a valid HTTPS webhook URL.

409 – Conflict

{
"error": "Invalid webhook URL. Must be a valid HTTPS URL"
}

The webhook URL is invalid or already exists. Please verify and try again.

Diagnostic API Responses

400 – Bad Request#

404 – Not Found#

500 – Internal Server Error#

Webhook Error Responses#

400 – Bad Request#

409 – Conflict#

400 – Bad Request

404 – Not Found

500 – Internal Server Error

Webhook Error Responses

400 – Bad Request

409 – Conflict