Skip to content
SENS Platform Docs

Query raw ingestion metadata as a platform administrator.

GET
/v1/raw-ingestion-messages
curl --request GET \
  --url 'https://api.dev.iot-sens.schlossers.at/v1/raw-ingestion-messages?processingStatus=accepted&scope=all&limit=25' \
  --header 'Authorization: Bearer <token>'

Returns 25 reverse-chronological metadata records at a time without an exact total. to is the fixed upper investigation anchor, and every continuation must reuse it and all active filters. Exact MQTT and sensor payloads are deliberately excluded and loaded only through the detail operation. Responses are not cacheable.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
from
string format: date-time

Defaults to 24 hours before to; the bounded range may not exceed 42 days.

to
string format: date-time

Fixed upper investigation anchor; defaults to current server time and continuations reuse it.

processingStatus
string
Allowed values: accepted duplicate unknown_device malformed stored
devEui
string
>= 16 characters <= 16 characters /^[A-F0-9]{16}$/
customer
string
>= 1 characters <= 200 characters

Exact case-normalized Netmore topic customer.

tenantNumber
integer format: int32
>= 1 <= 2147483647

Trusted registry-derived tenant scope, never the Netmore customer value.

scope
string
Allowed values: all unassigned
cursor
string
<= 512 characters

Opaque continuation token; reuse the original filters and scope.

limit
integer
default: 25 >= 1 <= 100

Number of timeline records to return; defaults to 25, accepts 1 through 100, and is bound into continuation cursors.

Responses

Section titled “Responses”

200

Section titled “200”

Reverse-chronological raw-ingestion metadata page.

Media typeapplication/json
object
items
required
Array<object>
object
rawIngestionMessageId
required
string format: uuid
receivedAt
required
string format: date-time
recordedAt
required
string format: date-time
eventId
required
string
correlationId
required
string
tenantId
required
One of:
string format: uuid
deviceId
required
One of:
string format: uuid
devEui
required
One of:
string
>= 16 characters <= 16 characters /^[A-F0-9]{16}$/
processingStatus
required
string
Allowed values: accepted duplicate unknown_device malformed stored
parseErrorCode
required
One of:
string
mqttTopic
required
string
mqttQos
required
integer
Allowed values: 0 1 2
mqttRetained
required
boolean
mqttDuplicate
required
boolean
mqttReceivedAt
required
string format: date-time
mqttMessageId
required
One of:
string
networkServerProvider
required
string
networkServerServiceProvider
required
One of:
string
networkServerCustomer
required
One of:
string
networkServerReceivedAt
required
One of:
string format: date-time
networkServerFrameCounter
required
One of:
integer
transportPayloadSizeBytes
required
One of:
integer
rawPayloadEncoding
required
One of:
string
Allowed values: base64 hex utf8
rawPayloadDataLength
required
One of:
integer
nextCursor
string
Example
{
  "items": [
    {
      "processingStatus": "accepted",
      "mqttQos": 0,
      "rawPayloadEncoding": "base64"
    }
  ]
}

Headers

Section titled “Headers”
Cache-Control
string
Allowed value: no-store

default

Section titled “default”

A safe platform error response.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR
category
required
string
Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal
message
required

Safe client-facing diagnostic message.

string
correlationId
required

Correlation ID for operational investigation.

string
>= 1 characters
details

Safe bounded diagnostic details.

object
key
additional properties
One of:
string
Example
{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Section titled “Headers”
Cache-Control
string
Allowed value: no-store