Thrive AI Health
Api reference

Connection health, backfill progress, and data freshness for a provider

Single-call status read for one provider. Combines connection state, backfill progress (with start/end timestamps), and per-resource data freshness so partners can render a device-detail screen without multiple fetches.

GET
/v1/users/{user_id}/devices/{provider_slug}/status

Authorization

MemberBearer
AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id
Formatuuid
provider_slug*Provider Slug

Header Parameters

org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/devices/string/status"
{
  "data": {
    "slug": "string",
    "name": "string",
    "connection": {
      "status": "connected",
      "connected_at": "2019-08-24T14:15:22Z",
      "error": "string"
    },
    "backfill": {
      "status": "pending",
      "started_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "error": "string"
    },
    "data_freshness": {
      "last_data_received_at": "2019-08-24T14:15:22Z",
      "by_resource": {
        "property1": {
          "status": "available",
          "last_data_at": "2019-08-24T14:15:22Z"
        },
        "property2": {
          "status": "available",
          "last_data_at": "2019-08-24T14:15:22Z"
        }
      }
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}