---
updatedAt: 2026-07-03T01:53:36.000Z
agentTools:
  projectIndex: https://x-series-api.lightspeedhq.com/llms.txt
---

# List a customer's service items

Returns a paginated list of customer's service items.

🔒 Requires: `services:read` scope

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "email": "x-series.api@lightspeedhq.com",
      "name": "Lightspeed Developer Relations",
      "url": "https://developers.retail.lightspeed.app"
    },
    "description": "Lightspeed Retail (X-Series) API.",
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "termsOfService": "https://developers.lightspeedhq.com/terms",
    "title": "API 2026-07",
    "version": "2026-07"
  },
  "servers": [
    {
      "url": "https://{domain_prefix}.retail.lightspeed.app/api/2026-07",
      "variables": {
        "domain_prefix": {
          "default": "example",
          "description": "Domain prefix of the store to be operated on"
        }
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "externalDocs": {
    "description": "List of tz database time zones",
    "url": "https://en.wikipedia.org/wiki/List_of_tz_database_time_zones"
  },
  "tags": [
    {
      "description": "Service orders and Job management",
      "name": "Service Orders"
    }
  ],
  "paths": {
    "/service_items/customer/{customer_id}": {
      "get": {
        "description": "Returns a paginated list of customer's service items.\n\n🔒 Requires: `services:read` scope",
        "operationId": "ListServiceItems",
        "parameters": [
          {
            "description": "The customer id",
            "in": "path",
            "name": "customer_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The lower limit for the service id to be included in the response. For proper pagination, it needs to be the item id of the last item in the response from your previous request.",
            "in": "query",
            "name": "after",
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "description": "The maximum number of items to be returned in the response.",
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 100,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "has_next": false,
                  "job_items": [
                    {
                      "created_at": "2025-08-12T18:46:30.216844Z",
                      "created_by": "06e94082-ed4f-11ed-fd41-fef5ad8054af",
                      "initial_condition": "Screen cracked, minor water damage",
                      "item_details": {
                        "description": "Customer's primary phone with cracked screen",
                        "serial_number": "F2LXN1234A"
                      },
                      "item_id": "e6fd369e-e579-4768-b12d-6754af620f2d",
                      "item_name": "iPhone 15 Pro",
                      "updated_at": "2025-08-12T18:46:30.216844Z",
                      "updated_by": "06e94082-ed4f-11ed-fd41-fef5ad8054af"
                    },
                    {
                      "created_at": "2025-08-12T18:44:14.387026Z",
                      "created_by": "06e94082-ed4f-11ed-fd41-fef5ad8054af",
                      "initial_condition": "Spacebar key not responding consistently",
                      "item_details": {
                        "description": "13-inch laptop with keyboard issues",
                        "serial_number": "C02D12345678"
                      },
                      "item_id": "a57dc842-1075-458a-ab98-f658c4f985de",
                      "item_name": "MacBook Air M2",
                      "updated_at": "2025-08-12T18:44:14.387026Z",
                      "updated_by": "06e94082-ed4f-11ed-fd41-fef5ad8054af"
                    }
                  ],
                  "total_job_items": 2
                },
                "schema": {
                  "properties": {
                    "has_next": {
                      "type": "boolean"
                    },
                    "job_items": {
                      "items": {
                        "properties": {
                          "created_at": {
                            "type": "string"
                          },
                          "created_by": {
                            "type": "string"
                          },
                          "initial_condition": {
                            "type": "string"
                          },
                          "item_details": {
                            "properties": {
                              "description": {
                                "type": "string"
                              },
                              "serial_number": {
                                "type": "string"
                              }
                            },
                            "type": "object"
                          },
                          "item_id": {
                            "type": "string"
                          },
                          "item_name": {
                            "type": "string"
                          },
                          "updated_at": {
                            "type": "string"
                          },
                          "updated_by": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "total_job_items": {
                      "type": "integer"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": "Access token is not valid"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "summary": "List a customer's service items",
        "tags": [
          "Service Orders"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "description": "Bearer Token for API authentication.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```