# Get a thread subscription for the authenticated user

From **GitHub v3 REST API**.

`GET /notifications/threads/{thread_id}/subscription`

This checks to see if the current user is subscribed to a thread. You can also [get a repository subscription](https://docs.github.com/enterprise-server@3.0/rest/reference/activity#get-a-repository-subscription).

Note that subscriptions are only generated if a user is participating in a conversation--for example, they've replied to the thread, were **@mentioned**, or manually subscribe to a thread.

## Parameters

### `thread_id`

- Location: path
- Required: true
- Type: `integer`

thread_id parameter

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Thread Subscription

```json
{
  "created_at": "2012-10-06T21:34:12Z",
  "ignored": false,
  "reason": null,
  "subscribed": true,
  "thread_url": "https://api.github.com/notifications/threads/1",
  "url": "https://api.github.com/notifications/threads/1/subscription"
}
```

```json
{"description":"Thread Subscription","properties":{"created_at":{"example":"2012-10-06T21:34:12Z","format":"date-time","nullable":true,"type":"string"},"ignored":{"type":"boolean"},"reason":{"nullable":true,"type":"string"},"repository_url":{"example":"https://api.github.com/repos/1","format":"uri","type":"string"},"subscribed":{"example":true,"type":"boolean"},"thread_url":{"example":"https://api.github.com/notifications/threads/1","format":"uri","type":"string"},"url":{"example":"https://api.github.com/notifications/threads/1/subscription","format":"uri","type":"string"}},"required":["created_at","ignored","reason","url","subscribed"],"title":"Thread Subscription","type":"object"}
```

### `304`

Not modified

### `401`

Requires authentication

### `application/json`

- Type: `object`

Basic Error

```json
{"description":"Basic Error","properties":{"documentation_url":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}},"title":"Basic Error","type":"object"}
```

### `403`

Forbidden

### `application/json`

- Type: `object`

Basic Error

```json
{"description":"Basic Error","properties":{"documentation_url":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}},"title":"Basic Error","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/notifications/threads/{thread_id}/subscription
```