> 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/002_company/007_b2c_subscriptions/001__list_b2c_subscriptions_as_company.md).

# List B2C Subscriptions (Company)

GraphQL endpoint: `/company`

Lists all active B2C subscriptions for the authenticated company. B2C subscriptions represent users who have opted in to receive communications from the company via email, SMS, or voice. You can filter by user, topic (included or excluded), expiration date, and subscription types. Results are paginated via limit and cursor.

## 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-000000000001"
          },
          "email": "test4@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000004",
          "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-000000000005"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000001"
          },
          "email": "test5@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000006",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_3",
            "topic_2"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000007"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000001"
          },
          "email": "test6@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000008",
          "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-000000000009"
          }
        },
        {
          "company": {
            "id": "00000000-0000-4000-8000-000000000001"
          },
          "email": "test7@email.com",
          "expirationDate": null,
          "id": "00000000-0000-4000-8000-000000000010",
          "insertedAt": "2026-01-15T09:00:00",
          "notificationEndTime": "20:00:00",
          "notificationStartTime": "08:00:00",
          "subscriptionTopics": [
            "topic_3",
            "topic_2"
          ],
          "type": "EMAIL",
          "updatedAt": "2026-01-15T09:00:00",
          "user": {
            "id": "00000000-0000-4000-8000-000000000011"
          }
        }
      ]
    }
  }
}
```