# 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"

  }

}
```