OpenApi
  1. Services
  • Branches
    • List active branches
      GET
    • Get a branch's service tree
      GET
  • Services
    • Get available appointment slots
      GET
  • Tickets
    • Book a ticket (walk-in or appointment)
      POST
    • Fetch a ticket
      GET
    • Cancel a ticket
      POST
    • Reschedule an appointment
      POST
  • Customers
    • Create a customer
      POST
    • List customers (paginated)
      GET
    • Fetch one customer
      GET
    • Update a customer
      PUT
    • Delete a customer
      DELETE
    • List a customer's tickets
      GET
  • Schemas
    • SuccessEnvelope
    • PaginatedEnvelope
    • ErrorEnvelope
    • ValidationErrorEnvelope
    • AuthErrorEnvelope
    • Pagination
    • Branch
    • BranchTreeGroup
    • Service
    • Slot
    • Ticket
    • Customer
    • CustomerWriteRequest
    • CustomerUpdateRequest
    • BookTicketRequest
    • ChangeTimeRequest
  1. Services

Get available appointment slots

GET
https://api-dev.skiplino.com/external/v1/services/{id}/slots
Returns the list of bookable appointment time slots for an appointment-enabled
service on a given day, each with the number of remaining places. Feed the returned
time values straight into POST /tickets/book as the time field.
When to use — To render an appointment time picker before booking.
Prerequisites
A service id (10-char alphanumeric) that is active and has appointment booking
enabled (isAppointment = true in the branch tree). A service that exists but does
not support appointments returns 422 with error.id = "This service does not support appointment booking.".
Behavioural notes
date is optional and defaults to today (company timezone). It must be on or
after today; past dates are rejected with 422.
Slot time values are ISO-8601 timestamps. remaining is the count of places still
available in that slot.
An empty data array means the service is appointment-enabled but has no open slots
for that date (fully booked or outside working hours).

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Query Params

Header Params

Responses

🟢200
application/json
Slots fetched successfully.
Bodyapplication/json

🟠400
🟠422
🟠401Unauthorized
🔴500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-dev.skiplino.com/external/v1/services/802b33af66/slots?date=2026-07-01' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "message": "Slots fetched successfully.",
    "data": [
        {
            "time": "2026-07-01T09:00:00.000Z",
            "remaining": 3
        },
        {
            "time": "2026-07-01T09:30:00.000Z",
            "remaining": 1
        },
        {
            "time": "2026-07-01T10:00:00.000Z",
            "remaining": 5
        }
    ]
}
Previous
Get a branch's service tree
Next
Book a ticket (walk-in or appointment)
Built with