---
title: "List subscriptions for a contact"
method: GET
path: "/contacts/{contact_id}/subscriptions"
tags: ["Contacts", "Subscription Types"]
---

# List subscriptions for a contact

`GET /contacts/{contact_id}/subscriptions`

You can fetch a list of subscription types that are attached to a contact. These can be subscriptions that a user has 'opted-in' to or has 'opted-out' from, depending on the subscription type.
This will return a list of Subscription Type objects that the contact is associated with.

The data property will show a combined list of:

  1.Opt-out subscription types that the user has opted-out from.
  2.Opt-in subscription types that the user has opted-in to receiving.

**Note:** This endpoint only returns subscriptions where the contact has explicitly configured their preference. Subscriptions that are in the default state — where the contact has not made an explicit opt-in or opt-out choice — are not included in the response.

## Path parameters

- `contact_id` string, required

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

Successful

- SubscriptionTypeList — A list of subscription type objects.
  - `type` 'list' — The type of the object
  - `data` SubscriptionType[] — A list of subscription type objects associated with the workspace .
    - `type` string — The type of the object - subscription
    - `id` string — The unique identifier representing the subscription type.
    - `state` 'live' | 'draft' | 'archived' — The state of the subscription type.
    - `default_translation` Translation — A translation object contains the localised details of a subscription type.
      - `name` string — The localised name of the subscription type.
      - `description` string — The localised description of the subscription type.
      - `locale` string — The two character identifier for the language of the translation object.
    - `translations` Translation[] — An array of translations objects with the localised version of the subscription type in each available locale within your translation settings.
      - `name` string — The localised name of the subscription type.
      - `description` string — The localised description of the subscription type.
      - `locale` string — The two character identifier for the language of the translation object.
    - `consent_type` 'opt_out' | 'opt_in' — Describes the type of consent.
    - `content_types` string[] — The message types that this subscription supports - can contain `email` or `sms_message`.

## Other responses

- `401` — Unauthorized
- `404` — Contact not found

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)