# Sessions

## List sessions[​](#list-sessions "Direct link to 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

`limit`integer

Maximum sessions to return (default 100, max 500)

`before`string · date-time

Cursor: return sessions created strictly before this RFC3339 timestamp

Header parameters

`X-Organization-Id`string

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

`object`stringrequired

`data`arrayrequired

Show child attributes

`id`string · uuidrequired

The session's own id

`organization`stringrequired

Reference to the organization this session belongs to

`user`string · uuidrequired

Reference to the user who created this session

`device`objectrequired

Show child attributes

`id`stringrequired

The device's own id

`platform`stringrequired

`type`stringrequired

`name`stringrequired

`osVersion`stringrequired

`createdAt`string · date-timerequired

`releasedAt`string · date-timenullable

`nextCursor`stringnullable

Cursor for the next page; absent when there are no more results

Request

```
curl https://api.mobilenexthq.com/api/v1/sessions \

  -X GET \

  -H 'Authorization: Bearer mob_...'
```

Response

200400401403

Paginated list of sessions

```
{

  "object": "list",

  "data": [

    {

      "id": "string",

      "organization": "string",

      "user": "string",

      "device": {

        "id": "string",

        "platform": "ios",

        "type": "string",

        "name": "string",

        "osVersion": "string"

      },

      "createdAt": "2026-01-01T00:00:00Z",

      "releasedAt": "2026-01-01T00:00:00Z"

    }

  ],

  "nextCursor": "string"

}
```

## Get a session[​](#get-session "Direct link to Get a session")

GET/api/v1/sessions/{sessionId}

Returns a session in the selected organization, visible to every member of it. 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.

Path parameters

`sessionId`string · uuidrequired

Session UUID

Header parameters

`X-Organization-Id`string

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

`id`string · uuidrequired

The session's own id

`organization`stringrequired

Reference to the organization this session belongs to

`user`string · uuidrequired

Reference to the user who created this session

`device`objectrequired

Show child attributes

`id`stringrequired

The device's own id

`platform`stringrequired

`type`stringrequired

`name`stringrequired

`osVersion`stringrequired

`createdAt`string · date-timerequired

`releasedAt`string · date-timenullable

Request

```
curl https://api.mobilenexthq.com/api/v1/sessions/{sessionId} \

  -X GET \

  -H 'Authorization: Bearer mob_...'
```

Response

200401403404

Session detail

```
{

  "id": "string",

  "organization": "string",

  "user": "string",

  "device": {

    "id": "string",

    "platform": "ios",

    "type": "string",

    "name": "string",

    "osVersion": "string"

  },

  "createdAt": "2026-01-01T00:00:00Z",

  "releasedAt": "2026-01-01T00:00:00Z"

}
```