# Get your social notifications

`GET https://api.cryptohopper.com/v1/social/notifications`

Part of [Social](https://www.cryptohopper.com/api-documentation/api-reference/social.md) in the Cryptohopper API reference.

Returns the social notifications of the last 14 days for your profile, newest first: new followers, likes on your posts and comments, tournament messages and moderation notices. Reading them also clears your unread notification counter.

OAuth scope: `read`

notification_type is follow, like, tournament or blockpost. For like and blockpost, notification_data.post holds the post or comment involved. start and end are the Unix timestamps of the window that was read.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/social/notifications" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "items": [
            {
                "date": "2026-09-24T14:02:11Z",
                "date_time": 1790258531,
                "notification_type": "follow",
                "notification_data": {
                    "profile_id": "5678",
                    "profile": {
                        "profile_name": "Hodl Henk",
                        "profile_alias": "hodl-henk",
                        "profile_image": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
                        "verified": "0",
                        "profile_link": "/social/profile/hodl-henk"
                    },
                    "following": null
                },
                "notification_image": "<i class=\"fa fa-user-plus fa-3x text-success\"></i>"
            }
        ],
        "start": 1789106400,
        "end": 1790316000
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.