GET/api/v1/notifications

List notifications

Your notifications from the last 90 days, newest first: someone mentioned you, asked for your sign-off or shared a page with you. One about a page you can no longer open has no title or link.

API token required120 per minute per IPMCP: list_notifications

Guide: Mentions and notifications

Code samples and Try it

Query parameters

unread_onlyboolean
Only unread ones. Default false.
limitinteger
How many to return, up to 100. Default 30.
beforestring
The next_before of the previous page.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

bash

curl https://api.markdrop.in/api/v1/notifications \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

const res = await fetch("https://api.markdrop.in/api/v1/notifications", {
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
const data = await res.json();

python

import os

import requests

r = requests.get(
    "https://api.markdrop.in/api/v1/notifications",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

unread_only

limit

before

Your request

curl https://api.markdrop.in/api/v1/notifications \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

Sends to api.markdrop.in from your browser. ⌘ ↵ sends too.

Did this page help?