Skip to main content
GET
Get Staff
Retrieves the staff member with the given id. The lookup is scoped to your API key’s company. Ids that don’t exist and ids that belong to another company both return 404 — the response doesn’t distinguish between them. Retrieve does not apply a status filter, so inactive staff resolve directly by id. Use this endpoint when you already have a specific staff id (for example, one returned by an expanded event) and need the full record.

Example request

Example response

No expand[] paths are supported on staff yet. Passing any value in expand[] returns 400 with an invalid_parameter error.

Plan access

This endpoint requires a Scale-plan API key. See Plan access.

Authorizations

x-api-key
string
header
required

API key for authentication

Path Parameters

id
string
required

The staff id.

Query Parameters

expand[]
string[]

Reserved for future use. No expand paths are supported on staff yet — passing any value returns 400.

Response

Staff member retrieved successfully

object
enum<string>
Available options:
staff
id
string
firstName
string
lastName
string
email
string
phone
string | null
role
string | null
status
string

Staff status. Retrieve returns members regardless of status; inactive staff resolve directly by id.

createdAt
string<date-time>
updatedAt
string<date-time>