---
title: "List staffs"
method: GET
path: "/api/business/{businessId}/branch/{branchId}/staff"
tags: ["Staff"]
---

# List staffs

`GET /api/business/{businessId}/branch/{branchId}/staff`

Get a list of staffs for the specified business id and branch id. There is an option to include archived staffs in the list

## Path parameters

- `businessId` string, required
- `branchId` string, required

## Query parameters

- `updatedAfter` string
- `updatedBefore` string
- `fetch_archived` boolean

## Response `200`

Staffs listed

- DataPagedModelStaff
  - `_embedded` object
    - `staffs` Staff[]
      - `staffId` string
      - `branchId` string
      - `staffCategoryId` string
      - `userId` string
      - `staffCategoryName` string
      - `firstName` string
      - `lastName` string
      - `birthDate` string, date
      - `startDate` string, date
      - `selfEmployed` boolean
      - `archived` boolean
      - `mobile` string
      - `email` string
      - `gender` string
      - `notes` string
      - `onlineProfile` string
      - `hideFromOnlineBookings` boolean
      - `hideFromAppointmentScreen` boolean
      - `imageUrl` string
      - `taxNumber` string — The tax registration number for self-employed staff members (VAT, GST, Tax Number, etc. depending on territory)
      - `payrollNumber` string
      - `disqualifiedServices` string[] — The list of disqualified serviceIds for a staff member
  - `page` PageMetadata
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer
    - `number` integer

## Other responses

- `400` — Bad Request
- `404` — Business or branch with the specified ids don't exist
- `429` — Request rate limit exceeded. Current limit set to 100 rps.
- `500` — Internal Server Error

---

[API](https://skmtc.net/phorest/apis/third-party-api.md) · [All operations](https://skmtc.net/phorest/apis/third-party-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phorest/third-party-api/revisions/2218bc90d39c/schema)