List your notices

GET/v1/notifications

The newest news of your deals, where you have to act or your money moves, and how many you haven't seen. Where they go besides is set on the site.

Request

This route takes no parameters.

curl 'https://api.rockvel.store/v1/notifications' \
  -H "Authorization: Bearer $ROCKVEL_KEY"

Answer 200

noticesobject[]
Your newest notices, the newest first.
Fields of notices
- idstring
  The notice's id.
- kindstring
  What happened.
  One ofsoldunansweredsettledreversedstoppedsentrefundedauto_boughtbargaincounteredbargainedanswered
- order_idstring
  The deal it is about. Empty for a ticket's answer.
- rolestring
  Your side of that deal. Empty for a ticket's answer.
  One ofbuyerseller
- item_namestring
  The item's name.
- itemsinteger
  How many deals it is about: those that went together in one trade offer. item_name is empty when their names differ, and order_id is the first one's.
- amount_centsinteger
  The price, or what the seller gets once the hold is over.
- ticketintegeroptional
  The number of your support ticket that support answered. Only with the kind answered.
- created_atdate-time
  When it happened.
- readboolean
  You have seen it.
unreadinteger
How many you haven't seen.

{
  "notices": [
    {
      "id": "019a4c3b-91d2-7e08-a6f4-3c1b7d0e9a25",
      "kind": "sent",
      "order_id": "019a4c1e-6f3a-7c21-9d40-5b2e8f1a7c03",
      "role": "buyer",
      "item_name": "AK-47 | Redline (Field-Tested)",
      "items": 0,
      "amount_cents": 3250,
      "created_at": "2026-11-02T09:47:17Z",
      "read": false
    }
  ],
  "unread": 1
}

Any route can also answer with the statuses on the Errors page.