---
title: "Get serialised notification by ID"
description: "GET /notifications/{notification_id} — Returns one of your notifications by ID. The type field identifies what it is about — for example an assigned action, a note, call, meeting, email or contact assignment — and read shows whether it has…"
canonical_url: https://developer.onepagecrm.com/api/reference/notifications/get-notifications-notification_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/notifications/get-notifications-notification_id/
---

`GET /notifications/{notification_id}`

Returns one of your notifications by ID. The type field identifies what it is about — for example an assigned action, a note, call, meeting, email or contact assignment — and read shows whether it has been seen. Notifications are removed once 100 newer ones have been generated for you.

Resource: [Notifications](https://developer.onepagecrm.com/api/reference/notifications/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl "https://app.onepagecrm.com/api/v3/notifications/{notification_id}" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `notification_id` | string | Notification ID |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "notification": {
      "id": "5aead4809007ba56ffca942e",
      "type": "assigned_action",
      "by": "Vlad K.",
      "read": true,
      "user_id": "5aead4809007ba56ffca942e",
      "contact_id": "5aead4809007ba56ffca942e",
      "created_at": "2019-06-21T16:53:12Z",
      "modified_at": "2019-06-21T16:53:12Z",
      "mobile_data": {
        "title": "Action assigned to you (by User N.)",
        "body": "17:13: in bulk",
        "action_type": "action_with_time"
      }
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
