> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plaud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication APIs

> Authenticate to Plaud APIs to connect (bind) devices to your mobile app and use the Transcription API

As a Plaud Partner on the developer platform, you will need two types of tokens to authenticate to Plaud Embedded:

1. **Partner Token** - This is an **application-level token** you can use to authenticate all of your users.
2. **User Token** - This is a **user-level token** used to authenticate their device to your mobile app using the [Embedded SDK](/plaud-embedded/ios-sdk).

## Using the Authentication API

### Prerequisites

Use Plaud's Authentication APIs to retrieve your Partner Token and User Token using your app's `client_id` and `client_secret` found in the [developer portal](https://portal.plaud.ai).

<Frame>
  <img src="https://mintcdn.com/plaud/E1lTvtruOMzEP-O1/assets/app-created.png?fit=max&auto=format&n=E1lTvtruOMzEP-O1&q=85&s=7ae9480fa729f0828e61d35c750d8ba3" alt="app credentials" width="1426" height="667" data-path="assets/app-created.png" />
</Frame>

<Tip>
  Try the [Plaud Embedded API Playground](https://plaud-embedded-playground.vercel.app/) to see every step of the transcription process with your own client credentials.

  End-to-end, from **authentication** to **recording audio** to **uploading** to **transcription**.

  <Frame>
    <img src="https://mintcdn.com/plaud/3HJ-zGIl_uprusCq/assets/playground-ss.png?fit=max&auto=format&n=3HJ-zGIl_uprusCq&q=85&s=2eff3616a9b3d0cfe5f1bf4902d260b1" width="1760" height="858" data-path="assets/playground-ss.png" />
  </Frame>
</Tip>

### Find Your Region

All partner endpoints — Authentication APIs and [Transcription APIs](/plaud-embedded/transcription-api-overview) — are served from Plaud's **regional** services. There is no global host for these calls; pick the host of the region your client was provisioned in when calling Plaud Embedded APIs.

| Region    | Public host                          | Status      |
| --------- | ------------------------------------ | ----------- |
| US        | `platform-us.plaud.ai/developer/api` | Available   |
| Japan     | `platform-jp.plaud.ai/developer/api` | Available   |
| Europe    | `platform-eu.plaud.ai/developer/api` | Coming soon |
| Singapore | `platform-sg.plaud.ai/developer/api` | Coming soon |

### Exchange Credentials for a Partner Token

The Partner Token is an application-level token to issue user-level tokens.

```http theme={"system"}
POST [REGION-SPECIFIC-HOST]/oauth/partner/access-token
Authorization: Basic base64(client_id:secret_key)
Content-Type: application/x-www-form-urlencoded
```

```json theme={"system"}
{
  "access_token": "eyJhbGciOiJSUz...",
  "refresh_token": "eyJhbGci...",
  "token_type": "bearer",
  "expires_in": 3600
}
```

### Mint a User Token with Your Partner Token

The User Token is a user-specific token. This token will be used in the [Embedded SDK](/plaud-embedded/ios-sdk) to bind to your users' devices and upload files.

```http theme={"system"}
POST [REGION-SPECIFIC-HOST]/open/partner/users/access-token
Authorization: Bearer <partner_access_token>
Content-Type: application/json

{
  "user_id": "<your stable user id, 6-120 chars>",
  "expires_in": 86400
}
```

```json theme={"system"}
{
  "access_token": "eyJhbGci...",
  "token_type": "bearer",
  "expires_in": 86400
}
```