API Overview

Understand general concepts, response codes, and authentication strategies.

Base URL

The API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP.

All requests contain the following base URL:

https://api.data-tabs.com

Authentication

To authenticate you need to add an Authorization header with the contents of the header being Bearer skey_xxxxxxxxx where skey_xxxxxxxxx is your API Key.

Authorization: Bearer skey_xxxxxxxxx

Response Codes

We use standard HTTP codes to indicate success or failure of your requests: 2xx HTTP codes correspond to success, 4xx codes are for user-related failures, and 5xx codes are for server side issues.

Rate Limits

The default maximum rate limit is 2 requests per second for pro users and 1 request per second for basic users. This limit applies across all API keys associated with your account. This number can be increased for business users on request. After that, you’ll hit the rate limit and receive a 429 response error code.

Errors

We use standard HTTP response codes for success and failure notifications, and our errors are further classified by error code.

Code

Status

Details

request

400

The submitted http body contains invalid json.

value

400

The submitted value parameter has an invalid data type is outside of the defined min or max value.

data_type

400

You have tried to write a value into a read-only data type, e.g. an action button.