# Get a repository subscription

From **GitHub v3 REST API**.

`GET /repos/{owner}/{repo}/subscription`

Get a repository subscription

## Parameters

### `owner`

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

### `repo`

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

## Responses

### `200`

if you subscribe to the repository

### `application/json`

- Type: `object`

Repository invitations let you manage who you collaborate with.

```json
{
  "created_at": "2012-10-06T21:34:12Z",
  "ignored": false,
  "reason": null,
  "repository_url": "https://api.github.com/repos/octocat/example",
  "subscribed": true,
  "url": "https://api.github.com/repos/octocat/example/subscription"
}
```

```json
{"description":"Repository invitations let you manage who you collaborate with.","properties":{"created_at":{"example":"2012-10-06T21:34:12Z","format":"date-time","type":"string"},"ignored":{"description":"Determines if all notifications should be blocked from this repository.","type":"boolean"},"reason":{"nullable":true,"type":"string"},"repository_url":{"example":"https://api.github.com/repos/octocat/example","format":"uri","type":"string"},"subscribed":{"description":"Determines if notifications should be received from this repository.","example":true,"type":"boolean"},"url":{"example":"https://api.github.com/repos/octocat/example/subscription","format":"uri","type":"string"}},"required":["created_at","ignored","reason","subscribed","url","repository_url"],"title":"Repository Invitation","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"}
```

### `404`

Not Found if you don't subscribe to the repository

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/subscription
```
