HTTP Response Codes

Error Codes

Our endpoints use Standard HTTP response codes to indicate API request success or failure.

General HTML status codes

2xx Success.

4xx Errors based on information provided in the request

5xx Errors on viaNexus Data Platform servers

viaNexus Data Platform HTTP Status Codes

HTTP CodeTypeDescription
400Incorrect ValuesInvalid values were supplied for the API request
400No SymbolNo symbol provided
400Type RequiredBatch request types parameter requires a valid value
401Authorization RestrictedHashed token authorization is restricted
401Authorization RequiredHashed token authorization is required
401RestrictedThe requested data is marked restricted and the account does not have access.
401No KeyAn API key is required to access the requested endpoint.
401Secret Key RequiredThe secret key is required to access to requested endpoint.
401Denied RefererThe referer in the request header is not allowed due to API token domain restrictions.
402Over LimitYou have exceeded your allotted credit quota (and pay-as-you-go is not enabled on legacy plans).
402Free Tier Not AllowedThe requested endpoint is not available to free accounts.
402Tier Not AllowedThe requested data is not available to your current tier.
403Authorization InvalidHashed token authorization is invalid.
403Disabled KeyThe provided API token has been disabled
403Invalid KeyThe provided API token is not valid.
403Test Token in ProductionA test token was used for a production endpoint.
403Production Token in SandboxA production token was used for a sandbox endpoint.
403Circuit BreakerYour pay-as-you-go circuit breaker has been engaged and further requests are not allowed.
403InactiveYour account is currently inactive.
404Unknown SymbolUnknown symbol provided
404Not FoundResource not found
413Max TypesMaximum number of types values provided in a batch request.
429Too Many RequestsToo many requests hit the API too quickly. An exponential backoff of your requests is recommended.
451Enterprise Permission RequiredThe requested data requires additional permission to access.
500System ErrorSomething went wrong on an viaNexus Data Platform server.