Vizion API's HTTP response codes

Vizion uses conventional HTTP response codes to indicate the success or failure of an API request. In general, responses are categorized as follows:

  • Success: Codes in the 2XX range indicate a success.
  • Client error: Codes in the 4XX range indicate an error due to the information provided (e.g., a required property was omitted, provided value is incorrect).
  • Server error: Codes in the 5XX range indicate an error with Vizion's servers; these are rare.

HTTP status codes

HTTP CodeSummaryDefinition
200OKThe server successfully processed the request.
400Bad RequestThe server cannot or will not process the request. Typically, it is due to a malformed request or missing parameter.
401UnauthorizedProvided API key lacks required permissions.
403ForbiddenA valid API key was not provided.
404Not FoundThe requested entity could not be found.
422Unprocessable EntityThe request was well-formed but rejected due to semantic errors.
429Too Many RequestsToo many requests hit the API too quickly, or the request cap has been hit.
500, 502, 503, 504Server ErrorsSomething went wrong on Vizion's end; these are rare.