List Sessions

GET

users

sessions

List Sessions

curl --request GET \
  --url https://api.vertracloud.app/v1/users/me/sessions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/users/me/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/me/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": [
    {
      "id": "session-abc123",
      "user_id": "user-123456789012345678",
      "provider": "email",
      "ip_address": "203.0.113.10",
      "location": "Fortaleza, BR",
      "device": "Chrome on macOS",
      "expires_at": "2026-10-20T15:00:00.000Z",
      "created_at": "2026-09-20T15:00:00.000Z",
      "updated_at": "2026-09-21T09:00:00.000Z",
      "is_current": true
    }
  ]
}

Response

array

An array of active sessions.

Show Toggle object

string

The session ID.

string

The owning user’s ID.

string

How the session was created (e.g. email, google, github).

string | null

The IP address the session was created from, if known.

string | null

A coarse location derived from the IP, if known.

string | null

A description of the device/browser, if known.

string

When the session expires.

string

When the session was created.

string

When the session was last used.

boolean

Whether this is the session tied to the credential making the current request.

{
  "response": [
    {
      "id": "session-abc123",
      "user_id": "user-123456789012345678",
      "provider": "email",
      "ip_address": "203.0.113.10",
      "location": "Fortaleza, BR",
      "device": "Chrome on macOS",
      "expires_at": "2026-10-20T15:00:00.000Z",
      "created_at": "2026-09-20T15:00:00.000Z",
      "updated_at": "2026-09-21T09:00:00.000Z",
      "is_current": true
    }
  ]
}

Error Responses

string

The error code indicating the reason for failure. Possible values:

AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: The Authorization header is missing, the API key is invalid, or the dashboard session was revoked (401).
API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: The API key is used from an IP outside its allowlist, or it lacks the scope the route requires (403).
USER_NOT_FOUND: The authenticated user was not found.
INTERNAL_SERVER_ERROR: An unexpected server error occurred.

{
  "code": "AUTH_TOKEN_MISSING"
}

Revoking a session is a dashboard-only action — it isn’t reachable with an API key.

Last modified on October 26, 2026

List Sessions

curl --request GET \
  --url https://api.vertracloud.app/v1/users/me/sessions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/users/me/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/me/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": [
    {
      "id": "session-abc123",
      "user_id": "user-123456789012345678",
      "provider": "email",
      "ip_address": "203.0.113.10",
      "location": "Fortaleza, BR",
      "device": "Chrome on macOS",
      "expires_at": "2026-10-20T15:00:00.000Z",
      "created_at": "2026-09-20T15:00:00.000Z",
      "updated_at": "2026-09-21T09:00:00.000Z",
      "is_current": true
    }
  ]
}

Overview

Endpoints

Response

Error Responses

​Response

​Error Responses

Response

Error Responses