# Get user notifications

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

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

Returns the user's notifications of the last 6 hours, newest first, at most 20.

OAuth scope: `read`

The API gateway does not forward query parameters for this route, so paging is not available.

## 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/user/notifications" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "message_type": "trade_completed",
            "title": "Trade completed",
            "message": "Sold 0.01 BTC for 650.00 USDT",
            "link": "",
            "extra_data": [],
            "date": "2026-09-25 14:02:11"
        }
    ]
}
```

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.