# SOF11 - List services

Call FrequencyRecommended usage: Once per hourMaximum usage: Once per hourPaginationThis resource supports seek pagination (see documentation)Sort fieldssort field can have the following values:date_created - Sort by last created date (asc by default)date_updated - Sort by last updated date (asc by default)title (Default) - Sort by title (asc by default)

Endpoint: GET /api/mms/services

## Query parameters:

  - `category_code` (array)
    Category codes to include in result. Children categories of the specified codes are also included. (default: include all)

  - `service_code` (array)
    Service codes to include in result. (default: include all)

  - `model_code` (array)
    Model codes to include in result. (default: include all)

  - `state` (string)
    Service state to include in result. (default: include all)
    Enum: "ACTIVE", "INACTIVE"

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Response 200 fields (application/json):

  - `data` (array, required)
    Page of data

  - `data.booking` (object, required)
    Service booking method

  - `data.booking.type` (string)
    Enum: "NO_BOOKING", "DATETIME_REQUEST", "SCHEDULED_EVENTS"

  - `data.category` (object, required)
    Service category

  - `data.category.code` (string, required)
    Category code

  - `data.category.label` (string, required)
    Category label

  - `data.code` (string, required)
    Service code

  - `data.consumption` (object, required)
    Service consumption method: how will the service be consumed ?

  - `data.consumption.type` (string, required)
    Type of consumption
    Enum: "VOUCHER", "CONFIRMATION_BY_SHOP"

  - `data.custom_attribute_values` (array, required)
    Service custom attributes values

  - `data.custom_attribute_values.code` (string, required)
    Custom attribute code

  - `data.custom_attribute_values.label` (string, required)
    Custom attribute label

  - `data.custom_attribute_values.type` (string, required)
    Custom attribute field type
    Enum: "BOOLEAN", "DATE_TIME", "INTEGER", "DECIMAL", "TEXT", "LONG_TEXT", "VALUE_LIST", "LINK", "VIDEO"

  - `data.custom_attribute_values.value` (object)
    Custom attribute field value

  - `data.date_availability_end` (string)
    Date when the service ends being available

  - `data.date_availability_start` (string)
    Date when the service starts being available

  - `data.date_created` (string, required)
    Service creation date

  - `data.date_updated` (string, required)
    Service update date

  - `data.description` (string)
    Service description

  - `data.inactive_reasons` (array, required)
    List of reasons why the service is inactive. If the service is active, this list is empty
    Enum: "MANUALLY_DISABLED", "ZERO_QUANTITY", "ORDER_REFUSED", "ORDER_ACCEPTANCE_TIMEOUT", "NOT_IN_AVAILABILITY_PERIOD", "SHOP_NOT_OPEN", "SHOP_SUSPENDED", "SHOP_CURRENCY_DISABLED", "MISSING_REQUIRED_FIELDS", "VALIDATION_NEEDED", "NO_SESSION"

  - `data.location` (object, required)
    Service location method: where the service will be provided ?

  - `data.medias` (array)
    All the medias associated to a service

  - `data.medias.mime_type` (string, required)
    Media Mime type

  - `data.medias.url` (string, required)
    Media URL

  - `data.model` (object, required)
    Service model

  - `data.model.code` (string, required)
    Service model code

  - `data.model.title` (string, required)
    Service model title

  - `data.pricing` (object, required)
    Service pricing method

  - `data.pricing.max_price_per_unit` (number, required)
    Maximum price at which the service will be provided. It's a price per unit.

  - `data.pricing.min_price_per_unit` (number, required)
    Minimum price at which the service will be provided. It's a price per unit.

  - `data.pricing.options` (array)
    Service pricing options. The list is ordered as configured by the operator.

  - `data.pricing.options.code` (string, required)
    Option code

  - `data.pricing.options.label` (string, required)
    Option label

  - `data.pricing.type` (string, required)
    Price type of the service.When the price type is FIXED_PRICE, the price defined when placing an order is final. The price cannot be modified.When the price type is ESTIMATED_PRICE, the price can be negotiated between the seller and the customer. The price can be updated by editing the pricing options of the order.When the price type is FIXED_PRICE_MULTI, the price defined when placing an order is final. The price cannot be modified. The price has multiple possibilities.When the price type is ESTIMATED_PRICE_MULTI, the price can be negotiated between the seller and the customer. The price can be updated by editing the pricing options of the order. The price has multiple possibilities.
    Enum: "FIXED_PRICE", "ESTIMATED_PRICE", "FIXED_PRICE_MULTI", "ESTIMATED_PRICE_MULTI"

  - `data.quantity` (object, required)
    Service quantity method

  - `data.quantity.max_per_order` (integer)
    Maximum quantity per order

  - `data.service_tax_code` (string)
    Service tax code

  - `data.title` (string, required)
    Service title

  - `next_page_token` (string)
    Token to access the next page. Absent if the current page is the last one.

  - `previous_page_token` (string)
    Token to access the previous page. Absent if the current page is the first one.