v1

latestOpenAPI 3.0.0Apache 2.02026-07-142008071.1 MB

V1Employees

RetrieveEmployee

Provides the details for a single employee.

get/v1/me/employees/{employee_id}

Path parameters

employee_idstring required

The employee's ID.

Response

Success

authorized_location_idsstring[]

The IDs of the locations the employee is allowed to clock in at.

created_atstring

The time when the employee entity was created, in ISO 8601 format.

emailstring

The employee's email address.

external_idstring

An ID the merchant can set to associate the employee with an entity in another system.

first_namestring required

The employee's first name.

idstring

The employee's unique ID.

last_namestring required

The employee's last name.

role_idsstring[]

The ids of the employee's associated roles. Currently, you can specify only one or zero roles per employee.

statusstring

Whether the employee is ACTIVE or INACTIVE. Inactive employees cannot sign in to Square Register.Merchants update this field from the Square Dashboard.

updated_atstring

The time when the employee entity was most recently updated, in ISO 8601 format.