---
title: "ListEmployees"
method: GET
path: "/v2/employees"
tags: ["Employees"]
---

# ListEmployees

`GET /v2/employees`

## Query parameters

- `location_id` string
- `status` string
- `limit` integer
- `cursor` string

## Response `200`

Success

- ListEmployeesResponse
  - `cursor` string — The token to be used to retrieve the next page of results.
  - `employees` Employee[]
    - `created_at` string — A read-only timestamp in RFC 3339 format.
    - `email` string — The employee's email address
    - `first_name` string — The employee's first name.
    - `id` string — UUID for this object.
    - `is_owner` boolean — Whether this employee is the owner of the merchant. Each merchant has one owner employee, and that employee has full authority over the account.
    - `last_name` string — The employee's last name.
    - `location_ids` string[] — A list of location IDs where this employee has access to.
    - `phone_number` string — The employee's phone number in E.164 format, i.e. "+12125554250"
    - `status` string — Specifies the status of the employees being fetched.
    - `updated_at` string — A read-only timestamp in RFC 3339 format.
  - `errors` Error[] — Any errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)