curl --request GET \
--url 'https://gateway.amana.io/user/notifications/v2/'
import requests
url = "https://gateway.amana.io/user/notifications/v2/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/user/notifications/v2/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"notifications": [
{
"id": "<string>",
"title": "<string>",
"body": "<string>",
"data": {},
"channel": "<string>",
"is_read": true,
"created_at": "<string>"
}
],
"page": 123,
"limit": 123,
"hasMore": true
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Notifications
List notifications (v2)
List the user’s notifications by channel, one page at a time.
GET
/
user
/
notifications
/
v2
/
curl --request GET \
--url 'https://gateway.amana.io/user/notifications/v2/'
import requests
url = "https://gateway.amana.io/user/notifications/v2/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/user/notifications/v2/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"notifications": [
{
"id": "<string>",
"title": "<string>",
"body": "<string>",
"data": {},
"channel": "<string>",
"is_read": true,
"created_at": "<string>"
}
],
"page": 123,
"limit": 123,
"hasMore": true
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Query parameters
integer
Page number to return.Minimum:
1string
Response
200 Success.
integer
integer
boolean
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field | Check the request against the schema. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request GET \
--url 'https://gateway.amana.io/user/notifications/v2/'
import requests
url = "https://gateway.amana.io/user/notifications/v2/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/user/notifications/v2/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"notifications": [
{
"id": "<string>",
"title": "<string>",
"body": "<string>",
"data": {},
"channel": "<string>",
"is_read": true,
"created_at": "<string>"
}
],
"page": 123,
"limit": 123,
"hasMore": true
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Last modified on October 8, 2026
