---
title: "Get All Service Items"
method: GET
path: "/service-items"
tags: ["Service Items"]
---

# Get All Service Items

`GET /service-items`

## Request

- Base URL: `https://workflows.promorepublic.com/webhook/2637089f-b543-45d0-a83e-2334aada4ead/listings/sandbox/api`
- URL: `https://workflows.promorepublic.com/webhook/2637089f-b543-45d0-a83e-2334aada4ead/listings/sandbox/api/service-items`
- Auth: HTTP bearer

Get all service items the current API user can manage.
<br>To specify services with identifier please provide ?identifier= in the URL param
<br>By default, 50 are returned, you can use up to max=10000 in the URL param

## Response `200`

Service Items successfully retrieved

- object
  - `status` 'SUCCESS' | 'PENDING' | 'QUOTA_LIMIT_EXCEED' | 'NOT_AUTHORIZED' | 'FORBIDDEN' | 'BAD_ACCESS_TOKEN' | 'BAD_PRIVATE_KEY' | 'BAD_PUBLIC_KEY' | 'MISSING_PARAMETER' | 'INVALID_PARAMETER' | 'WRONG_PARAMETER_TYPE' | 'CONFLICT' | 'RESOURCE_LOCKED' | 'SERVER_ERROR' | 'ERROR' | 'NOT_FOUND' | 'BAD_REQUEST' | 'USER_ERROR' | 'PARTIAL_ERROR' | 'SERVICE_TEMPORARILY_UNAVAILABLE', required
  - `message` string: (optional) Holds further information about the response
  - `warnings` string[]: (optional) Holds further warnings
  - `response` object, required: The actual response object of the response
    - `query` string: The search query
    - `offset` integer: The offset for pagination
    - `max` integer: The maximum number of results to return
    - `serviceItems` object[]
      - `title` string, required: Name of the service item as represented at the location
      - `description` string: A description of the service
      - `identifier` string: Required - A unique identifier for this service
      - `listName` string
      - `price` integer: Minimum price of the service item. Amounts must be provided in the smallest valid unit of the respective currency (e.g., USD - cents, 10.99 USD → 1099). See range interpretation rules under priceMax.
      - `currency` string: The currency of price and priceMax for this service (required when a price is given). Amounts for price fields must be expressed in the smallest valid unit of this currency (e.g., USD - cents).
      - `url` string: A valid page url with more details about the item.
      - `category` integer: Business category the service should be applied to - this is required when applying a Google structured service but not necessary for freeform services.
      - `country` string: The country where the locations providing this service are located - this is required when applying a Google structured service but not necessary for freeform services.
      - `googleService` string: The Google name for a structured service - this is required when applying a Google structured service but not necessary for freeform services.
      - `priceMax` integer: Maximum price for the item when using a price range. Amounts must be provided in the smallest valid unit of the respective currency (e.g., USD → cents). Range interpretation rules: - Exact: price == priceMax - Starts At: priceMax == null (only minimum known) - Range: price < priceMax (both known and different) - Not Interpreted: price is null (minimum unknown) Validation: if provided, priceMax must be a non-negative integer and greater than or equal to price.
      - `duration` integer: Minimum duration of the service in minutes. See range interpretation rules under durationMax.
      - `durationMax` integer: Maximum duration (in minutes) when using a duration range. Range interpretation rules: - Exact: duration == durationMax\n - Starts At: durationMax == null (only minimum known)\n - Range: duration < durationMax (both known and different)\n - Not Interpreted: duration is null (minimum unknown)\n Validation: if provided, durationMax must be a non-negative integer and greater than or equal to duration.

## Other responses

- `400`: Bad Request - The request was invalid or cannot be otherwise served
- `401`: Unauthorized - Authentication credentials are missing or invalid
- `403`: Forbidden - The request is understood, but has been refused or access is not allowed
- `404`: Not Found - The requested resource could not be found

---

[API](https://skmtc.dev/promorepublic/apis/listings-api.md) - [All operations](https://skmtc.dev/promorepublic/apis/listings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/promorepublic/apis/listings-api/revisions/a04c07676a6e?raw)