---
title: "List Contact Topic Opt-outs"
method: GET
path: "/contacts/{contact_id}/unsubscribed_topics"
tags: ["Contacts::UnsubscribedTopic"]
---

# List Contact Topic Opt-outs

`GET /contacts/{contact_id}/unsubscribed_topics`

## Request

- Base URL: `https://myworkspace.myclickfunnels.com/api/v2`
- URL: `https://myworkspace.myclickfunnels.com/api/v2/contacts/{contact_id}/unsubscribed_topics`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts.myclickfunnels.com/oauth/authorize`
    - Token URL: `https://accounts.myclickfunnels.com/oauth/token`
- TypeScript: <https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/contacts/:contact_id/unsubscribed_topics/get.ts> (a function with typed inputs; its response is checked against the schema)

List one row per topic the contact has opted out of, including archived topics with existing opt-outs. Subscribed topics are the workspace's active topics minus these rows. The contact's unsubscribed_at is the separate all-email flag and can be set with no topic rows.

## Path parameters

- `contact_id` string, required

## Query parameters

- `after` string
- `per_page` integer
- `sort_order` 'asc' | 'desc'
- `sort_property` 'id' | 'updated_at'
- `filter` object
  - `id` string: Comma-separated numeric id values.
  - `contact_id` string: Comma-separated numeric contact_id values.
  - `topic_id` string: Comma-separated numeric topic_id values.

## Response `200`

OK

- ContactsUnsubscribedTopicAttributes[]
  - `id` integer
  - `public_id` string
  - `contact_id` integer
  - `topic` object
    - `id` integer
    - `public_id` string
    - `name` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — this request's workspace is closed to it. Three cases return this: * The access token is limited to specific workspaces (see the workspace selection made when the key was provisioned, or the workspaces approved on the OAuth consent screen) and the request acts on a workspace outside that set. * The access token is limited to specific workspaces and the request's workspace could not be determined at all. The gate is fail-closed, so a workspace-limited token is denied rather than allowed through when the target workspace is ambiguous. * The workspace's team has no active ClickFunnels subscription: it was canceled, is paused, or is locked out after failed payments. Reads and writes are both refused until the subscription is reactivated, and the body carries `"code": "subscription_inactive"`. A token with no workspace restriction never receives the first two.
- `404`: Not Found
- `422`: Unprocessable Entity - `per_page` must be a positive integer.

## Changes

- **2026-11-03** `511d88b30aea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/changes/contacts/:contact_id/unsubscribed_topics/get.md)

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) - [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/revisions/511d88b30aea?raw)