Obtain Authentication Token

POST /v2/auth/token

This endpoint allows obtaining an Access Token required to authorize all subsequent requests to the API.

---

Request parameters (body)

Parameter	Type	Required	Description
clientId	string (guid)	Yes	Client code provided by maib
clientSecret	string (guid)	Yes	The client’s secret key, provided by maib

Example request (body)

{
  "clientId": "749c564f-1a65-48e3-a4bf-b7932b6ae3db",
  "clientSecret": "0d922db8-9a2f-4c66-a60d-76a762c9bb04"
}

---

Response parameters

Field	Type	Description
result.accessToken	string	The access token to be used in the Authorization header
result.expiresIn	integer	The token's lifespan, in seconds
result.tokenType	string	The token type (Bearer)
ok	boolean	true if the request was successfully processed
errors	array	List of errors, if ok = false

Example response

{
  "result": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresIn": 300,
    "tokenType": "Bearer"
  },
  "ok": true
}

---

After obtaining the token, it must be included in the header of every request to the API.