openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

github.com/httptoolkit/openapi-directory-js

1 lines • 98.8 kB

JSON

{"openapi":"3.0.1","servers":[{"url":"https://sandbox-api.onsched.com/"}],"info":{"description":"Build secure and scalable custom apps for Online Booking. Our flexible API provides many options for availability and booking.\r\n \r\nTake the API for a test drive. Just click on the Authorize button below and authenticate. \r\nYou can access our demo company profile if you are not a customer, or your own profile by using your assigned ClientId and Secret.\r\n \r\nThe API has two interfaces, consumer and setup. \r\n<ul>\r\n<li>\r\nThe consumer interface provides all the endpoints required for implementing consumer booking flows.\r\n</li>\r\n<li>\r\nThe setup interface provides endpoints for profile configuration and setup.\r\n</li>\r\n</ul>\r\nToggle freely between the two interfaces using the swagger tool bar option labelled 'Select a definition'.\r\n","title":"OnSched Consumer API","version":"v1","x-apisguru-categories":["collaboration"],"x-logo":{"url":"https://onsched.com/img/apple-touch-icon-57x57-precomposed.ico"},"x-origin":[{"format":"openapi","url":"https://sandbox-api.onsched.com/swagger/consumer/swagger.json","version":"3.0"}],"x-providerName":"onsched.com","x-serviceName":"consumer"},"security":[{"oauth2":["OnSchedApi"]}],"paths":{"/consumer/v1/appointments":{"get":{"description":"Use this endpoint to return a List of Appointments. Use the offset and limit parameters to control the page start and number of results. Default offset is 0, limit is 20, max is 100. Use the query parameters to filter the results further. For more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointments Overview</a>","parameters":[{"description":"id of business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Filter by email address","in":"query","name":"email","schema":{"type":"string"}},{"description":"Filter by lastname or part of it","in":"query","name":"lastname","schema":{"type":"string"}},{"description":"Filter by phone number or part of it","in":"query","name":"phone","schema":{"type":"string"}},{"description":"Filter by service","in":"query","name":"serviceId","schema":{"type":"string"}},{"description":"Filter by calendar","in":"query","name":"calendarId","schema":{"type":"string"}},{"description":"Filter by resource","in":"query","name":"resourceId","schema":{"type":"string"}},{"description":"Filter by customer","in":"query","name":"customerId","schema":{"type":"string"}},{"description":"Filter by service allocation","in":"query","name":"serviceAllocationId","schema":{"type":"string"}},{"description":"Format YYYY-MM-DD. Filter by on/after startDate","in":"query","name":"startDate","schema":{"format":"date-time","type":"string"}},{"description":"Format YYYY-MM-DD. Filter on/before endDate","in":"query","name":"endDate","schema":{"format":"date-time","type":"string"}},{"description":"Filter by status: IN, BK, CN, RE, RS","in":"query","name":"status","schema":{"type":"string"}},{"description":"Filter by the email of who booked","in":"query","name":"bookedBy","schema":{"type":"string"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit, default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentListViewModel"}}},"description":"Success"}},"summary":"Get Appointments","tags":["Appointments"]},"post":{"description":"Use this endpoint to Create a new appointment. The appointment will be created with an \"IN\", Initial status. Posting an appointment with \"IN\" status requires minimal information and requires a \"PUT book\" call to complete the booking transaction, PUT /consumer/v1/appointments/{id}/book. Alternatively, you can post an appointment using the completeBooking option which completes the booking in one transaction, but it will require more data. The method you choose depends on your solutions workflow. \r\n\r\n StartDateTime and EndDateTime are required. Use the ISO 8601 format for DateTime Timezone, e.g., 2016-10-30T09:00:00-5:00\r\nA valid serviceId is required. The serviceId provided must be valid for the location being booked. A valid serviceId is one that is scoped to a Primary Company Location or is associated with a Business Location\r\nOPTIONAL FIELDS INCLUDE: \r\n\r\n locationId - if not supplied, the appointment will be posted to the primary business location. If you support multiple location, we recommend always supplying the locationId. \r\n\r\n resourceId - not required when posting with an \"IN\" status but is required when the appointment is booked. Use GET /consumer/v1/resources for a list of resources. \r\n\r\n customerId - if supplied the name and email will be retrieved from the customer record. \r\n\r\n BookedBy - if not supplied the email address of the booked appointment is used or the ip address if no email address is provided. BookedBy is used in the Appointment Audit trail which can be viewed in the appointment object.\r\n\r\n Location - is a string value representing the location of the appointment. It provides no added functionality in OnSched and should not be confused with locationId.\r\n\r\n TimezoneName - if used timezoneName must be in IANA format, America/New_York. This is the timezone the appointment was booked in. Populating this information can help later in situations where appointments are booked before a Daylight Savings change. If no timezoneName is supplied, the Business Locations timezone will be used.\r\n\r\n COMPLETE BOOKING: This parameter provides a mechanism for immediate booking with the POST appointment endpoint. To complete the booking in one transaction, populate the completeBooking parameter with a \"BK\", booked or an \"RS\", reserved status and provide an (email and name) or a customerId in the post body. Doing so will book the appointment and send notifications all in one transaction. Note: \"IN\" can also be used as a completeBooking option to support payment flows. With the \"IN\" option, notifications are NOT sent.\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointments Overview</a>","parameters":[{"description":"Options are \"BK\", \"RS\" or \"IN\"","in":"query","name":"completeBooking","schema":{"type":"string"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/AppointmentInitialModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentInitialModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/AppointmentInitialModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/AppointmentInitialModel"}}},"description":""},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentInitialViewModel"}}},"description":"Success"}},"summary":"Create Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/bookingfields":{"get":{"description":"Use this endpoint to return a locations Appointment Booking Fields. Appointment booking fields are stored with each Appointment record. They are used when you need additional information collected during your booking process. It is tied to an appointment/visit and will be stored in the appointment record. Use the field name, type, and length to determine how to update these field values when posting an appointment.","parameters":[{"description":"id of business location","in":"query","name":"locationId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingFieldListViewModel"}}},"description":"Success"}},"summary":"Get Custom Fields Labels","tags":["Appointments"]}},"/consumer/v1/appointments/customfields":{"get":{"description":"Use this endpoint to return a locations Appointment Custom Field definitions. Appointment custom fields are stored with each appointment. They are used when the information collected during the booking is specific to a particular appointment/visit. The response will list the custom fields used (customField1 - 10), the field type (string, number, date, boolean) and the length of each one.","parameters":[{"description":"id of business location","in":"query","name":"locationId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomFieldDefinitionListViewModel"}}},"description":"Success"}},"summary":"Get Custom Fields List","tags":["Appointments"]}},"/consumer/v1/appointments/{id}":{"delete":{"description":"Use this endpoint to permanently Delete an appointment. Only appointments with a of \"IN\" status, initial, can be deleted. Past dated appointments cannot be deleted. A valid appointment id is required. Use the appointment id returned from the initial POST /consumer/v1/appointments endpoint.\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointment Overview</a>","parameters":[{"description":"appointment id to delete","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentViewModel"}}},"description":"Success"}},"summary":"Delete Appointment","tags":["Appointments"]},"get":{"description":"Use this endpoint to return an Appointment object. A valid appointment id is required. For more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointments Overview</a>","parameters":[{"description":"id of appointment requested","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentViewModel"}}},"description":"Success"}},"summary":"Get Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/book":{"put":{"description":"Use this endpoint to Book an appointment. Only appointments with an \"IN\" status, Initial, can be booked. A valid appointment id is required. Use the appointment id returned from the initial POST /consumer/v1/appointments endpoint. Other pertinent fields can also be updated at the time of booking by including them in the post body. Note: If no name or email address was provided in the initial Post Appointment, it will be required in the post body.\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointments Overview</a>","parameters":[{"description":"appointment id to book","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/AppointmentBookModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentBookModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/AppointmentBookModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/AppointmentBookModel"}}},"description":""},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentViewModel"}}},"description":"Success"}},"summary":"Book Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/cancel":{"put":{"description":"Use this endpoint to Cancel an appointment booking or reservation. Only appointments with a \"BK\", booked or \"RS\", reserved status can be cancelled. Past dated appointments cannot be cancelled. A valid appointment id is required. For more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointment Overview</a>","parameters":[{"description":"appointment id to cancel","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentViewModel"}}},"description":"Success"}},"summary":"Cancel Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/confirm":{"put":{"description":"Use this endpoint to Confirm an appointment. This updates the boolean confirmed field to TRUE. NOTE: If the appointment status is set to \"RS\", Reserved, it also updates the status of the appointment to \"BK\", Booked. \r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointment Overview</a>","parameters":[{"description":"appointment id to confirm","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}},{"description":"Use this parameter to undo the confirmed status","in":"query","name":"undo","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Success"}},"summary":"Confirm Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/noshow":{"put":{"description":"Use this endpoint to change the status of an appointment from \"BK\", Booked to \"NS\", NoShow. This gives API consumers a way to internally track No Show appointments. It provides no added functionality in OnSched.\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointment Overview</a>","parameters":[{"description":"appointment id to mark as NoShow","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/AppointmentNoShowModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentNoShowModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/AppointmentNoShowModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/AppointmentNoShowModel"}}},"description":""},"responses":{"200":{"description":"Success"}},"summary":"Set NoShow Status","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/reschedule":{"put":{"description":"Use this endpoint to Reschedule an appointment booking. Only appointments in \"BK\", booked status, can be Rescheduled. Past dated appointments cannot be rescheduled. A valid appointment id is required.\r\nThe StartDateTime and EndDateTime are required. Use the ISO 8601 format for DateTime Timezone, e.g., 2016-10-30T09:00:00-5:00.\r\nThe serviceId is optional. If changing the serviceId, the new service id's duration must match the original service's duration.\r\nThe resourceId is optional. If changing the resourceId, verify the availability of the new resource prior to rescheduling.\r\n\r\n IMPORTANT: Always run availability before rescheduling an appointment to verify the timeslot is open and available for the new time, service and/or resource requested. This is the only way to assure the slot is available. You cannot reschedule an appointment to a different location. If necessary, you should cancel and then book an appointment in the other location.\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointment Overview</a>","parameters":[{"description":"appointment id to reschedule","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/AppointmentRescheduleModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentRescheduleModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/AppointmentRescheduleModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/AppointmentRescheduleModel"}}},"description":""},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentViewModel"}}},"description":"Success"}},"summary":"Reschedule Appointment","tags":["Appointments"]}},"/consumer/v1/appointments/{id}/reserve":{"put":{"description":"Use this endpoint to Reserve an appointment. Only appointments with an \"IN\" status, Initial, can be reserved. A valid appointment id is required. Use the appointment id returned from the initial POST /consumer/v1/appointments endpoint.\r\n\r\n NOTE: Reservations are different from Bookings as reservations are a two-step booking process that must be managed by the API consumer. An appointment that is reserved is not completely booked until other business conditions have been met. For example, an appointment may be reserved if it is not yet assigned to a resource or until the customer or resource explicitly confirms it.\r\nWith reservations you have the ability to notify the customer of a reservation prior to officially booking and the workflow can be designed to indicate what conditions will need to be met in order to convert the reservation to a complete booking. A reservation converts to a complete booking when it is either Confirmed or Booked. \r\n\r\n IMPORTANT: A reserved appointment time will not be released, i.e., become available to others, until it is Cancelled. The booking timer is not used with reserved appointments.\r\n\r\nFor more information: <a href=\"https://onsched.readme.io/docs/appointments-overview\">Appointments Overview</a>","parameters":[{"description":"appointment id to reserve","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"sendNotifications","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/AppointmentReserveModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/AppointmentReserveModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/AppointmentReserveModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/AppointmentReserveModel"}}},"description":""},"responses":{"200":{"description":"Success"}},"summary":"Reserve Appointment","tags":["Appointments"]}},"/consumer/v1/availability/{serviceId}/{startDate}/{endDate}":{"get":{"description":"\r\n Choose your search criteria carefully. Availability is an expensive call. If you search availability for all resources, you should only do so for a single date. If you search availability for multiple dates, you should only do so for a specific resource by specifying the optional resourceId parameter.\r\nA serviceId is required. The startDate and endDate are required and are formatted as: YYYY-MM-DD\r\nA resourceId is optional, it is recommended if known at the time of availability call.\r\n\r\n timezoneName is optional, it allows you to specify the IANA formatted name for the end user's timezone to view availability. e.g., America/New_York. NOTE: This is the recommended approach for your implementation. The \"tzOffset\" parameter remains for backward compatibility. For JavaScript, use moment.js in your client for ease of timezone detection and selection. For iOS, use the name property of the NSTimeZone returned from the localTimeZone method. For .NET, consider NodaTime or TimeZoneConverter via NuGet. \r\n\r\n duration should only be populated if you allow the end user to select a duration, otherwise the service's duration will be used.\r\n\r\n startTime and endTime are optional and are specified in military time e.g., 800 = 8:00am, 2230 = 10:30pm. Note: You will only see availability within the boundary of your business location start and end times.\r\n\r\n dayAvailability will return day level availability for the number of days requested from the start date. See GET /consumer/v1/availability/{serviceId}/{startDate}/{endDate}/days for details.\r\n\r\n firstDayAvailable only works with day availability. If set to true it will look for the first day available within the range specified by the dayAvailability parameter. The two parameters together can be a clever way to display availability for a week or month. Tip - pass in the beginning of the week or month, and available times are displayed for the first available date if exists.\r\n\r\n tzOffset allows you to pass in the timezone offset for the end user's timezone of choice, e.g., (-240) for EST. If you use this option, your application should be timezone aware. The requested timezone is specified as an offset (plus or minus) from GMT time.\r\nAvailability can be complex. For further troubleshooting refer to the: GET /consumer/v1/availability/{serviceId}/{startDate}/{endDate}/unavailable endpoint. This endpoint will show you all unavailable times for a given date range. Available times are created from any unblocked time periods. For more information: <a href=\"https://onsched.readme.io/docs/availability-overview\">Availability Overview</a>","parameters":[{"description":"Service Id for availability search","in":"path","name":"serviceId","required":true,"schema":{"type":"string"}},{"description":"Format YYYY-MM-DD: Start Date for availability search","in":"path","name":"startDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Format YYYY-MM-DD: End Date for availability search","in":"path","name":"endDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Format Military Time Start Time for availability search. Defaults to Business Hours Start","in":"query","name":"startTime","schema":{"format":"int32","type":"integer"}},{"description":"Format Military Time. End Time for availability search. Defaults to Business Hours End","in":"query","name":"endTime","schema":{"format":"int32","type":"integer"}},{"description":"Id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Resource Id for availability search","in":"query","name":"resourceId","schema":{"type":"string"}},{"description":"Resource Group Id for availability search","in":"query","name":"resourceGroupId","schema":{"type":"string"}},{"description":"Comma separated Resource Id's for availability search","in":"query","name":"resourceIds","schema":{"type":"string"}},{"description":"Round robin choice 0=none, 1=random, 2=balanced","in":"query","name":"roundRobin","schema":{"type":"string"}},{"description":"Duration of the service if different from default","in":"query","name":"duration","schema":{"format":"int32","type":"integer"}},{"description":"Booking Interval if different than the default","in":"query","name":"interval","schema":{"format":"int32","type":"integer"}},{"description":"Requested IANA timezone Id to view availability","in":"query","name":"timezoneName","schema":{"type":"string"}},{"description":"Request timezone offset to view availability","in":"query","name":"tzOffset","schema":{"format":"int32","type":"integer"}},{"description":"For calculating travel based availability, requires distance scope","in":"query","name":"destination","schema":{"type":"string"}},{"description":"Format YYYY-DD-YY: Start date for day availability, defaults to startDate","in":"query","name":"dayAvailabilityStartDate","schema":{"format":"date-time","type":"string"}},{"description":"Number of days of day availability to return","in":"query","name":"dayAvailability","schema":{"format":"int32","type":"integer"}},{"description":"Return available times for the first available day","in":"query","name":"firstDayAvailable","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityViewModel"}}},"description":"Success"}},"summary":"Get Available Times","tags":["Availability"]}},"/consumer/v1/availability/{serviceId}/{startDate}/{endDate}/days":{"get":{"description":"This endpoint will return Day Level Availability for the range of dates requested. For example, if the business is closed, or there is a public holiday this endpoint will return that the \"Day is unavailable\".\r\nDay Availability is a high-level check for Holidays and Open/Available hours of a location, service and/or resource and should be used to restrict your choices of days available in your application to improve usability and performance.\r\nA serviceId is required. The startDate and endDate are required and are formatted as: YYYY-MM-DD\r\nThe locationId is optional, however if not supplied it defaults to the Primary Business Location for open/closed hours information. It is recommended you always provide the locationId.\r\nA resourceId is optional. If used the available days will be return day availability for the resource specified.\r\nThe tzOffset parameter should be used if the appointment requester, the end user, is in a different timezone than the location or resource.","parameters":[{"description":"Service Id for day availability search","in":"path","name":"serviceId","required":true,"schema":{"type":"string"}},{"description":"Format YYYY-MM-DD: Start Date for availability search","in":"path","name":"startDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Format YYYY-MM-DD: End Date for availability search","in":"path","name":"endDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Resource Id to filter on","in":"query","name":"resourceId","schema":{"type":"string"}},{"description":"Timezone offset to view availability for","in":"query","name":"tzOffset","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityDayViewModel"}}},"description":"Success"}},"summary":"Get Available Days","tags":["Availability"]}},"/consumer/v1/availability/{serviceId}/{startDate}/{endDate}/unavailable":{"get":{"description":"This endpoint is used to show Unavailable times and provides valuable information as to why a time slot is unavailable. If you question your availability results, populate the same parameters to this endpoint to find out why.\r\nA serviceId is required. The startDate and endDate are required and are formatted as: YYYY-MM-DD\r\nLocation hours, holidays, services, resources, blocks, allocations, and appointments are just some of variables that may cause time slots to become unavailable. Use this endpoint to understand why you don't see availability.","parameters":[{"description":"Service Id for availability search","in":"path","name":"serviceId","required":true,"schema":{"type":"string"}},{"description":"Format YYYY-MM-DD: Start Date for unavailable time search","in":"path","name":"startDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Format YYYY-MM-DD: End Date for unavailable time search","in":"path","name":"endDate","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"Id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Resource Id to filter on","in":"query","name":"resourceId","schema":{"type":"string"}},{"description":"Duration of the service if different from default","in":"query","name":"duration","schema":{"format":"int32","type":"integer"}},{"description":"Request timezone offset to view unavailable times","in":"query","name":"tzOffset","schema":{"format":"int32","type":"integer"}},{"description":"Set as true to remove Time Past (TP) blocks in the response","in":"query","name":"skipTimePastUnavailability","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnavailableTimeListViewModel"}}},"description":"Success"}},"summary":"Get Unavailable Times","tags":["Availability"]}},"/consumer/v1/customers":{"get":{"description":"Use this endpoint to return a List of Customers. The results are returned in pages. Use the offset and limit parameters to control the page start and number of results. Default offset is 0, limit is 20, max is 100. Use the query parameters to filter the results further.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Filter by groupId","in":"query","name":"groupId","schema":{"type":"string"}},{"description":"Filter by email address","in":"query","name":"email","schema":{"type":"string"}},{"description":"Filter by lastname","in":"query","name":"lastname","schema":{"type":"string"}},{"description":"Filter by deleted status","in":"query","name":"deleted","schema":{"type":"boolean"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerListViewModel"}}},"description":"Success"}},"summary":"List Customers","tags":["Customers"]},"post":{"description":"Use this endpoint to Create a new Customer. A customer object is automatically created with the first appointment booking if it doesn't already exist. If not specified, the business location id defaults to the primary business location.\r\nRequired Fields: Email and Name or First and Lastname depending on customer type. Type 0 = Person, Type 1 = Business. For type 0, the firstname and lastname fields are used. For type 1, the Name field is used, and the name field is also used to populate the lastname.","requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/CustomerInputModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/CustomerInputModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/CustomerInputModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/CustomerInputModel"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerViewModel"}}},"description":"Success"}},"summary":"Create Customer","tags":["Customers"]}},"/consumer/v1/customers/bookingfields":{"get":{"description":"Use this endpoint to return Customer Booking Fields. Customer booking fields are stored with each customer object. They are used when the information collected during the booking is for a particular customer. Customer Booking Fields include any custom customer fields you define and want to capture with the Booking.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingFieldListViewModel"}}},"description":"Success"}},"summary":"Get Customer Booking Fields","tags":["Customers"]}},"/consumer/v1/customers/countries":{"get":{"description":"Use this endpoint to return a List of Countries with their associated Country Code. Country codes are based on the 2-character ANSI standard. If your countries of operation are not currently listed, contact us at support@onsched.com.","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CountryViewModel"},"type":"array"}}},"description":"Success"}},"summary":"List Country Codes","tags":["Customers"]}},"/consumer/v1/customers/customfields":{"get":{"description":"Use this endpoint to return Customer Custom Fields. Customer custom fields are stored with the customer object. They are used when the information collected during the booking is specific to a particular customer.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"A true/false indicator to filter on custom fields used for lead questions","in":"query","name":"leadQuestions","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomFieldDefinitionListViewModel"}}},"description":"Success"}},"summary":"Get Customer Custom Fields","tags":["Customers"]}},"/consumer/v1/customers/states":{"get":{"description":"Use this endpoint to return a List of Countries with their associated State Codes. Supply a country code to filter results further. If states for your countries of operation are not currently listed, contact us at support@onsched.com.","parameters":[{"in":"query","name":"country","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/StateViewModel"},"type":"array"}}},"description":"Success"}},"summary":"List Country States","tags":["Customers"]}},"/consumer/v1/customers/{id}":{"delete":{"description":"Use this endpoint to permanently Delete a Customer object. A valid customer id is required.","parameters":[{"description":"id of customer object","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}},"summary":"Delete Customer","tags":["Customers"]},"get":{"description":"Use this endpoint to return a Customer object. A valid customer id is required. Find customer id's by using the GET /consumer/v1/customers endpoint.","parameters":[{"description":"id of customer object","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerViewModel"}}},"description":"Success"}},"summary":"Get Customer","tags":["Customers"]},"put":{"description":"Use this endpoint to Update a Customer object. A valid customer id is required. Note: Blank fields are not changed.","parameters":[{"description":"id of customer object","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/*+json":{"schema":{"$ref":"#/components/schemas/CustomerUpdateModel"}},"application/json":{"schema":{"$ref":"#/components/schemas/CustomerUpdateModel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/CustomerUpdateModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/CustomerUpdateModel"}}}},"responses":{"200":{"description":"Success"}},"summary":"Update Customer","tags":["Customers"]}},"/consumer/v1/locations":{"get":{"description":"Use this endpoint to return a List of Business Locations. The results are returned in pages. Use the offset and limit parameters to control the page start and size. Default offset is 0, and limit is 20 and maximum is 100. Use the other query parameters to filter the results further. \r\n\r\n IMPORTANT DEPRECATION NOTICE: The following online settings parameters were intended for internal use in our Portal application only. They will be deprecated on OCTOBER 15, 2022. These fields are currently part of the SETTINGS object in all location endpoints: businessId, enabled, familyMembersEnabled, serviceLabel, resourceLabel, resourceAnyLabel, resourceSelection, liveMode, formFlow, availabilityForm, showServiceGroups, showOnSchedLogo, showBusinessLogo, disableAuthorization, hideNavBar, hideLocationNav, hideServiceGroupsNav, hideServicesNav, hideContinueBooking, returnToService, returnToAvailability, hideBreadCrumbNav. If you are using these fields, please adjust your code to handle the deprecation or let us know by submitting a ticket to: support@onsched.com as we do not want to interrupt your existing workflows.","parameters":[{"description":"Location name (full or partial)","in":"query","name":"name","schema":{"type":"string"}},{"description":"Search by distance nearest Geocoords, City, Postal/Zip Code","in":"query","name":"nearestTo","schema":{"type":"string"}},{"description":"Maximum distance to display","in":"query","name":"proximity","schema":{"format":"int32","type":"integer"}},{"description":"Distance either imperial(miles), metric(kilometers)","in":"query","name":"units","schema":{"type":"string"}},{"description":"Locations that offer this service","in":"query","name":"serviceId","schema":{"type":"string"}},{"description":"Frienldy Id of location","in":"query","name":"friendlyId","schema":{"type":"string"}},{"description":"Locations within a specific region","in":"query","name":"regionId","schema":{"type":"string"}},{"description":"Don't include the Primary Location","in":"query","name":"ignorePrimary","schema":{"type":"boolean"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit, default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationListViewModel"}}},"description":"Success"}},"summary":"List Locations","tags":["Locations"]}},"/consumer/v1/locations/{id}":{"get":{"description":"Use this endpoint to return a Location object. A valid business location id is required. Find all location id's by using the GET /consumer/v1/locations endpoint.\r\n\r\n IMPORTANT DEPRECATION NOTICE: The following online settings parameters were intended for internal use in our Portal application only. They will be deprecated on OCTOBER 15, 2022. These fields are currently part of the SETTINGS object in all location endpoints: businessId, enabled, familyMembersEnabled, serviceLabel, resourceLabel, resourceAnyLabel, resourceSelection, liveMode, formFlow, availabilityForm, showServiceGroups, showOnSchedLogo, showBusinessLogo, disableAuthorization, hideNavBar, hideLocationNav, hideServiceGroupsNav, hideServicesNav, hideContinueBooking, returnToService, returnToAvailability, hideBreadCrumbNav. If you are using these fields, please adjust your code to handle the deprecation or let us know by submitting a ticket to: support@onsched.com as we do not want to interrupt your existing workflows.","parameters":[{"description":"id of business location","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationViewModel"}}},"description":"Success"}},"summary":"Get Location","tags":["Locations"]}},"/consumer/v1/resourcegroups":{"get":{"description":"Use this endpoint to return a list of Resource Groups for the requested location. If not specified, the business location defaults to the primary business location.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Filter results by deleted status","in":"query","name":"deleted","schema":{"type":"boolean"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceGroupListViewModel"}}},"description":"Success"}},"summary":"List Resource Groups","tags":["ResourceGroups"]}},"/consumer/v1/resourcegroups/{id}":{"get":{"description":"Use this endpoint to return a Resource Group object. A valid resourceGroup id is required. Find resourceGroup id's by using the GET /consumer/v1/resourceGroups endpoint.","parameters":[{"description":"id of the resourceGroup object","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceGroupViewModel"}}},"description":"Success"}},"summary":"Get Resource Group","tags":["ResourceGroups"]}},"/consumer/v1/resources":{"get":{"description":"Use this endpoint to return a List of Resources associated with a business location. If not specified, the business location defaults to the primary business location. The results are returned in pages. Use the offset and limit parameters to control the page start and number of results. Default offset is 0, limit is 20, max is 100. Use the query parameters to filter the results further.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Filter by groupId","in":"query","name":"resourceGroupId","schema":{"format":"int32","type":"integer"}},{"description":"Filter by email address","in":"query","name":"email","schema":{"type":"string"}},{"description":"Search by name, supports Partial name search","in":"query","name":"name","schema":{"type":"string"}},{"description":"Specify sort order of response","in":"query","name":"sortOrder","schema":{"type":"string"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceListViewModel"}}},"description":"resource object"},"400":{"description":"Missing or invalid values in the request"},"404":{"description":"Resource was not found"}},"summary":"List Resources","tags":["Resources"]}},"/consumer/v1/resources/{id}":{"get":{"description":"Use this endpoint to return a Resource object. A valid resource id is required. Find resource id's by using the GET consumer/v1/resources endpoint. ","parameters":[{"description":"id of resource object","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceViewModel"}}},"description":"Success"}},"summary":"Get Resource","tags":["Resources"]}},"/consumer/v1/resources/{id}/services":{"get":{"description":"Use this endpoint to get a List of Linked Services associated with the resource requested. The results are returned in pages. Use the offset and limit parameters to control the page start and size. Default offset is 0, limit is 20, the maximum limit is 100. Use the other query parameters to filter the results further.\r\nResource linked services are used to explicitly define the services that can be booked for a specified resource. By default, all services are bookable for any resource. For more information: <a href=\"https://docs.onsched.com/docs/linked-services\">Linked Services Overview</a>","parameters":[{"description":"id of resource object","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceServiceListViewModel"}}},"description":"list of resource services"},"400":{"description":"Missing or invalid values in the request"},"401":{"description":"Unauthorized request"},"404":{"description":"Resource was not found"}},"summary":"Get Resource Linked Services","tags":["Resources"]}},"/consumer/v1/servicegroups":{"get":{"description":"Use this endpoint to return a list of Service Groups for the requested location. If not specified, the business location defaults to the primary business location. Use the offset and limit parameters to control the page start and size. Default offset is 0, limit is 20, maximum is 100. Use the other query parameters to filter the results further.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceGroupListViewModel"}}},"description":"Success"}},"summary":"List Service Groups","tags":["ServiceGroups"]}},"/consumer/v1/servicegroups/{id}":{"get":{"description":"Use this endpoint to return a Service Group object. A valid serviceGroup id is required. Find serviceGroup id's by using the GET /consumer/v1/serviceGroups endpoint.","parameters":[{"description":"id of the serviceGroup object","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceGroupViewModel"}}},"description":"Success"}},"summary":"Get Service Group","tags":["ServiceGroups"]}},"/consumer/v1/services":{"get":{"description":"Use this endpoint to List Services available at your business location and/or company. If not specified, the business location defaults to the primary business location. Use the offset and limit parameters to control the page start and number of results. Default offset is 0, limit is 20, max is 100. Use the query parameters to filter the results further.","parameters":[{"description":"id of business location, defaults to primary business location","in":"query","name":"locationId","schema":{"type":"string"}},{"description":"Filter by groupId","in":"query","name":"serviceGroupId","schema":{"format":"int32","type":"integer"}},{"description":"Filter by default service, default is false","in":"query","name":"defaultService","schema":{"type":"boolean"}},{"description":"Search All Locations, default is false","in":"query","name":"allLocations","schema":{"type":"boolean"}},{"description":"Filter by scope, Company, Location or All, default is All","in":"query","name":"scope","schema":{"$ref":"#/components/schemas/ServicesScope"}},{"description":"Filter by Name, supports Partial name search","in":"query","name":"name","schema":{"type":"string"}},{"description":"Filter by ServiceId, using this parameter would ignore all other parameters","in":"query","name":"serviceId","schema":{"type":"string"}},{"description":"Starting row of page, default 0","in":"query","name":"offset","schema":{"format":"int32","type":"integer"}},{"description":"Page limit default 20, max 100","in":"query","name":"limit","schema":{"format":"int32","type":"integer"}},{"description":"Sort results using Natural Sort or Sorted alphabetically by Service Names, default is natural","in":"query","name":"sortOrder","schema":{"$ref":"#/components/schemas/ServiceSortOrder"}},{"description":"Sort results in Descending Order, default true","in":"query","name":"sortDescending","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceListViewModel"}}},"description":"Success"}},"summary":"List Services","tags":["Services"]}},"/consumer/v1/services/allocations/{id}":{"get":{"description":"Use this endpoint to return a Service Allocation object. A valid serviceAllocation id is required. Find service allocation id's by using the GET/consumer/v1/services/{id}/allocations endpoint.","parameters":[{"description":"id of serviceAllocation object","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceAllocationViewModel"}}},"description":"Success"}},"summary":"Get Service Allocation","tags":["Services"]}},"/consumer/v1/services/{id}":{"get":{"description":"Use this endpoint to return a Service object. A valid service id is required. Find service id's by using the GET /consumer/v1/services endpoint.","parameters":[{"description":"id of service object","in":"path","name":"id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceViewModel"}}},"description":"Success"}},"summary":"Get Service","tags":["Services"]}},"/consumer/v1/services/{id}/allocations":{"get":{"description":"Use this endpoint to return a List of Service Allocations associated with the requested service. A valid service id is required. Allocations are used for Event type services/bookings. Retrieve all allocations for a location by passing in zero as the service id. Otherwise, to get allocations for a specific service supply the service id. Use the offset and limit parameters to control the page start and number of results. Default offset