---
title: "List registered real-time queries"
method: GET
path: "/1/websocket/fetch"
tags: ["Websocket"]
---

# List registered real-time queries

`GET /1/websocket/fetch`

Returns every active WebSocket query registration of the API key (`totalQueries` carries the count), each with its `registration_id`, the query parameters it was registered with (parameter names in lowercase), and `active_clients` — the number of devices currently connected to the stream for it. Available on plans with WebSocket access.

The API key must be sent as the `apikey` query parameter — the `X-ACCESS-KEY` header is not supported on this endpoint. Consumes no API credits.

## Query parameters

- `apikey` string, required

## Response `200`

Success.

- WebsocketQueryListEnvelope — The API key's active WebSocket query registrations.
  - `status` 'success', required
  - `totalQueries` integer, required — Number of active registrations for this API key.
  - `results` object, required
    - `queries` object[], required
      - `registration_id` string, required — Identifier of the registered query (32 characters).
      - `active_clients` integer, required — Number of devices currently connected to the stream for this registration.
      - `query` object, required — The query parameters the registration was created with, as name/value pairs (parameter names in lowercase; comma-separated filters appear as arrays).

## Other responses

- `401` — Missing or invalid API key, or the request is not allowed for this key.
- `403` — Your plan does not include access to this endpoint or parameter.
- `429` — Too many requests in a short period, rate limit exceeded, or API credits exhausted.
- `500` — Unexpected server error. Please try again later.
- `503` — The endpoint is temporarily unavailable due to maintenance.

## Changes

- **2026-08-20** `ece1fd088c73` — 12 info
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `401` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `403` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `429` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `500` status
  - …8 more
- **2026-08-13** `692a9e161b3f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/newsdata/apis/newsdata-io-api/changes/1/websocket/fetch/get.md)

---

[API](https://skmtc.dev/newsdata/apis/newsdata-io-api.md) · [All operations](https://skmtc.dev/newsdata/apis/newsdata-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newsdata/newsdata-io-api/revisions/ece1fd088c73/schema)