← capabilitiesscheduling.read

list_services

booking.list_services · v0.1.0

Return the bookable service catalog for a Bookio provider.

Semantics

Read-only. Returns each service offered by the provider with id, name, description, duration in minutes, price (when set), and recommended staff (when applicable). The `id` returned here is the input to `service_id` on `check_availability`, `create_booking`, and `cancel_booking`.

Invariants

  • Pure read. No state change.
  • Service ids are stable.

When to use

Always before `check_availability` and `create_booking` when the user has not specified a service_id. Lets the agent confirm the user actually wants a service this provider offers.

Input schema

{
  "type": "object",
  "properties": {
    "agent_vendor": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "services": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "duration_minutes"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "duration_minutes": {
            "type": "number"
          }
        }
      }
    },
    "timezone": {
      "type": "string"
    }
  }
}

Recent conformance runs

passprovidertestmswhen
bookio:verde-wellness-austinhappy_path3505-18 19:49
bookio:studio-sanghahappy_path3205-18 19:49
bookio:salon-aurorahappy_path4605-18 19:49
bookio:massage-relaxhappy_path3805-18 19:49
bookio:ink-quarter-portlandhappy_path4205-18 19:49
bookio:ink-househappy_path4205-18 19:49
bookio:fitness-zelenahappy_path4005-18 19:49
bookio:dental-vinohradyhappy_path3805-18 19:49
bookio:bistro-modra-houbahappy_path4605-18 19:49
bookio:aurora-hair-brooklynhappy_path75305-18 19:49