Requests & responses

How to properly format your API requests


Livestorm's REST API follows the JSON API conventions, which means that you'll have to encode your requests in JSON. Additionally, don't forget to add the Content-Type: application/json header to your HTTP requests. All requests must be sent over HTTPS.


Similarly, API responses will be JSON-encoded. Standard HTTP codes will apply:

  • 200, 201, 204 for successful requests (GET, POST, PUT, DELETE)
  • 400, 404, 422, 429 for bad formatting, not found, incorrect data or too many requests
  • 401 and 403 for unauthorised requests