APIs & Services
Authentication
API Keys and Usage Plans
4 min
an api key is required to access all altrata apis the api key determines the usage plan associated to your requests your api key should have been delivered to your via an email if it has not, contact your account manager example api key 8kihysx,0l bwlp=rc2m,i wvu,b0fz usage plan your api key determines your usage plan and is not an authentication or authorization mechanism currently, only one usage plan is provided, with the following limits api keys have set limits on them these limits will be determined by how you are making your requests to the the api endpoint you will need to provide your api key as a header value for the x api key header altrata exclusive preview (aep) plan service rate burst quota profile api 5 per second 3 requests 100 requests per day matching api 100 per second 50 requests 1,000,000 requests per day errors exceeding these limits causes the following error messages to be returned 429 too many requests when you have exceeded your rate limit to resolve this error, use retries and an exponential backoff algorithm with jitter, and then resubmit your api request 429 limit exceeded when you have exceeded your daily quota if you require an increase in your rate limit, or quota, please reach out to your account manager api key expiration api keys currently do not have a set expiration date and time if you wish to rotate your api key, please contact altrata support who will be able to assist in the matter