GET /auth/me
Generating System-Level JSON Web Token (JWT)
API Users will need to generate a JSON Web Token (JWT) to use for system-level authentication to the Dataset Exchange API. This JWT is required for generating time-limited Client Data Access (CDA) tokens.
To generate a System Level JWT you will need your App's Private Key. Your Private Key can be found in App dashboard in the MIG Console.

You can find our Python client library here for generating a System-Level JWT.
Node Gist for Generating a System-Level JWT:
C# Gist for Generating System-Level JWT
Generating Client Data Access (CDA) JSON Web Token (JWT)
Your system-level JWT should be used to access the GET and POST endpoints required to generate a scoped, time-limited Client Data Access (CDA) token.
- After generating a system-level JWT, you should call the
GET /apps/me/installations
endpoint. This endpoint will return a list of available Workspaces that have "connected" to or installed your App. You should use the Workspace ID and Workspace Key provided to you by the Campaign or Organization you're working with to determine theinstallationId
. - You will use the
installationId
to hit thePOST /auth/clientToken
endpoint and generate a Client Data Access Token for accessing the associated datasets. Client Data Access tokens are scoped to an individual Workspace and expires in 1 hour. - Done! You can submit and/or retrieve datasets using your CDA JWT.
Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc. All API requests must be made over HTTPS. See errors for examples and more information.
For more information on how you or your users can Connect to your App and where to find the Workspace ID and Workspace Key, please check out this guide!
Updated 29 days ago