{ "info": { "_postman_id": "23b1f481-9533-47e9-a15a-475c860f21ac", "name": "The Things Stack \u2014 Application Server AppAs NotificationService API", "description": "The Things Stack is an open-source LoRaWAN Network Server implementation. This OpenAPI was derived from the upstream gRPC-Gateway generated api.swagger.json published by TheThingsNetwork/lorawan-stack v3.36.\n\nContact Support:\n Name: The Things Industries", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:12:46.000Z", "updatedAt": "2026-07-28T03:12:46.000Z", "lastUpdatedBy": "35240", "uid": "35240-23b1f481-9533-47e9-a15a-475c860f21ac" }, "item": [ { "name": "users", "item": [ { "name": "{receiver_ids.user_id}", "item": [ { "name": "notifications", "item": [ { "name": "List the notifications for a user or an organization.\nWhen called with user credentials and empty receiver_ids, this will list\nnotifications for the current user and its organizations.", "id": "392ea374-4457-4937-b34a-5749556399ff", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications?receiver_ids.email=&status=NOTIFICATION_STATUS_UNSEEN&status=NOTIFICATION_STATUS_ARCHIVED&limit=&page=", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "query": [ { "description": "Secondary identifier, which can only be used in specific requests.", "key": "receiver_ids.email", "value": "" }, { "description": "Select notifications with these statuses.\nAn empty list is interpreted as \"all\".", "key": "status", "value": "NOTIFICATION_STATUS_UNSEEN" }, { "description": "Select notifications with these statuses.\nAn empty list is interpreted as \"all\".", "key": "status", "value": "NOTIFICATION_STATUS_ARCHIVED" }, { "description": "Limit the number of results per page.", "key": "limit", "value": "" }, { "description": "Page number for pagination. 0 is interpreted as 1.", "key": "page", "value": "" } ], "variable": [ { "id": "5adf9072-1083-4a5a-84d6-a61e78acf2c4", "key": "receiver_ids" }, { "id": "b9aa84c7-b4ea-4971-8ae3-f7803999ecd0", "key": "receiver_ids.user_id", "value": "", "description": "(Required) This ID shares namespace with organization IDs." } ] } }, "response": [ { "id": "0f5f7482-8e67-4f10-98df-9374137d96c0", "name": "A successful response.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications?receiver_ids.email=&status=NOTIFICATION_STATUS_ARCHIVED&limit=&page=", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "query": [ { "description": "Secondary identifier, which can only be used in specific requests.", "key": "receiver_ids.email", "value": "" }, { "description": "Select notifications with these statuses.\nAn empty list is interpreted as \"all\".", "key": "status", "value": "NOTIFICATION_STATUS_ARCHIVED" }, { "description": "Limit the number of results per page.", "key": "limit", "value": "" }, { "description": "Page number for pagination. 0 is interpreted as 1.", "key": "page", "value": "" } ], "variable": [ { "key": "receiver_ids.user_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"notifications\": [\n {\n \"id\": \"\",\n \"created_at\": \"\",\n \"entity_ids\": {\n \"application_ids\": {\n \"application_id\": \"\"\n },\n \"client_ids\": {\n \"client_id\": \"\"\n },\n \"device_ids\": {\n \"device_id\": \"\",\n \"application_ids\": {\n \"application_id\": \"\"\n },\n \"dev_eui\": \"\",\n \"join_eui\": \"\",\n \"dev_addr\": \"\"\n },\n \"gateway_ids\": {\n \"gateway_id\": \"\",\n \"eui\": \"\"\n },\n \"organization_ids\": {\n \"organization_id\": \"\"\n },\n \"user_ids\": {\n \"user_id\": \"\",\n \"email\": \"\"\n }\n },\n \"notification_type\": \"\",\n \"data\": {\n \"@type\": \"\",\n \"deserunt__0_\": {},\n \"ut_f\": {}\n },\n \"sender_ids\": {\n \"user_id\": \"\",\n \"email\": \"\"\n },\n \"receivers\": [\n \"NOTIFICATION_RECEIVER_UNKNOWN\",\n \"NOTIFICATION_RECEIVER_UNKNOWN\"\n ],\n \"email\": \"\",\n \"status\": \"NOTIFICATION_STATUS_UNSEEN\",\n \"status_updated_at\": \"\"\n },\n {\n \"id\": \"\",\n \"created_at\": \"\",\n \"entity_ids\": {\n \"application_ids\": {\n \"application_id\": \"\"\n },\n \"client_ids\": {\n \"client_id\": \"\"\n },\n \"device_ids\": {\n \"device_id\": \"\",\n \"application_ids\": {\n \"application_id\": \"\"\n },\n \"dev_eui\": \"\",\n \"join_eui\": \"\",\n \"dev_addr\": \"\"\n },\n \"gateway_ids\": {\n \"gateway_id\": \"\",\n \"eui\": \"\"\n },\n \"organization_ids\": {\n \"organization_id\": \"\"\n },\n \"user_ids\": {\n \"user_id\": \"\",\n \"email\": \"\"\n }\n },\n \"notification_type\": \"\",\n \"data\": {\n \"@type\": \"\",\n \"fugiat_ab7\": {}\n },\n \"sender_ids\": {\n \"user_id\": \"\",\n \"email\": \"\"\n },\n \"receivers\": [\n \"NOTIFICATION_RECEIVER_UNKNOWN\",\n \"NOTIFICATION_RECEIVER_UNKNOWN\"\n ],\n \"email\": \"\",\n \"status\": \"NOTIFICATION_STATUS_UNSEEN\",\n \"status_updated_at\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-0f5f7482-8e67-4f10-98df-9374137d96c0" }, { "id": "6fa696b7-3505-4d65-a0d8-fdded6666b66", "name": "An unexpected error response.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications?receiver_ids.email=&status=NOTIFICATION_STATUS_ARCHIVED&limit=&page=", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "query": [ { "description": "Secondary identifier, which can only be used in specific requests.", "key": "receiver_ids.email", "value": "" }, { "description": "Select notifications with these statuses.\nAn empty list is interpreted as \"all\".", "key": "status", "value": "NOTIFICATION_STATUS_ARCHIVED" }, { "description": "Limit the number of results per page.", "key": "limit", "value": "" }, { "description": "Page number for pagination. 0 is interpreted as 1.", "key": "page", "value": "" } ], "variable": [ { "key": "receiver_ids.user_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"@type\": \"\",\n \"Lorem_5\": {}\n },\n {\n \"@type\": \"\",\n \"ullamcoce6\": {},\n \"elit_f_9\": {}\n }\n ]\n}", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-6fa696b7-3505-4d65-a0d8-fdded6666b66" } ], "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-392ea374-4457-4937-b34a-5749556399ff" }, { "name": "Batch-update multiple notifications to the same status.", "id": "845b8333-f299-45b8-9fa5-da5d7a69016b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"receiver_ids\": {\n \"email\": \"\"\n },\n \"ids\": [\n \"\",\n \"\"\n ],\n \"status\": \"NOTIFICATION_STATUS_UNSEEN\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "variable": [ { "id": "5d52e66f-8e46-4990-8674-015cbf46add0", "key": "receiver_ids" }, { "id": "a7c97b4f-702d-4eea-a46e-15322c0e3e25", "key": "receiver_ids.user_id", "value": "", "description": "(Required) This ID shares namespace with organization IDs." } ] } }, "response": [ { "id": "bc361cad-3f78-44d5-a131-722acdf2c2ee", "name": "A successful response.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"receiver_ids\": {\n \"email\": \"\"\n },\n \"ids\": [\n \"\",\n \"\"\n ],\n \"status\": \"NOTIFICATION_STATUS_UNSEEN\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "variable": [ { "key": "receiver_ids.user_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-bc361cad-3f78-44d5-a131-722acdf2c2ee" }, { "id": "fa86da7b-1991-4143-bfad-a36df20c94b1", "name": "An unexpected error response.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"receiver_ids\": {\n \"email\": \"\"\n },\n \"ids\": [\n \"\",\n \"\"\n ],\n \"status\": \"NOTIFICATION_STATUS_UNSEEN\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:receiver_ids.user_id/notifications", "host": [ "{{baseUrl}}" ], "path": [ "users", ":receiver_ids.user_id", "notifications" ], "variable": [ { "key": "receiver_ids.user_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"@type\": \"\",\n \"Lorem_5\": {}\n },\n {\n \"@type\": \"\",\n \"ullamcoce6\": {},\n \"elit_f_9\": {}\n }\n ]\n}", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-fa86da7b-1991-4143-bfad-a36df20c94b1" } ], "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-845b8333-f299-45b8-9fa5-da5d7a69016b" } ], "id": "444dee69-4fc9-4478-8a3a-d9f64c7aa765", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-444dee69-4fc9-4478-8a3a-d9f64c7aa765" } ], "id": "667a7234-f8f1-463f-89b4-f086fcb28f4e", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-667a7234-f8f1-463f-89b4-f086fcb28f4e" } ], "id": "811eb465-6c94-4a14-b39a-2d05029fe419", "createdAt": "2026-07-28T03:12:47.000Z", "updatedAt": "2026-07-28T03:12:47.000Z", "uid": "35240-811eb465-6c94-4a14-b39a-2d05029fe419" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://eu1.cloud.thethings.industries/api/v3" } ] }