# Auth

This API allows you to request authentication tokens. You can also use it to generate secure URLs that are used in granting customer access to the Tilia services.

Version: 1.0.0
License: Tilia, Inc.

## Servers

```
https://auth.staging.tilia-inc.com
```

## Security

### tilia_auth

Type: oauth2

## Download OpenAPI description

[Auth](https://thunes-tilia-docs.redocly.app/_bundle/openapi/prod/auth/openapi.yaml)

## Other

### Request access token

 - [POST /token](https://thunes-tilia-docs.redocly.app/openapi/prod/auth/openapi/other/gettoken.md): An Access Token is a string that enables Tilia to verify that a request belongs to an authorized session. Requesting an access token requires the client ID and secret you obtained when registering as a Tilia integrator. The returned token can then be used to to make API calls.

### Request client redirect URL or password token

 - [POST /authorize/user](https://thunes-tilia-docs.redocly.app/openapi/prod/auth/openapi/other/authorizeuserhandler.md): By default, generates a temporary page that allows a user to visit and have a browser session set.
This is typically the first step in directing the user to a Tilia web UI, such as those presented in the payments or payouts flows.
After calling this endpoint, redirect the client's browser to the URL in the response payload. More info about the web UI can be found here.

Alternatively, if return_token is set to true, the response payload will contain the key token whose value is a password token string that can be passed directly to other API calls. This is useful for clients that are not browser-based.