/api/notifications

Notifications API

Push notifications and notification management endpoints

5 endpoints•Pagination & delay ready•Mock base URL: fakeapifordevs.vercel.app

Endpoints

5 routes

Active selection

GET

/api/notifications?user_id=user_123

Prefilled in the playground CTA below.

Sample request

JAVASCRIPT example

1const payload = {
2  "example": "payload"
3}
4fetch('https://fakeapifordevs.vercel.app/api/notifications?user_id=user_123&page=1&per_page=5&delay=1', {
5  method: 'GET',
6  headers: { 'Content-Type': 'application/json' }
7})
8  .then(res => res.json())
9  .then(console.log)

Response contract

All list responses include pagination + optional latency metadata.

Sample response

1{
2  "data": [
3    {
4      "id": "notif_123-1",
5      "title": "Deployment ready",
6      "read": false
7    },
8    {
9      "id": "notif_123-2",
10      "title": "Deployment ready",
11      "read": false
12    }
13  ],
14  "pagination": {
15    "page": 1,
16    "perPage": 5,
17    "total": 42,
18    "totalPages": 9
19  },
20  "meta": {
21    "delayMs": 0
22  }
23}

Query controls

Every collection endpoint accepts the following parameters.

page

1-indexed page number. Defaults to 1.

per_page

Number of records per page. Defaults to 10, max 50.

delay

Simulate latency in seconds (max 10s).

Integration checklist

• Use page and per_page for cursor-free pagination.
• Append delay to simulate client-side loading states.
• Expect pagination + meta.delayMs in responses.
• Point SDKs to /api/notifications.

Playground shortcut

Test this request directly from the landing page playground.

Open playground

https://fakeapifordevs.vercel.app/api/notifications?user_id=user_123&page=1&per_page=5&delay=1

Need more domains?

Explore 14+ prebuilt industries covering auth, finance, HR, healthcare, and more.

AuthenticationE-commerceSocial MediaSaaSLogisticsPayments

Keep these docs online

Buy the maintainers a coffee

Coffee donations help us keep Notifications accurate and add bonus sample responses.

Covers storage for notifications payloads
Funds schema QA sprints

Buy us a coffee