API Documentation

v1.0

Overview

The SMEE Embed API allows you to integrate booking functionality into your website. Use these endpoints to build a custom booking experience or integrate with your existing systems.

Base URL: https://withsmee.com/api/embed

Authentication

All API requests require your API key in the URL path. You can find your API key in Settings → Profile.

Example request:

GET https://withsmee.com/api/embed/YOUR_API_KEY/services

Services

Retrieve available services for booking

Staff

Retrieve staff members who accept bookings

Availability

Check available time slots

Bookings

Create, retrieve, and manage bookings

Customers

Manage customer records and booking history

Payments

Payment history and revenue data

Error Codes

HTTP status codes and error responses

CodeDescription
200Success
400Bad Request — Invalid parameters or missing required fields
401Unauthorized — Invalid API key
404Not Found — Resource does not exist
409Conflict — Time slot is no longer available
500Internal Server Error

Error Response Format

{
  "error": {
    "code": "SLOT_UNAVAILABLE",
    "message": "This time slot is no longer available"
  }
}