---
title: How to Retrieve an Assumed Role Session
url: https://docs.vultr.com/platform/iam/roles/assumed-roles/how-to-retrieve-an-assumed-role-session
description: Retrieve details of a specific assumed role session in Vultr IAM. View the session status, associated role, expiry time, and credentials through the IAM API.
publish_date: 2026-03-24T19:52:33.226492Z
last_updated: 2026-04-28T15:34:42.474159Z
---

Retrieving an assumed role session allows you to check the session details, including its remaining duration, the role being assumed, and the conditions under which it was created. This is useful for monitoring active sessions and verifying session status.

This guide explains how to retrieve an assumed role session using the Vultr API.

Send a `GET` request to the [**Read Assumed Role Session** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-assumed-role-sessions) to retrieve the session details. Replace `{session-token}` with the session token returned when the role was assumed.

```console
$ curl "https://api.vultr.com/v2/assumed-roles/{session-token}" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"
```

The response contains the resource details.