BSV blockchainBSV blockchain

List registered devices for the authenticated identity

GET/devices

Returns one bounded page of device registrations for the authenticated user, sorted by updated_at descending. FCM tokens are truncated for security (last 10 characters prefixed with ”…”).

Query Parameters

limitinteger
offsetinteger

Response

Device list retrieved successfully.

status"success"
limitinteger
offsetinteger
devicesobject[]
Show devices properties
idinteger

Database row ID.

deviceIdstring

Caller-supplied device identifier.

platform"ios" | "android" | "web" | null
fcmTokenstring

Truncated FCM token (last 10 chars preceded by ”…”) for security.

activeboolean
createdAtstring<date-time>
updatedAtstring<date-time>
lastUsedstring<date-time>

Authentication required (ERR_AUTHENTICATION_REQUIRED).

status"error"
codestring

Machine-readable error code (see specs/errors.md).

descriptionstring

Human-readable explanation.

Internal server error (ERR_DATABASE_ERROR, ERR_INTERNAL).

status"error"
codestring

Machine-readable error code (see specs/errors.md).

descriptionstring

Human-readable explanation.

Request
curl -X GET "https://{host}/devices?limit=<limit>&offset=<offset>" \
  -H "x-bsv-auth-identity-key: <x-bsv-auth-identity-key>"
Response
{
  "status": "success",
  "limit": 0,
  "offset": 0,
  "devices": [
    {
      "id": 0,
      "deviceId": "string",
      "platform": "ios",
      "fcmToken": "string",
      "active": true,
      "createdAt": "1970-01-01T00:00:00.000Z",
      "updatedAt": "1970-01-01T00:00:00.000Z",
      "lastUsed": "1970-01-01T00:00:00.000Z"
    }
  ]
}