# List Positions

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.

Endpoint: GET /locations/{company_id}/positions
Version: 2.0.0
Security: BearerPartnerUser

## Security:

  - `BearerPartnerUser` (unknown)
    http bearer Bearer {PartnerToken}, User {UserToken}

## Path parameters:

  - `company_id` (integer, required)
    Location ID

## Header parameters:

  - `Accept` (string, required)
    Required B2B v2 response media type. Use `application/vnd.api.v2+json`. A charset parameter is also accepted.

  - `Authorization` (string, required)
    Bearer {partner_token}, User {user_token}

## Response 200:

  - `200` (unknown)
    Positions retrieved successfully

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.type` (string, required)
    Literal JSON:API resource type
    Enum: "position"

  - `data.id` (string, required)
    Position ID

  - `data.attributes` (object, required)

  - `data.attributes.chain_id` (integer, required)
    Chain ID

  - `data.attributes.title` (string, required)
    Position title

  - `data.attributes.description` (string, required)
    Position description

  - `data.attributes.services_binding_type` (integer, required)
    Service binding mode:
- `0` - disabled
- `1` - soft
- `2` - strict
    Enum: "0", "1", "2"

  - `data.attributes.rules_required_fields` (array, required)
    Required rule fields

  - `data.attributes.only_chain_appointment` (boolean, required)
    Whether the Position is available only for Chain Appointments

  - `data.attributes.salon_ids` (array, required)
    Location IDs linked to the Position

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable

## Response 403:

  - `403` (unknown)
    Forbidden - No permission to read Positions for this Location

## Response 403 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable

## Response 404:

  - `404` (unknown)
    Location not found

## Response 404 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable