Ir al contenido principal
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
Authorizationstringheaderobligatorio

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

idstringobligatorio

Admin unique identifier

Ejemplo: 5fef50c5e9458a0012f82456
Featurebase-Versionenum<string>header

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

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

emailstring

Admin email address

Ejemplo: john@example.com
idstringobligatorio

Unique identifier

Ejemplo: 5fef50c5e9458a0012f82456
namestring

Admin display name

Ejemplo: John Doe
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: admin
Ejemplo: admin
profilePicturestring | null

Profile picture URL

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

Role ID assigned to this admin

Ejemplo: 6648f22b7b23fb2f4307aafe