> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/001_user/009_subscriptions/003__list_b2c_subscriptions_as_user.md).

# List B2C Subscriptions (User)

GraphQL endpoint: `/user`

Lists the B2C subscriptions of the authenticated user. B2C subscriptions represent the user's consent to receive communications from companies via email, SMS, or voice. Results can be filtered by company, topic, expiration date, and subscription types, and are paginated with a limit and cursor. Each record includes topics and contact info.

## Query

```graphql
query (
  $userId: ID
  $companyId: ID
  $includedTopic: String
  $excludedTopic: String
  $expirationDateBefore: Date
  $expirationDateAfter: Date
  $types: [B2cSubscriptionType!]
  $limit: Int
  $cursor: String
) {
  b2cSubscriptions (
    userId: $userId
    companyId: $companyId
    includedTopic: $includedTopic
    excludedTopic: $excludedTopic
    expirationDateBefore: $expirationDateBefore
    expirationDateAfter: $expirationDateAfter
    types: $types
    limit: $limit
    cursor: $cursor
  ) {
    paginationInfo {
      limit
      nextCursor
    }

    records {
      ... on B2cEmailSubscription {
        id
        insertedAt
        updatedAt
        type
        subscriptionTopics
        expirationDate
        notificationStartTime
        notificationEndTime
        email
        company {
          id
        }
        user {
          id
        }
      }

      ... on B2cSmsSubscription {
        id
        insertedAt
        updatedAt
        type
        subscriptionTopics
        expirationDate
        notificationStartTime
        notificationEndTime
        telephoneNumber
        company {
          id
        }
        user {
          id
        }
      }

      ... on B2cVoiceSubscription {
        id
        insertedAt
        updatedAt
        type
        subscriptionTopics
        expirationDate
        notificationStartTime
        notificationEndTime
        telephoneNumber
        company {
          id
        }
        user {
          id
        }
      }
    }
  }
}

```

## Variables

```json
{}
```

## Response

```json
{
  "data": {
    "b2cSubscriptions": {
      "paginationInfo": {
        "limit": 20,
        "nextCursor": null
      },
      "records": [
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000001"
          },
          "email": "test1@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000002",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_2",
            "topic_3"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000003"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000004"
          },
          "email": "test4@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000005",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_5",
            "topic_6"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000003"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000006"
          },
          "email": "test7@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000007",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_8",
            "topic_9"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000003"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000008"
          },
          "email": "test10@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000009",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_11",
            "topic_12"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000003"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000010"
          },
          "email": "test13@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000011",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_14",
            "topic_15"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000003"
          }
        }
      ]
    }
  }
}
```
