Skip to main content

Getting access

Introduction​

dMRV Connect uses Bearer tokens for authenticating API requests. Depending on your role as a Supplier or a dMRV Partner, the process for obtaining these tokens differs slightly.

Getting API Access as a Supplier​

For a direct integration by a Supplier, one needs to obtain an access token from Puro.earth. Initially, access tokens are provided directly by connecting with Puro.earth technical support. Self-service functionalities are planned for release later. This token will allow you to manage your data over the API.

Getting access as a dRMV Partner​

As a dMRV Partner, you will need a Partner Client Secret from Puro.earth before starting work on the integration. You will use this token to redeem Partner Access Tokens which are scoped for you to act on behalf of the Supplier through the API.

To test that your Partner Client Secret is working, try sending a POST request to the access-tokens endpoint without any body parameters. You should see a 400 error if the token is valid, and you will receive a 401 if it's not valid for redeeming Partner Access Tokens.

Create a partner access token
curl -X 'POST' "/v0/partners/auth/access-tokens" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $BEARER"