To authenticate to our API, you will need to generate some API Keys in the Developers section of your Sargon account.
Depending on the type of application you create this will generate a
Client ID and for backend applications also a
You can create multiple sets of credentials to represent your client applications - e.g. Web, Mobile, Backend.
Once you have the credentials there are several ways to authenticate:
Client IDin the request as header
Your API keys provide access to sensitive information so be sure to keep them secure. DO NOT share any client secrets in publicly accessible areas such 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.
The Sargon API can be used in a broad variety of use cases and caters for different types of access and credentials. The API uses OAuth authorisation scopes to ensure secure access for the appropriate user and integration.
https://api.sargon.com/memberProvides 'member level' information and typically used for member-facing online experiences. For security, the API scope is restricted to access an individual member.
https://api.sargon.com/integrationProvides 'fund level' information and facilitates flexible integrations to analytics and operational software. Can only be requested using a backend client and Client Credentials grant.
To easily get started, you may want to use the Sargon node.js API client library:
npm install @sargon/api-client
Please read through the examples in our Developer Code Samples page in your account for more information.
Alternatively, you can hit the endpoints directly on
To authenticate, you will need to use your API Keys and make a request for a token from the Authorization (OAuth) server we've configured for your fund.
Then, you use the token as part of your HTTP Bearer Token Authorization. i.e. add the following request header:
Authorization: Bearer <token>