Skip to main content

Get Services

Method GET​

https://my.easyweek.io/api/public/v2/locations/{location_uuid}/services

Description: This endpoint is used to retrieve a list of services offered at a specific location, within a specified category. It provides detailed information about each service, including its name, description, pricing, duration, and other attributes.

Example Request​

curl -i -X GET \
  https://my.easyweek.io/api/public/v2/locations/{location_uuid}/services?category_uuid={category_uuid}&staffer_uuid={staffer_uuid} \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Path Parameters​

  • location_uuid (string, required): This is a parameter that represents the unique identifier of the location for which you want to retrieve services. It allows you to specify the location by its UUID, and the endpoint will return the services available at that particular location.

Query Parameters​

  • category_uuid (string, optional): This is an optional parameter that allows you to filter services by category. You can specify the category_uuid to narrow down the results to services within a specific category. To retrieve services that are not assigned to any category, use category_uuid=none.
  • staffer_uuid (string, optional): An optional parameter that further filters the services by a specific staffer. By providing a staffer_uuid, you can retrieve only those services that the specified staffer is eligible to perform.
info

The fields duration, and extra_time are always returned as objects in the response, even if they are not set or are set to their default values. This ensures a consistent response structure for consumers of the API.

Example Response​

{
  "data": [
    {
      "uuid": "43537759-435b-4871-bf11-e3ace6a4464b",
      "name": "Beard trim",
      "description": null,
      "images": [],
      "is_price_hidden": false,
      "starting_at": false,
      "currency": "EUR",
      "price": 10000,
      "price_formatted": "€100.00",
      "discount": null,
      "discount_formatted": null,
      "is_duration_hidden": false,
      "duration": {
        "value": 30,
        "label": "minutes",
        "iso_8601": "PT30M"
      },
      "is_extra_time": false,
      "extra_time": {
        "value": 0,
        "label": "minutes",
        "iso_8601": "PT0M"
      },
      "is_top": false,
      "category": {
        "uuid": "41765a3f-d8eb-4853-8558-0718c49c58d0",
        "name": "Hair Styling",
        "order": 1,
        "cover": "https://storage.easyweek.io/e2e/media/74/category_images_yqlKmA9h.jpg"
      }
    }
  ],
  "links": {
    "first": "https://my.easyweek.io/api/public/v2/locations/123b2980-3506-4f8c-abce-97e1ab653406/services?page=1",
    "last": "https://my.easyweek.io/api/public/v2/locations/123b2980-3506-4f8c-abce-97e1ab653406/services?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://my.easyweek.io/api/public/v2/locations/123b2980-3506-4f8c-abce-97e1ab653406/services?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Next &raquo;",
        "active": false
      }
    ],
    "path": "https://my.easyweek.io/api/public/v2/locations/123b2980-3506-4f8c-abce-97e1ab653406/services",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}