action squareup_retrieve_business_booking_profile { label: "RetrieveBusinessBookingProfile" description: "Retrieves a seller's booking profile." provider: squareup method: GET path: "/v2/bookings/business-booking-profile" encoding: json output: { type: "object" properties: { business_booking_profile: { type: "object" properties: { allow_user_cancel: { type: "boolean" description: "Indicates whether customers can cancel or reschedule their own bookings (`true`) or not (`false`)." } booking_enabled: { type: "boolean" description: "Indicates whether the seller is open for booking." } booking_policy: { type: "string" description: "The policy for the seller to automatically accept booking requests (`ACCEPT_ALL`) or not (`REQUIRES_ACCEPTANCE`)." } business_appointment_settings: { type: "object" description: "The service appointment settings, including where and how the service is provided." properties: { alignment_time: { type: "string" description: "The time unit of the service duration for bookings." } any_team_member_booking_enabled: { type: "boolean" description: "Indicates whether a customer can choose from all available time slots and have a staff member assigned\nautomatically (`true`) or not (`false`)." } cancellation_fee_money: { type: "object" description: "Represents an amount of money. `Money` fields can be signed or unsigned.\nFields that do not explicitly define whether they are signed or unsigned are\nconsidered unsigned and can only hold positive amounts. For signed fields, the\nsign of the value indicates the purpose of the money transfer. See\n[Working with Monetary Amounts](https://developer.squareup.com/docs/build-basics/working-with-monetary-amounts)\nfor more information." properties: { amount: { type: "integer" format: "int64" description: "The amount of money, in the smallest denomination of the currency\nindicated by `currency`. For example, when `currency` is `USD`, `amount` is\nin cents. Monetary amounts can be positive or negative. See the specific\nfield description to determine the meaning of the sign in a particular case." } currency: { type: "string" description: "The type of currency, in __ISO 4217 format__. For example, the currency\ncode for US dollars is `USD`.\n\nSee [Currency](https://developer.squareup.com/reference/square_2021-08-18/enums/Currency) for possible values." } } } cancellation_policy: { type: "string" description: "The cancellation policy adopted by the seller." } cancellation_policy_text: { type: "string" description: "The free-form text of the seller's cancellation policy." } cancellation_window_seconds: { type: "integer" description: "The cut-off time in seconds for allowing clients to cancel or reschedule an appointment." } location_types: { type: "array" description: "Types of the location allowed for bookings." items: { type: "string" } } max_appointments_per_day_limit: { type: "integer" description: "The maximum number of daily appointments per team member or per location." } max_appointments_per_day_limit_type: { type: "string" description: "Indicates whether the daily appointment limit applies to team members or to\nbusiness locations." } max_booking_lead_time_seconds: { type: "integer" description: "The maximum lead time in seconds before a service can be booked. Bookings must be created at most this far ahead of the booking's starting time." } min_booking_lead_time_seconds: { type: "integer" description: "The minimum lead time in seconds before a service can be booked. Bookings must be created at least this far ahead of the booking's starting time." } multiple_service_booking_enabled: { type: "boolean" description: "Indicates whether a customer can book multiple services in a single online booking." } skip_booking_flow_staff_selection: { type: "boolean" description: "Indicates whether customers has an assigned staff member (`true`) or can select s staff member of their choice (`false`)." } } } created_at: { type: "string" description: "The RFC 3339 timestamp specifying the booking's creation time." } customer_timezone_choice: { type: "string" description: "The choice of customer's time zone information of a booking.\nThe Square online booking site and all notifications to customers uses either the seller location’s time zone\nor the time zone the customer chooses at booking." } seller_id: { type: "string" description: "The ID of the seller, obtainable using the Merchants API." } } } errors: { type: "array" description: "Any errors that occurred during the request." items: { type: "object" description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information." required: ["category", "code"] properties: { category: { type: "string" description: "The high-level category for the error." } code: { type: "string" description: "The specific code of the error." } detail: { type: "string" description: "A human-readable description of the error for debugging purposes." } field: { type: "string" description: "The name of the field provided in the original request (if any) that\nthe error pertains to." } } } } } } }