Skip to main content
GET
List technicians

Authorizations

Authorization
string
header
required

A machine-client token from POST /v1/auth/client-token. Reads need the pulse.read scope; provisioning and tenant updates need pulse.write, which the token only carries when requested_scopes asks for it. Creating, changing, disabling and resetting MFA for users, and the tenant sign-in policy, need a signed-in user's token instead: they reject API-key tokens.

Query Parameters

tenant_id
string<uuid>
required

Required. The tenant you want to assign a technician to.

Matches technicians whose first name, last name or email contains this text, ignoring case.

page

The page to return, starting at 1 (the default).

page_size

Technicians per page: 1–100, default 50.

Response

OK

One page of technicians, ordered by name.

items
object[]
required

The technicians on this page. Empty when nothing matches.

page
required

The page number returned, starting at 1.

page_size
required

The maximum number of technicians per page, as requested (default 50, maximum 100).

total_count
required

The number of technicians that match across all pages.

next_page

The page to request next. Null when this is the last page.