Spot

Get TunioSpot device reports

GET
https://api.tunio.ai/v1/spot-reports

Get a paginated list of failover/restore reports submitted by the TunioSpot devices paired with a link, newest first. The link is addressed by its pin and must belong to the authenticated account. Each item carries the player's diagnostic payload expanded under `extra` with snake_case keys, for example `extra.ping_ms` and `extra.audio_state`.

Query parameters

NameTypeDescription
pinRequiredstringSpot link pin
directionstringFilter by direction, e.g. failover or restore
user_agentstringFilter by exact User-Agent
device_uuidstringFilter by device UUID
pageintegerPage number
per_pageintegerItems per page, 1-100

Responses

NameTypeDescription
itemsarray
-
[item]Requiredobject
-
paginationobject
-
pageinteger
Current page, starting from 1.
per_pageinteger
Page size actually applied (1..100).
totalinteger
Total number of matching records.
successboolean
-
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.