> For the complete documentation index, see [llms.txt](https://docs.uqudo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uqudo.com/docs/kyc/uqudo-api/authorisation.md).

# Authorisation API

You can download the full swagger specification in JSON format below:

{% file src="/files/L0moFIn9O9Xy8K0uK5O3" %}

You can download the full swagger specification in YAML format below:

{% file src="/files/eSYWJomFslzPzxpvgR5s" %}

Retrieve the authorization token using oauth2 client credentials grant type. You can obtain your client credentials by navigating to the "[Credentials](https://portal.uqudo.com/credentials)" tab located in the "Development" section of our [Uqudo Customer Portal](/docs/kyc/readme/customer-portal.md)

**Note:** Don’t perform this operation inside your mobile application but only from your backend

<mark style="color:green;">`POST`</mark> `https://auth.uqudo.io/api/oauth/token`

Get the access token to use the uqudo SDK and the uqudo API.&#x20;

**Note**: The content type of the request is **application/x-www-form-urlencoded**

#### Request Body

| Name                                             | Type   | Description                                 |
| ------------------------------------------------ | ------ | ------------------------------------------- |
| grant\_type<mark style="color:red;">\*</mark>    | String | Use the fixed value **client\_credentials** |
| client\_id<mark style="color:red;">\*</mark>     | String | Provided client id                          |
| client\_secret<mark style="color:red;">\*</mark> | String | Provided client secret                      |

{% tabs %}
{% tab title="200: OK Content type: application/json" %}

```javascript
{
  "access_token": "JWS authorization token",
  "token_type": "bearer",
  "expires_in": 1800,
  "scope": "scopes",
  "jti": "30a622fd-11aa-464a-8eaf-6fa868540cb0"
}
```

{% endtab %}

{% tab title="401: Unauthorized Invalid client id or client secret" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}