HTTP Status codes

Our survey API responses return the correct status code related to the response. The actual description of the error will be available in the PayLoad.Data property of the response.

• 200

  Append querystring parameter "statusok" to your url to always get a 200 status. The PayLoad.Meta.Status property will still contain the correct status code.

• 204 No Content

  No item found with the specified key

• 304 Not Modified

  When requesting a resource which might be cached with the If-None-Match header, you will get an empty 304 response to indicate the cache is still valid.

• 400 Bad Request

  The query you have created is incorrect.

• 401 Unauthorized

  Missing or incorrect Authentication headers.

• 403 Forbidden

  There are several reasons why you get a 403 response.
  1. You are trying to connect to our API using http instead of https. Https is required for all connections.
  2. You didn't specify the region in the URI as explained in the HTTP-request requirements.
  3. You are using a key which doesn't have the correct access rights to perform your request.

• 404 Not Found

  The URL is not found

• 405 Method Not Allowed

  The URL is found but the HTTP verb doesn't match.

• 415 Unsupported Media Type

  The Content-Type header is required for all POST/PUT operation. Please check if the request body matches the Content-Type header.
  Currently we support XML and JSON for all request. Except for the import, where you can sent files directly.

• 429 Too Many Requests

  Your request has exceeded your throttling limit. You can verify your throttling limit in the log section.
  

• 500 Internal Server Error

  The server encountered an unexpected condition which prevented it from fulfilling the request.