List sessions

GET /api/v1/sessions

Sessions in the selected organization, visible to every member of it, newest first, with cursor pagination. The organization is chosen by the X-Organization-Id header, or the organization the API key is bound to, otherwise the caller's default organization.

Query parameters

Name	Type	Required	Description
limit	integer	no	Maximum sessions to return (default 100, max 500)
before	string	no	Cursor: return sessions created strictly before this RFC3339 timestamp

Header parameters

Name	Type	Required	Description
X-Organization-Id	integer	no	Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Example request

curl https://api.mobilenexthq.com/api/v1/sessions \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Responses

200 — Paginated list of sessions

{
  "sessions": [
    {
      "sessionId": "string",
      "organizationId": 0,
      "userId": "string",
      "device": {
        "deviceId": "string",
        "platform": "ios",
        "type": "string",
        "name": "string",
        "osVersion": "string"
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "releasedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}

400 — Invalid request body

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

401 — Missing or invalid Bearer token

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

403 — Caller lacks permission for this action (e.g. not an admin)

{
  "error": {
    "code": "string",
    "message": "string"
  }
}