Ambition's Public API provides customers with access to their Account, Group, Score, and Coaching data.
Score data includes Activity and Objective Score values for individuals, managers, and groups. For individuals and managers, the individual's/manager's username will be provided as the EntityID. For groups, the Group ID will be provided. The Group API can then be used to associate the Group ID with a Group's name.
Coaching data includes Action Plans, Action Items, Programs, Program Templates, Managed Programs, Check-Ins, and Check-In Templates.
Where can I view API documentation?
How do I locate the API credentials?
What API throttling policies are in place?
How to construct the HTTP request?
View API documentation
Documentation can be found at
Replace SUBDOMAIN with the respective subdomain of your organization's Ambition instance.
An OpenAPI 3.0 schema file can be downloaded:
- at the top of the documentation page by clicking /api/v2/schema/
- at the bottom of this article
Example of Coaching Rating Documentation
Locate API Credentials
A token can be obtained in any existing API Integration in Ambition through the Credentials tab.
User-level credentials can also be created in your administrative settings.
1. Open the left navigation and click on Administration > Data > Standard API Token Management.
2. From the Token Management page, click Add New Token.
3. Name the Token and click Create New Token.
4. After the token has been created, copy the token to save for reference.
You will not be able to access this token again.
The Scores endpoints will enforce a throttling limit of 30 calls per minute, per API, with a max of 1000 calls per day, per API.
ex. 30 calls, per minute with no more than 1000 calls for Activity Score and 30 calls, per minute with with no more than 1000 calls for Objective Score.
A throttled response will have the status code
429 and the content will contain the message, "Too Many Requests".
Construct HTTP Request
You will need to construct a request consisting of three parts: Authorization Header, Content Type Header, and Body (if applicable).
AUTH_TOKEN is the token from
Standard API Token Management or an API Integration.
Authorization: Token AUTH_TOKEN
Content-Type will vary based on the endpoint and action.
Content Type Header
||JSON||JSON Formatted Data|
||CSV||CSV Formatted Data|
||CSV||Excel Formatted Data|
The body will consist of either JSON or CSV data, dependent on selected
Refer to the "How do I construct data for an API integration?" for constructing the body's data.
cURL to list accounts in Ambition.
curl \ -H "Authorization: Token AUTH_TOKEN" \ -H "Content-Type: application/json" \ https://SUBDOMAIN.ambition.com/api/v2/account
Please sign in to leave a comment.