> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userorbit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Topic Subscription

> Check if the current subscriber is subscribed to a topic.

## Authentication

```bash theme={null}
Authorization: Bearer SUBSCRIBER_JWT_TOKEN
```

## Request Body

<ParamField body="id" type="string" required>
  Topic ID (UUID) to check subscription for
</ParamField>

## Response

<ResponseField name="data" type="object">
  Subscription status

  <Expandable title="properties">
    <ResponseField name="isSubscribed" type="boolean">True if subscribed, false otherwise</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://api.userorbit.com/v1/public/topics-subscriber.info' \
  --header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "id": "topic-uuid-123"
  }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.userorbit.com/v1/public/topics-subscriber.info', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${subscriberToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ id: topicId })
  });

  const { data } = await response.json();
  console.log(`Subscribed: ${data.isSubscribed}`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.userorbit.com/v1/public/topics-subscriber.info',
      headers={
          'Authorization': f'Bearer {subscriber_token}',
          'Content-Type': 'application/json'
      },
      json={'id': topic_id}
  )

  is_subscribed = response.json()['data']['isSubscribed']
  ```
</RequestExample>

<ResponseExample>
  ```json Response - Subscribed theme={null}
  {
    "data": {
      "isSubscribed": true
    }
  }
  ```

  ```json Response - Not Subscribed theme={null}
  {
    "data": {
      "isSubscribed": false
    }
  }
  ```
</ResponseExample>

## Use Cases

* **UI State**: Show subscribe/unsubscribe button correctly
* **Notification Settings**: Display user's subscription status

## Notes

* Returns false if not subscribed
* Requires valid subscriber authentication
* Team validation enforced