List nRF9x Device Messages
GET/v1/organizations/:organization_slug/projects/:project_slug/messages
Send this request to https://api.nrfcloud.com, not the default Memfault API host.
List the stored messages that nRF9x Devices in a given Project have sent, newest first by default.
Requires an Organization Auth Token with the device:read permission.
Filter by device with deviceId, by application with appId, or by MQTT topic with topic, using the full topic as returned in items[].topic. topic requires deviceId and cannot be combined with appId. Limit the time range with start (inclusive) and end (exclusive); start must be before end.
Results are paginated. When more results are available, the response contains a pageNextToken. Pass it in the next request, together with the same filters, to fetch the next page.
Return Value
| Field | Type | Description |
|---|---|---|
items | Array | The messages on this page. |
items[].deviceId | String | The ID of the device that sent the message. |
items[].topic | String | The MQTT topic the message was received on. |
items[].receivedAt | DateTime | When nRF Cloud received the message, with second precision. |
items[].message | Any | The message payload as JSON. An empty string if the payload is not valid JSON. |
total | Integer | The number of messages on this page. |
pageNextToken | String | Token for the next page. Omitted when there are no more results. |
Request
Responses
- 200
- 400
- 403
- 422
OK
Bad Request. The filters are combined incorrectly or the time range is invalid.
Forbidden. The token lacks the device:read permission.
Unprocessable Entity. A query parameter is malformed.