---
title: "Refresh access token"
url: https://docs.truemarkets.co/api/auth/refresh-token
description: "Exchange a valid refresh token for a new access/refresh token pair"
---

Docs index: https://docs.truemarkets.co/llms.txt

# Refresh access token

Exchange a valid refresh token for a new access/refresh token pair

## Request

```
POST https://api.truemarkets.co/v1/auth/token/refresh
```

### Body

`application/json`, required

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `refresh_token` | string | yes | The refresh token to exchange |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Tokens refreshed successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `access_token` | string | yes | JWT access token |
| `refresh_token` | string | yes | JWT refresh token |
| `expires_in` | string (date-time) | yes | Access token expiration timestamp |
| `token_type` | string | yes | Token type (always "Bearer") |
| `device_token` | string | no | Marks this client as signed in to the inbox by email; send it back as `X-Device-Token`. Present only on an email sign-in. |
| `turnkey_session` | object | no | A Turnkey session on the public key a provider sign-in sent. Absent when none was asked for or none could be issued. |
| `turnkey_session.expires_at` | integer (int64) | yes | Session expiry, unix seconds |

### 400

Invalid request body or missing refresh token

### 401

Invalid or expired refresh token

### 403

An operator has disabled the account, so no token is issued for it

### 500

Internal server error
