---
title: "Get signaling messages"
method: GET
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/signaling/{token}"
tags: ["internal_signaling"]
---

# Get signaling messages

`GET /ocs/v2.php/apps/spreed/api/{apiVersion}/signaling/{token}`

## Path parameters

- `apiVersion` 'v3', required
- `token` string, required

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

Signaling messages returned

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` object[], required
      - `type` string, required
      - `data` union, required
        - SignalingSession[]
          - `actorId` string, required — The unique identifier for the given actor type
          - `actorType` string, required — Actor type of the attendee (see [Constants - Attendee types](https://nextcloud-talk.readthedocs.io/en/latest/constants#attendee-types))
          - `inCall` integer, required — Call flags the user joined with (see [constants list](https://nextcloud-talk.readthedocs.io/en/latest/constants#participant-in-call-flag))
          - `lastPing` integer, required — Timestamp of the last ping of the user
          - `participantPermissions` integer, required — Combined final permissions for the participant (see [constants list](https://nextcloud-talk.readthedocs.io/en/latest/constants#attendee-permissions))
          - `roomId` integer, required — Identifier of the conversation
          - `sessionId` string, required — up to 512 character long string
          - `userId` string, required — User id of the participant (empty for guests)
        - string

## Other responses

- `400` — Getting signaling messages is not possible
- `404` — Session, room or participant not found
- `409` — Session killed

---

[API](https://skmtc.dev/nextcloud/apis/spreed-full.md) · [All operations](https://skmtc.dev/nextcloud/apis/spreed-full/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/spreed-full/revisions/41d6458d6d6e/schema)