Welcome

Read-only access to your company’s data in Thera. Keys call GET endpoints. Anything that writes is refused.

Get a key

You can create an api key from the Settings page in the Thera app. Navigate to /account-preferences/api-keys. A key belongs to one company and reads only that company’s data.

Note: If you have keys issued before self-serve, they still work and appear there as legacy keys but we recommend to migrate them to new keys.

Authenticate

Send the key as X-Thera-API-Key in the request header of api call.

curl https://api.getthera.com/companies/{companyId}/teams \
  -H "X-Thera-API-Key: <your key>"

Most endpoints take a companyId. Ask Thera support if you are not able to find your company ID.

Rate limit

600 requests a minute. Past that you get a 429 with the wait time.

That one and every other error is described on the Errors page.