---
title: "List Services"
method: GET
path: "/locations/{location_id}/services"
tags: ["Services"]
---

# List Services

`GET /locations/{location_id}/services`

## Request

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

Retrieve Services for a Location, optionally filtered by Service IDs.

The response uses JSON:API resource objects. Pagination uses `page` and
`limit`; pagination metadata is not returned.

Related data can be requested by repeating the `include` parameter, for
example `?include=resources&include=company_links`.

## Path parameters

- `location_id` integer, required

## Query parameters

- `filter[service_ids][]` integer[]
- `page` integer
- `limit` integer
- `include` string[]

## Headers

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

## Response `200`

Services retrieved successfully

- object
  - `data` ServiceResource[], required
    - `type` 'service', required: Literal JSON:API resource type
    - `id` string, required: Service ID
    - `attributes` object, required
      - `title` string, required: Service name
      - `category_id` integer, required: Service Category ID
    - `relationships` object: Present when related data is requested through `include`
      - `resources` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `service_composite` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `resource_links` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `company_links` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `trial_settings` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
  - `included` IncludedResource[]: Resources requested through `include`, when available
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
    - `relationships` object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - No permission to read Services 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)