---
title: "List staff"
method: GET
path: "/v1/locations/{locationId}/staff"
tags: ["Staff"]
---

# List staff

`GET /v1/locations/{locationId}/staff`

## Request

- Base URL: `https://api.cliento.com`
- URL: `https://api.cliento.com/v1/locations/{locationId}/staff`
- Auth: HTTP bearer

The location's staff members, sorted by name. Use a staff id to say who did something, for example who took stock out. PINs are never returned; `hasPin` says whether a person has one.

## Path parameters

- `locationId` string, required

## Response `200`

OK

- StaffList
  - `data` Staff[], required: The staff of the location, sorted by name. At most 500.
    - `hasPin` boolean, required: Whether the person has a PIN for the point of sale. The PIN itself is never returned.
    - `id` string, required: Staff id.
    - `name` string: The person's name. Left out when none is registered.
    - `resourceIds` string[], required: The resources the person is linked to. Often one, and can be empty.
  - `pinsInUse` boolean, required: Whether the location has switched PINs on at its point of sale. When false, staff pick their name from a list there, and a PIN a person happens to have is not asked for.

## Other responses

- `default`: Any failure. See the Errors section.

---

[API](https://skmtc.dev/cliento/apis/cliento-api.md) · [All operations](https://skmtc.dev/cliento/apis/cliento-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliento/apis/cliento-api/revisions/29ca811bc061?raw)