---
title: "Gets the current pushers for the authenticated user"
method: GET
path: "/_matrix/client/v3/pushers"
tags: ["Push notifications"]
---

# Gets the current pushers for the authenticated user

`GET /_matrix/client/v3/pushers`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/pushers`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/pushers/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets all currently active pushers for the authenticated user.

## Response `200`

The pushers for this user.

- object
  - `pushers` object[]: An array containing the current pushers for the user
    - `app_display_name` string, required: A string that will allow the user to identify what application owns this pusher.
    - `app_id` string, required: This is a reverse-DNS style identifier for the application. Max length, 64 chars.
    - `data` object, required: A dictionary of information for the pusher implementation itself.
      - `format` string: The format to use when sending notifications to the Push Gateway.
      - `url` string, uri: Required if `kind` is `http`. The URL to use to send notifications to.
    - `device_display_name` string, required: A string that will allow the user to identify what device owns this pusher.
    - `kind` string, required: The kind of pusher. `"http"` is a pusher that sends HTTP pokes.
    - `lang` string, required: The preferred language for receiving notifications (e.g. 'en' or 'en-US')
    - `profile_tag` string: This string determines which set of device specific rules this pusher executes.
    - `pushkey` string, required: This is a unique identifier for this pusher. See `/set` for more detail. Max length, 512 bytes.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)