This document covers some general API conventions including authentication.


The base URL for our API is


All API requests must contain an API key for authentication. Generate a new API Key under Org Management => API Keys on the Testable product site.

There are two ways to pass the API key with your request.

  1. X-Testable-Key HTTP header. Example: curl --header "X-Testable-Key: [api-key]"
  2. key query param. Example: curl[api-key]