API Overview

Authentication

All API calls require authenticating with your API token. You can create and expire tokens in your dashboard.

The HTTP API expects the API token to be formatted as a standard Bearer token and passed in the Authorization header.

For example, if your token is abc, the Authorization header value is simply Bearer abc.

Encoding

The API uses JSON encoding for both request and response payloads.

Compression

JSON encoded document payloads can be quite large. To save on networking costs, we recommend compressing your requests, and accepting compressed responses. The API supports standard HTTP compression headers:

Compress your request payload and include Content-Encoding: gzip to enable compressed requests.

Include Accept-Encoding: gzip to enable compressed responses.

Error responses

If an error occurs for your request, all endpoints will return a JSON payload in the format:

{
  "status": "error",
  "error": "an error message"
}