Authentication

How to get authentication for our APIs

Introduction

Trinsic APIs require an account and authentication. We use the OAuth 2.0 Bearer Authentication scheme, meaning that all HTTP requests must be sent with the authentication key in the Authorization header.

The Credentials API and Wallet API rely on API keys. The Provider API relies on provider keys. The first step to retrieving either is to create an account in the Trinsic Studio.

API Keys

API keys are unique strings that correspond to (and identify) one specific organization belonging to your account. They can be retrieved by following these steps:

  1. Sign in to Trinsic Studio.
  2. Click on details under the organization for which you want the API key
  3. The organization's API key can be seen in (and copied from) a text box in the organization overview. This will always be available to the account owner.

To use the Credentials API or Wallet API directly, add a header to each request that reads as follows:

Authorization: Bearer <API key>

To use the service clients to access the Credentials API or Wallet API, instantiate the service clients with the API key. There are more specific instructions and examples on our Service Clients (SDKs) guide.

Provider Keys

Provider keys are unique strings that correspond to your account. They can be retrieved by following these steps:

  1. Sign in to Trinsic Studio.
  2. Click on the account dropdown in the top-right of the screen and select the Provider Keys link.
  3. Click the + NEW KEY button and enter a name for the key. Optionally, alter the expiration date and note it. Then click on the CREATE button.
Create Provider KeyCreate Provider Key

Create Provider Key

  1. Copy the key and store it somewhere securely. You will not be able to see this key once the slider is closed, so be sure to copy and store it.

To use the Provider API directly, add a header to each request that reads as follows:

Authorization: Bearer <provider key>

To use the service clients to access the Provider API, instantiate the service client with the provider key. There are more specific instructions and examples on our Service Clients (SDKs) guide.