Skip to main content
Admins

Get an admin by ID

Retrieves a single admin by their unique identifier.

GET
/v2/admins/{id}

Returns the admin object if found and they belong to your organization.

Response

Returns an admin object with:

  • id - Unique admin identifier
  • name - Admin's display name
  • email - Admin's email address
  • picture - Profile picture URL
  • roleId - ID of the role assigned to this admin

Errors

  • 404 - Admin not found or doesn't belong to your organization
Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

idstringrequired

Admin unique identifier

Example: 5fef50c5e9458a0012f82456
Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

emailstring

Admin email address

Example: john@example.com
idstringrequired

Unique identifier

Example: 5fef50c5e9458a0012f82456
namestring

Admin display name

Example: John Doe
objectenum<string>required

Object type identifier

Available options: admin
Example: admin
profilePicturestring | null

Profile picture URL

Example: https://example.com/avatar.png
roleIdstring

Role ID assigned to this admin

Example: 6648f22b7b23fb2f4307aafe