Skip to content
SENS Platform Docs

Load one raw-ingestion message including exact payloads.

GET
/v1/raw-ingestion-messages/{rawIngestionMessageId}
curl --request GET \
  --url 'https://api.dev.iot-sens.schlossers.at/v1/raw-ingestion-messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?receivedAt=2026-04-15T12%3A00%3A00Z' \
  --header 'Authorization: Bearer <token>'

The receive timestamp is part of the hypertable key and is therefore required together with the message ID. Only platform administrators may access this sensitive payload response. Responses are not cacheable.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
rawIngestionMessageId
required
string format: uuid

Query Parameters

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

Exact local receive timestamp from the list item.

Responses

Section titled “Responses”

200

Section titled “200”

Raw-ingestion message including exact transport bytes.

Media typeapplication/json
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
schemaVersion
required
string
source
required
string
idempotencyKey
required
string
transportPayload
required
One of:
object
encoding
required
string
Allowed values: base64 hex utf8
data
required
string
rawPayload
required
One of:
object
encoding
required
string
Allowed values: base64 hex utf8
data
required
string
Example
{
  "processingStatus": "accepted",
  "mqttQos": 0,
  "rawPayloadEncoding": "base64",
  "transportPayload": {
    "encoding": "base64"
  },
  "rawPayload": {
    "encoding": "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