---
title: "ListEmployeeRoles"
method: GET
path: "/v1/me/roles"
tags: ["V1Employees"]
---

# ListEmployeeRoles

`GET /v1/me/roles`

Provides summary information for all of a business's employee roles.

## Query parameters

- `order` string
- `limit` integer
- `batch_token` string

## Response `200`

Success

- V1EmployeeRole[]
  - `created_at` string — The time when the employee entity was created, in ISO 8601 format. Is set by Square when the Role is created.
  - `id` string — The role's unique ID, Can only be set by Square.
  - `is_owner` boolean — If true, employees with this role have all permissions, regardless of the values indicated in permissions.
  - `name` string, required — The role's merchant-defined name.
  - `permissions` string[], required — The role's permissions.
  - `updated_at` string — The time when the employee entity was most recently updated, in ISO 8601 format. Is set by Square when the Role updated.

---

[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)