Skip to main content

HTTP Response Codes

CodeStateDescription
200SuccessEverything worked as expected
201CreatedOperation led to creation of a resource
204No ContentServer fulfilled request, no content in response body
400Bad RequestRequest not accepted, often due to missing required parameter
401UnauthorizedInvalid API key provided
403ForbiddenAuthorization by a secret key required
404Not FoundRequested resource does not exist
422Unprocessable EntityCannot process request due to logical error
5xxServer ErrorsSomething went wrong on Qonversion’s end (rare)

Error Response Format

All errors follow a consistent format:
{
  "error": {
    "type": "request",
    "code": "invalid_data",
    "message": "Failed validate request data"
  },
  "_meta": {
    "reference": "https://documentation.qonversion.io/reference/handling-api-errors",
    "fields": [
      {
        "name": "short_name",
        "messages": ["Value is too long"]
      },
      {
        "name": "last_name",
        "messages": ["Required"]
      }
    ]
  }
}

Error Types

TypeDescription
requestError in request validation (not enough data, invalid data, auth required)
resourceRequest is valid but the action could not be executed
logicalClient can execute action but there is an error in communicating with the application
internalAll request handling stages succeeded but an internal error occurred

Error Codes

Request Errors

CodeDescription
invalid_dataValidation failed. See _meta.fields for details
invalid_requestUnrecognized request URL
control_unauthorizedAuthorization required
not_implementedFunctionality at the requested address is not implemented

Resource Errors

CodeDescription
not_foundRequested resource not found
already_existsRequested resource already exists

Logical Errors

CodeDescription
purchase_fraudCould not validate purchase with store, potential fraud
relation_not_foundNested objects could not be found or associated

Internal Errors

CodeDescription
storage_errorData was not saved
network_errorInternal services interaction failed
unknown_errorUnknown reason