The Troops Integration API allows you to query and manipulate the following resources within your TEA tree:
- Candidates and their related assets.
- Certain references:
- Business sectors
- Evolia syncing
The entire API is authenticated, so to use it you will require an API key. To
acquire one, please send a request to your account manager at Troops or to
When making requests, you need to specify the API key using the Bearer scheme in
the Authorizatoin header, e.g.
Authorization: Bearer this-is-my-secret-token.
Your API keys carry many privileges, so be sure to keep them secure! Do not
share your secret API keys in publicly accessible areas such as GitHub,
client-side code, and so forth.
All API requests must be made over HTTPS. Calls made over plain HTTP will fail.
API requests without authentication will also fail.
Some endpoints accept references to candidates in a flexible fashion, allowing
you to uniquely identify them even if you do not know their Troops UUID, e.g.
using their Evolia ID or SSN.
They can only be used when the resource can indeed be uniquely identified this
way, that is, when the scope is already that of a unique TEA, not the entire
The format is
evolia:12345 in case of an Evolia ID. The
following schemes are in use:
troops: Troops UUID
evolia: Evolia ID
ssn: French social security number
Some query parameters include nested objects, like the filter in the List
Candidates endpoint. This is encoded the following way in the URL: