---
title: "List Team Members"
method: GET
path: "/locations/{location_id}/team_members"
tags: ["Team Members"]
---

# List Team Members

`GET /locations/{location_id}/team_members`

Retrieve Team Members for a Location as JSON:API resource objects.

Use the filters to select Team Members by name, Position, account link,
schedule, payment, dismissal, deletion, or assistant availability. Status
filters use `0`, `1`, and `2`, where `2` disables that filter.

Related data can be requested by repeating the `include` parameter. The
`employee` wire value returns an employment profile that can contain
sensitive employment and identity data. Request and store it only when it
is necessary for the integration.

## Path parameters

- `location_id` integer, required

## Query parameters

- `filter[name]` string
- `filter[position_id]` integer
- `filter[position_title]` string
- `filter[fired]` 0 | 1 | 2
- `filter[deleted]` 0 | 1 | 2
- `filter[user_linked]` 0 | 1 | 2
- `filter[is_paid]` 0 | 1 | 2
- `filter[has_schedule]` 0 | 1 | 2
- `filter[is_assistant]` 0 | 1 | 2
- `include` string[]

## Headers

- `Accept` string, required
- `Authorization` string, required

## Response `200`

Team Members retrieved successfully

- object
  - `data` TeamMemberResource[], required
    - `type` 'staff', required — Literal JSON:API resource type
    - `id` string, required — Team Member ID
    - `attributes` object, required
      - `name` string, required — Team Member name
      - `tt_markup` integer, required — Schedule grid interval value
      - `specialization` string, required — Team Member specialization
      - `image` string, required — Team Member image URL
      - `position_id` integer, required — Position ID
      - `is_available_as_assistant` boolean, required — Whether the Team Member is available as an assistant
    - `relationships` object — Present when related data is requested through `include`
      - `position` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `employee` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
  - `included` union[] — Resources requested through `include`, when available
    - union
      - PositionResource
        - `type` 'staff_position', required — Literal JSON:API resource type
        - `id` string, required — Position ID
        - `attributes` object, required
          - `title` string, required — Position title
      - EmploymentProfileResource
        - `type` 'employee', required — Literal JSON:API resource type
        - `id` string, required — Employment profile ID
        - `attributes` object, required
          - `phone` string, required — Phone number
          - `name` string, required — Display name
          - `firstname` string, required — First name
          - `surname` string, required — Last name
          - `patronymic` string, required — Patronymic
          - `date_admission` string, nullable, required — Employment start date and time without a timezone
          - `date_registration_end` string, nullable, required — Registration end date and time without a timezone
          - `citizenship` string, required — Citizenship
          - `gender` 0 | 1 | 2, required — Gender wire value: `0` unspecified, `1` male, `2` female
          - `passport_data` string, required — Passport data
          - `personal_tax_reference_number` string, required — Personal tax reference number
          - `number_insurance_certificates` string, required — Insurance certificate number

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - No permission to read Team Members for this Location
- `404` — Location not found
- `422` — Invalid filter value

---

[API](https://skmtc.net/alteg/apis/business-management.md) · [All operations](https://skmtc.net/alteg/apis/business-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alteg/business-management/revisions/bc9cbcc9c5f1/schema)
