List Sessions

List all active sessions for the authenticated user, showing device and location information.

Endpoint

GET /v1/sessions

Base URL: https://api-id.avnology.net

Authentication: Required -- session token

Returns all active sessions for the authenticated user. Each session includes device info, IP address, location, and authentication methods. The current session is marked with is_current: true.

Request

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <session_token>`

Query Parameters

Parameter	Type	Required	Description
`page_size`	integer	No	Results per page (default: 25, max: 100)
`page_token`	string	No	Cursor for pagination

Example Request

curl "https://api-id.avnology.net/v1/sessions?page_size=10" \
  -H "Authorization: Bearer avnl_ses_a1b2c3d4..."

Response

Success (200 OK)

{
  "sessions": [
    {
      "id": "ses_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "device": { "browser": "Chrome", "os": "macOS", "device_type": "desktop" },
      "ip_address": "203.0.113.42",
      "location": { "country": "US", "city": "San Francisco"

Errors

Status	Code	Description
401	`AVNOLOGY_AUTH_005`	Invalid session token

Code Examples

JavaScript (fetch)

async function listSessions(sessionToken) {
  const response = await fetch('https://api-id.avnology.net/v1/sessions', {
    headers: { 'Authorization': `Bearer ${sessionToken}` },
  });
  return response.json();
}

Python (httpx)

import httpx

def list_sessions(session_token: str) -> dict:
    return httpx.get(
        "https://api-id.avnology.net/v1/sessions",
        headers={"Authorization": f"Bearer

Go (net/http)

func listSessions(ctx context.Context, sessionToken string) (*ListSessionsResponse, error) {
	req, _ := http.NewRequestWithContext(ctx,

Revoke Session -- revoke a specific session
Get Session -- get current session details
SDK: client.auth.listSessions() (TypeScript)

On this page