# Get channel events (/en/api-reference/api-ref/signaling/channel-events)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Retrieves Signaling channel join and leave events.

- OpenAPI: /openapi/rtm/signaling-rest.en.yaml
- Operation ID: get-channel-events
- Method: GET
- Path: /{appid}/rtm/vendor/channel_events

## Servers

- https://api.agora.io/dev/v2/project

## Parameters

- `appid` (path, required) - The App ID of your Agora project.

## Request body

No request body.

## Responses

### 200

The request was successful. The response body contains the result of the request.

- `result` (string) - The result of this request. `success` if it succeeds, `failed` if it fails.
No schema.
- `request_id` (string) - The unique ID of this request.
No schema.
- `events` (array) - An array of join and leave events.
  - `events.items` (object)
    - `events.items.group_id` (string) - The corresponding channel ID.
No schema.
    - `events.items.user_id` (string) - The corresponding user ID.
No schema.
    - `events.items.type` (string) - Event type: `Join` when a user has joined the channel, `Leave` when a user has left the channel.

The event type:

 - Join: A user has joined the channel.
 - Leave: A user has left the channel.
No schema.
    - `events.items.ms` (integer) - Number of milliseconds since January 1, 1970 (UTC) to the UTC time when the server receives the message.
No schema.
### default

The request failed. The response body includes the error code and description.

No schema.