---
title: "List Positions"
method: GET
path: "/locations/{company_id}/positions"
tags: ["Team Members"]
---

# List Positions

`GET /locations/{company_id}/positions`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{company_id}/positions`
- Auth: HTTP bearer

Retrieve all Positions available to Team Members at a Location.

The response is a JSON:API collection and does not contain pagination
metadata. The literal `company_id` wire path parameter identifies a
Location.

## Path parameters

- `company_id` integer, required

## Headers

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

## Response `200`

Positions retrieved successfully

- object
  - `data` TeamMemberPositionResource[], required
    - `type` 'position', required: Literal JSON:API resource type
    - `id` string, required: Position ID
    - `attributes` object, required
      - `chain_id` integer, required: Chain ID
      - `title` string, required: Position title
      - `description` string, required: Position description
      - `services_binding_type` 0 | 1 | 2, required: Service binding mode: - `0` - disabled - `1` - soft - `2` - strict
      - `rules_required_fields` string[], required: Required rule fields
      - `only_chain_appointment` boolean, required: Whether the Position is available only for Chain Appointments
      - `salon_ids` integer[], required: Location IDs linked to the Position

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - No permission to read Positions for this Location
- `404`: Location not found

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
