---
title: "Get subscriptions for a person_key"
method: GET
path: "/companies/{company_key}/mobiledb/persons/{person_key}/subscriptions"
tags: ["Subscription API"]
---

# Get subscriptions for a person_key

`GET /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions`

## Request

- Base URL: `https://public-api.vibescm.com`
- URL: `https://public-api.vibescm.com/companies/{company_key}/mobiledb/persons/{person_key}/subscriptions`
- Auth: HTTP basic

## Path parameters

- `company_key` string, required
- `person_key` string, required

## Query parameters

- `active_only` boolean

## Headers

- `X-API-Version` string

## Response `200`

Successful response

- SubscriptionResponse[]
  - `person` object: Person reference information for the subscription.
    - `id` string: Vibes-unique person identifier.
    - `url` string: Reference URL to the person resource.
  - `subscription_list` object
    - `id` string: Vibes unique subscription list identifier.
    - `url` string: Reference URL to the subscription list resource.
  - `opt_in_date` string: Date string indicating when the subscription was entered in ISO-8601 format.
  - `opt_out_date` string: Date string indicating when the subscription was ended, if relevant, in ISO-8601 format.
  - `opt_out_reason` 'user_opt_out' | 'disconnect' | 'list_archived' | 'bulk_opt_out' | 'failed_at_carrier' | 'obsolete_carrier' | 'platform_opt_out' | 'keyword_opt_out' | 'api_opt_out' | 'button_opt_out': The reason why the person was opted-out, if relevant.
  - `url` string: A reference URL to the existing object, as a relative URL to the existing domain.

## Other responses

- `404`: The `person_key` cannot be located.

---

[API](https://skmtc.dev/vibes/apis/vibes-platform-api.md) - [All operations](https://skmtc.dev/vibes/apis/vibes-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vibes/apis/vibes-platform-api/revisions/e235838f2e50?raw)