account.listSessions

GET

/v1/account/sessions

import { Client, Orvano } from '@orvano/js'

const orvano = new Orvano(new Client({ endpoint: 'https://orvano.example.com' }))

const sessionPage = await orvano.account.listSessions()
console.log(sessionPage)

// app/page.tsx, a server component. Route handlers and server actions use createServerClient too.
import { cookies } from 'next/headers'
import { createServerClient } from '@orvano/nextjs'

export default async function Page() {
  const orvano = createServerClient({
    endpoint: process.env.ORVANO_ENDPOINT!,
    cookies: await cookies(),
  })
  const sessionPage = await orvano.account.listSessions()
  return <pre>{JSON.stringify(sessionPage, null, 2)}</pre>
}

import 'package:orvano_flutter/orvano_flutter.dart';

Future<void> main() async {
  final orvano = Orvano(Client(endpoint: 'https://orvano.example.com'));
  final sessionPage = await orvano.account.listSessions();
  print(sessionPage.toJson());
}

Lists the signed in user’s active sessions, newest first.

Client SDKs: JavaScript in the browser, Next.js, and Flutter call it for the signed in user, or with no credential. A failure answers with a problem details body; its code has a page under Errors.

Authorizations

bearer

Parameters

Query Parameters

cursor

string

The nextCursor of the previous page.

limit

integer format: int32

Sessions per page, 1 to 100. Defaults to 25.

Responses

200

The request has succeeded.

application/json

One page of a user’s active sessions, newest first.

object

items

required

The sessions on this page.

Array<object>

An active session of a user: one signed in device or browser.

object

required

The session ID.

string

createdAt

required

When the user signed in.

string format: date-time

lastRefreshedAt

required

When the session last traded its refresh token.

string format: date-time

userAgent

required

Any of:

string
null

string

sdk

required

Any of:

string
null

string

ipAddress

required

Any of:

string
null

string

current

required

Whether this is the session making the call.

boolean

method

required

How the session began.

string

Allowed values: password sign_up magic_link email_code recovery

nextCursor

required

Any of:

string
null

string

Example

{
  "items": [
    {
      "id": "01924f5e-9a1b-7c4d-8e21-3d5e6f7a8b9c",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
      "sdk": "orvano-js/0.1.0",
      "ipAddress": "203.0.113.7",
      "current": true,
      "method": "password"
    }
  ]
}

default

An unexpected error response.

application/problem+json

An RFC 9457 problem details body. Every operation declares it as its default response, sent as application/problem+json.

object

type

required

Identifies the error: https://orvano.dev/errors/<code>.

string

title

required

The standard HTTP reason phrase for the status.

string

status

required

The HTTP status code.

integer format: int32

detail

A short, safe sentence about this occurrence, when the server has one.

string

code

required

Orvano’s stable error code, from the ErrorCode catalog. SDKs treat it as a plain string.

string

requestId

required

The request ID to quote when reporting a problem; also sent as X-Request-Id.

string

Example

{
  "type": "https://orvano.dev/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "code": "not_found",
  "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"
}