THIS SITE IS UNDER CONSTRUCTION

Post - Refresh Session

Core Prod

https://api-core.deriv.com/v1

POST

/refresh-session

Last modified:2025-07-15 02:43:35

The primary goal is to allow clients to provide their refresh token and, in return, receive a new session token. This functionality enables users to maintain prolonged sessions without having to log in each time their access token expires.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-core.deriv.com/v1/refresh-session' \
--header 'Content-Type: application/json' \
--data-raw '{
    "refresh_token": "<refresh_token>"
}'

Response Example

200 - Success

{
    "data": [
        {
            "access_token": "<access_token>",
            "token_type": "bearer",
            "expires_in": 86400,
            "expires_at": 1752627917,
            "refresh_token": "<refresh_token>",
            "user": {
                "id": "b728a100-5570-4f54-96c7-2dbdf7ddd30c",
                "aud": "authenticated",
                "role": "authenticated",
                "email": "vimalan.rajakumar+b1@regentmarkets.com",
                "email_confirmed_at": "2025-07-08T00:55:45.48036Z",
                "phone": "",
                "confirmation_sent_at": "2025-07-08T00:55:26.073465Z",
                "confirmed_at": "2025-07-08T00:55:45.48036Z",
                "recovery_sent_at": "2025-07-14T08:54:50.769773Z",
                "last_sign_in_at": "2025-07-14T08:57:37.645919Z",
                "app_metadata": {
                    "provider": "email",
                    "providers": [
                        "email"
                    ]
                },
                "user_metadata": {
                    "email": "vimalan.rajakumar+b1@regentmarkets.com",
                    "email_verified": true,
                    "phone_verified": false,
                    "sub": "b728a100-5570-4f54-96c7-2dbdf7ddd30c"
                },
                "identities": [
                    {
                        "identity_id": "f31340b8-3791-4ed5-aa62-13d55c3016f4",
                        "id": "b728a100-5570-4f54-96c7-2dbdf7ddd30c",
                        "user_id": "b728a100-5570-4f54-96c7-2dbdf7ddd30c",
                        "identity_data": {
                            "email": "vimalan.rajakumar+b1@regentmarkets.com",
                            "email_verified": true,
                            "phone_verified": false,
                            "sub": "b728a100-5570-4f54-96c7-2dbdf7ddd30c"
                        },
                        "provider": "email",
                        "last_sign_in_at": "2025-07-08T00:55:26.069708Z",
                        "created_at": "2025-07-08T00:55:26.069756Z",
                        "updated_at": "2025-07-08T00:55:26.069756Z",
                        "email": "vimalan.rajakumar+b1@regentmarkets.com"
                    }
                ],
                "created_at": "2025-07-08T00:55:26.065842Z",
                "updated_at": "2025-07-14T08:57:37.648383Z",
                "is_anonymous": false
            }
        }
    ]
}

Request

Body Params application/json

refresh_token

string

required

Examples

Responses

🟢200OK

application/json

Body

data

array [object {6}]

optional

Array containing new session and user information.

access_token

string

optional

JWT access token for the session.

token_type

string

optional

Type of the access token (usually 'bearer').

expires_in

integer

optional

Number of seconds until the access token expires.

expires_at

integer

optional

Epoch timestamp when the access token will expire.

refresh_token

string

optional

Refresh token to obtain a new access token.

user

object

optional

Authenticated user's profile and metadata.

🟠400Bad Request

Modified at 2025-07-15 02:43:35

Config