API Overview
Integrate Bounce API with backend, frontend and applications
Last updated
Was this helpful?
Integrate Bounce API with backend, frontend and applications
Last updated
Was this helpful?
The Bounce API uses personal access tokens to authenticate requests. You can view and manage your access tokens in the Developer Settings of your Bounce user account.
API requests are authenticated using the . To authenticate a request, provide the token in the Authorization header of the request:
Access tokens are tied to the Bounce user account for which they were created. A token provides the same level of access & privileges that its associated Bounce user account would have.
Please be sure to keep your API access tokens secure!
Do not share them in emails, chat messages, client-side code or publicly accessible sites.
If you have accidentally shared an API access token publicly, you can revoke it in the Developer Settings of your Bounce user account.
For API endpoints that can be called without an authentication token, such as from frontend applications, a list of trusted origins can be provided to limit the risk of unauthorized access. A public key must still be provided for billing, tracking and rate limiting purposes.
Different types of API methods are subject to different rate limits.
The response's HTTP headers are the authoritative source for the current number of API calls available to you or your app at any given time. The returned HTTP headers of any API request show your current rate limit status, as described below.
X-RateLimit-Limit
The maximum number of requests you're permitted to make in the current rate limit window.
X-RateLimit-Remaining
The number of requests remaining in the current rate limit window.
X-RateLimit-Reset
If you exceed the rate limit, an API error response is returned:
The Bounce API is currently only available in a production environment.
Mock APIs for testing and development will be available soon.
To review the documentation for each Bounce service, follow the links below:
The time at which the current rate limit window resets in .