---
title: "Fetch User object subscriptions"
method: GET
path: "/v1/user/{distinct_id}/subscribed_to/object/"
---

# Fetch User object subscriptions

`GET /v1/user/{distinct_id}/subscribed_to/object/`

API to fetch all objects that a given user is subscribed to.

## Path parameters

- `distinct_id` string, required

## Query parameters

- `limit` integer

## Response `200`

200

- object
  - `meta` object — Metadata related to pagination.
    - `count` integer — Total number of results.
    - `limit` integer — The maximum number of results per request.
    - `has_prev` boolean — Indicates if there are previous results.
    - `before` string, nullable — Cursor for fetching previous results.
    - `has_next` boolean — Indicates if there are more results available.
    - `after` string, nullable — Cursor for fetching next results.
  - `results` object[] — List of retrieved results.
    - `properties` object — Object subscription property referred as `$recipient.subscription.<prop>` in templates or workflows.
    - `object` object — Details of the subscribed object.
      - `id` string — Unique identifier for the object.
      - `object_type` string — Type of object.
      - `properties` object — Additional properties related to the object.
      - `subscriptions_count` integer — Number of active subscriptions associated with the object.
      - `updated_at` string, date-time — Timestamp when the object was last updated.
    - `created_at` string, date-time — Timestamp when the result was created.
    - `updated_at` string, date-time — Timestamp when the result was last updated.

## Other responses

- `404` — 404 - Not Found

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)