Get report - DMU801

Request

GET /reports/{serial}

Retrieves a specific, the oldest, or the latest report.

Parameters
Parameter	Type	Location	Required	Description
`serial`	Integer \| String	Path	Yes	Report serial (integer >= 1), `"oldest"`, or `"latest"`.
`delete`	Boolean	Query	No	If `true`, delete the report after returning it (default = `false`).

Responses

200 (OK): Report found and returned.

{
  "serial": 6,
  "timestamp": "2025-10-01T12:35:10Z",
  "content": "S=AWS830_DEMO,D=2025-10-01,T=12:35:10,LAT=60.28,LON=24.88,
TA=15.5,RH=87,PA=1013.1"
}

404 (Not found): Report does not exist.

{
  "message": "Report with serial 99 not found"
}

404 (Bad request): Invalid parameters.

{
  "message": "'serial' must be an integer"
}

401 (Unauthorized): Missing or invalid API key.

{
  "message": "Unauthorized"
}

Example cURL

# Fetch by specific serial number
curl -X GET \
  "https://station.example.com/api/application/https_server_1/reports/v1/reports/6" \
  -H "X-Api-Key: <base64-encoded-api-key>"

# Fetch oldest and delete
curl -X GET \
  "https://station.example.com/api/application/https_server_1/reports/v1/reports/oldest?delete=true" \
  -H "X-Api-Key: <base64-encoded-api-key>"

# Fetch latest
curl -X GET \
  "https://station.example.com/api/application/https_server_1/reports/v1/reports/latest" \
  -H "X-Api-Key: <base64-encoded-api-key>"