Skip to content

List my sessions

GET
/account/sessions

Lists the signed-in sessions on your account, most recently used first, so you can spot a device you don’t recognise and end it with DELETE /account/sessions/{id}.

The session you’re using is marked current: true, but only when you call this with the session cookie. A session unused for more than 30 minutes no longer works, but it can still appear here: the server only tries to remove it when its cookie is next sent. Sessions an administrator started while impersonating you are listed too, with nothing marking them as such. The list isn’t paged and never includes IP addresses. API tokens aren’t sessions and aren’t listed here; see GET /auth/tokens.

In demo mode (AA_DEMO_MODE), where every visitor shares one account, you only see the session making the request, and with an API token you see none.

Your signed-in sessions.

object
items
required
Array<object>

One signed-in session. user_agent is the User-Agent header from the request that started the session, and is left out when there wasn’t one.

object
id
required
string format: uuid
created_at
required
string format: date-time
last_used_at
required

When a request last used the session. A session unused for more than 30 minutes stops working.

string format: date-time
expires_at

When the session ends no matter how it’s used. Ordinary sign-ins have no fixed end, so it’s left out; impersonation sessions end 30 minutes after they start.

string format: date-time
nullable
ip

The IP address the session was started from: the first entry in X-Forwarded-For when there is one, otherwise the connection’s address. The client can set that header, and a value that isn’t a valid address isn’t recorded. Only GET /admin/users/{ref}/sessions returns it, and only if you have users.pii.read as well as users.read (system.admin also works). It’s left out otherwise, and also when no address was recorded, so a missing ip doesn’t tell you which.

string
nullable
user_agent
string
nullable
current

true on the session making this request. Only GET /account/sessions sets it, and only when you call it with the session cookie; otherwise it’s left out.

boolean

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}