Get user details

GEThttps://app.speybooks.com/api/v1/admin/users/{id}

Full detail for a single user: organisation membership, subscription status, suspension state, and the twenty most recent audit-log entries for that user. Returns 404 if the user does not exist.

Path parameters

idstringrequired

User ID.

Response

200Full user profile with suspension status, organisation, and last 20 audit log entries.

Show response fields

organisationobject

Show child attributes

idstring

namestring

planstring

subscriptionStatusstring

recentActivityarray<object>

Show child attributes

actionstring

created_atstringdate-time

detailsobject

userobject

Show child attributes

createdAtstringdate-time

emailstring

failedAttemptsinteger

fullNamestring

idinteger

isActiveboolean

isAdminboolean

lastLoginstringdate-time

lockedUntilstringnullable

suspendedAtstringnullable

suspendedPermanentboolean

suspendedReasonstringnullable

totpEnabledboolean

totpVerifiedboolean

updatedAtstringdate-time

Error codes

404User not found.

RequestGET/v1/admin/users/{id}curl

curl https://api.speybooks.com/v1/admin/users/12 \
  -H "Authorization: Bearer <admin-token>"

Response200

{
  "success": true,
  "data": {
    "user": {
      "id": 12,
      "email": "user@example.com",
      "fullName": "John Smith",
      "isActive": true,
      "isAdmin": false,
      "totpEnabled": true,
      "totpVerified": true,
      "failedAttempts": 0,
      "lockedUntil": null,
      "lastLogin": "2026-02-18T09:00:00Z",
      "suspendedAt": null,
      "suspendedReason": null,
      "suspendedPermanent": false,
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-02-18T09:00:00Z"
    },
    "organisation": {
      "id": "uuid",
      "name": "Smith Consulting",
      "plan": "sole_trader",
      "subscriptionStatus": "active"
    },
    "recentActivity": [
      {
        "action": "LOGIN",
        "details": {},
        "created_at": "2026-02-18T09:00:00Z"
      }
    ]
  }
}