---
title: "Refresh token"
method: POST
path: "/v1/refresh-token"
tags: ["Authentication"]
---

# Refresh token

`POST /v1/refresh-token`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/refresh-token`
- Auth: none declared

Returns an access token for this API using a refresh token. The refresh token enables you to get a new access token (when it is expired) without needing the Client ID and Client Secret. To get the access token, you need to send the refresh token in the payload. You can obtain the refresh token from the `/v1/issue-token` endpoint.

## Request body

- RefreshToken
  - `refreshToken` string, required: Refresh token. You can obtain a refresh token from the `/v1/issue-token` endpoint

## Response `200`

Successful operation

- Token
  - `otherClaims` object
  - `accessToken` string: Access token
  - `expiresIn` integer: Seconds until access token expiration
  - `refreshExpiresIn` integer: Seconds until refresh token expiration
  - `refreshToken` string: Refresh token
  - `tokenType` string: Token type
  - `idToken` integer, nullable
  - `notBeforePolicy` integer: Timestamp before which the token is not valid
  - `sessionState` string

## Other responses

- `400`: Bad request
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)