Create API Auth Token

POST/oauth/token

Authorization endpoint for gaining token used for API requests requiring bearerAuth.

You will be provided the required client_id and client_secret as part of onboarding.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl --request POST \  --url https://auth.mattr.global/oauth/token/ \  --header 'Content-Type: application/json' \  --data '{"client_id": "KWdv9qo9Vnl9rrCRB7sfGKFTp4uO09im",           "client_secret": "ztJe2GVpOb1_rUo9Vnl9rrCRB7sfGKFTp4uO0DOfLnA5FSz96wbrzgJMQ",           "audience": "https://learn.vii.au01.mattr.global",           "grant_type": "client_credentials"          }'

{  "access_token": "s2dgbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6s2dcaEROemRDf5gbRVEwTTVSVFE0TmtZME9UZzVNVEpDTlVJNFJqRTBPREExTmpZMk1qazFPQSJ9",  "expires_in": 14400,  "token_type": "Bearer"}

POST/oauth/token

Authorization endpoint for gaining token used for API requests requiring bearerAuth.

You will be provided the required client_id and client_secret as part of onboarding.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

client_id*string

Use the client_id value provided with your tenant details, or retrieved when you created a tenant on the Self Service Portal.

client_secret*string

Use the client_secret value provided with your tenant details, or retrieved when you created a tenant on the Self Service Portal.

audience*string

Use your tenant URL.

grant_type*string

Use client_credentials.

Response Body

`application/json`

curl --request POST \  --url https://auth.mattr.global/oauth/token/ \  --header 'Content-Type: application/json' \  --data '{"client_id": "KWdv9qo9Vnl9rrCRB7sfGKFTp4uO09im",           "client_secret": "ztJe2GVpOb1_rUo9Vnl9rrCRB7sfGKFTp4uO0DOfLnA5FSz96wbrzgJMQ",           "audience": "https://learn.vii.au01.mattr.global",           "grant_type": "client_credentials"          }'

{  "access_token": "s2dgbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6s2dcaEROemRDf5gbRVEwTTVSVFE0TmtZME9UZzVNVEpDTlVJNFJqRTBPREExTmpZMk1qazFPQSJ9",  "expires_in": 14400,  "token_type": "Bearer"}

Create API Auth Token

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

Create API Auth Token

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

Request Body

Response Body

`application/json`

`application/json`

Request Body

Response Body

`application/json`

`application/json`