---
title: "Get a Realtime app"
method: GET
path: "/v1/realtime/apps/{realtime_app_id}"
tags: ["realtime-apps"]
---

# Get a Realtime app

`GET /v1/realtime/apps/{realtime_app_id}`

## Request

- Base URL: `https://us1.platform.bird.com`
- URL: `https://us1.platform.bird.com/v1/realtime/apps/{realtime_app_id}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `bird_session`

Returns a single Realtime app with its configuration and connection details (`app_id`, `region`). Key secrets are never included; use [List a Realtime app's keys](/docs/api/reference/list-realtime-app-keys) to manage them. Returns a `404 Not Found` error if the app does not exist in the workspace.

## Headers

- `X-Workspace-Id` string
- `X-Organization-Id` string

## Response `200`

Realtime app with its current configuration and status.

- RealtimeApp
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `client_events` boolean, required: Allow clients to trigger events directly (client events).
  - `connection_counting` boolean, required: Count the connections subscribed to each channel and expose the count on channel queries.
  - `connection_count_events` boolean, required: Broadcast connection-count events to public and private channel subscribers. Requires `connection_counting`. Presence channels do not emit these events; use a channel query to read their connection count.
  - `watchlist_events` boolean, required: Tell a signed-in member when the members on their watchlist come online or go offline. The watchlist is part of the identity your backend signs at signin.
  - `authorized_connections` boolean, required: Require every connection to be authorized.
  - `id` string, required
  - `app_id` integer, required: The numeric Realtime app id. Use it together with a key and secret to initialize a Realtime client/server SDK. Immutable.
  - `name` string, required: A label for the app, shown wherever it is listed.
  - `region` 'us1' | 'eu1', required: Deployment region identifier.
  - `status` 'active' | 'suspended', required: Lifecycle state of the app. `active` apps serve connections; `suspended` apps are provisioned but reject connections.

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `422`: The request has invalid field values, violates a business rule, or carries a query parameter the endpoint does not declare. Field validation errors use `type: validation_error` and include the affected fields in `details`. Business-rule errors identify the failed rule in `type`.
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/messagebird/apis/bird-api.md) · [All operations](https://skmtc.dev/messagebird/apis/bird-api/llms.txt) · [OpenAPI document](https://skmtc.dev/messagebird/apis/bird-api/revisions/6dfce1179799?raw)