---
title: "List services"
method: GET
path: "/services"
tags: ["Service Orders"]
---

# List services

`GET /services`

Returns a paginated list of services.

🔒 Requires: `services:read` scope

## Query parameters

- `after` integer
- `limit` integer

## Response `200`

A paginated list of service orders

- object
  - `has_next` boolean — Whether or not there are more pages available
  - `jobs` object[]
    - `service` ServiceOrder, nullable
      - `agenda` DailyAgenda
        - `date` string
        - `minutes_scheduled` integer
      - `assigned_user_id` string
      - `created_at` string
      - `id` string
      - `line_items` object[] — Collection of line items associated with this service order.
        - `fulfillment_type` string — Type of fulfillment for this line item.
        - `gift_card` object, nullable — Gift card information if applicable.
        - `id` string — The ID of this line item.
        - `is_picklist_pickable` boolean — Indicates if this line item can be picked from a picklist.
        - `note` string — Line item note.
        - `price_set` boolean — Indicates whether the price was set manually.
        - `product_id` string — The ID of the product associated with this line item.
        - `promotions` PromotionDescription[] — Array of promotions applied to this line item.
          - `description` string — A short description for the promotion.
          - `id` string — Auto-generated object ID.
          - `name` string — The name of the promotion.
        - `quantity` string — Quantity of products for the line item.
        - `register_id` string — The register ID associated with this line item.
        - `register_sequence_id` string — The register sequence ID for this line item.
        - `sales_person_id` string — The ID of the salesperson associated with this line item.
        - `sequence` integer — Order of the line item in the service order.
        - `sku` string — The SKU of the product.
        - `state` string — State of the line item.
        - `tax_components` LineItemTaxComponent[] — Collection of tax components associated with the line item.
          - `rate_id` string, required — Tax rate ID.
          - `total_tax` number, double, required — Tax total.
        - `unit_discount` string — Unit discount value for the line item.
        - `unit_loyalty` string — Unit loyalty value for the line item.
        - `unit_price` string — Unit price of the line item.
      - `location` string
      - `retailer_id` string
      - `sale_id` string
      - `status` string
      - `status_details` ServiceStatusDetails, nullable — Details of a custom service status assigned to a service order.
        - `created_at` string, date-time — The date and time the status was created.
        - `display_name` string — Human-readable name of the status.
        - `display_order` integer, nullable — The order in which this status appears in the UI. Null if not set.
        - `id` string — The unique ID of the status.
        - `retailer_id` string — The retailer this status belongs to.
        - `status_key` string — The underlying key mapping this status to a system status (e.g. NEW, IN_PROGRESS).
        - `system_default` boolean — Whether this is a system-managed default status.
        - `updated_at` string, date-time — The date and time the status was last updated.
      - `totals` object — Financial totals for the service order.
        - `is_sale_level_discount_percentage` boolean — Indicates if the sale level discount is a percentage.
        - `sale_level_discount_value` string — Total discount value applied at the sale level.
        - `sub_total` string — Subtotal amount before taxes and discounts.
        - `total_amount` string — Final total amount including all taxes and discounts.
        - `total_promotion` string — Total promotion value applied.
        - `total_tax` string — Total tax amount.
      - `updated_at` string, nullable
      - `updated_by` string
    - `service_item` object, nullable
  - `total_jobs` integer — Total number of jobs

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)