Join the waitlist
Bookables

Get a bookable's booking profile by type + external id

GET
/v1/bookables/{type}/{externalId}/profile

Same browser-safe booking profile, addressed by the customer's own key (type + external id) within the publishable key's project. Authenticated by the X-Publishable-Key header

Authorization

PublishableKey
headerX-Publishable-Key<token>

Browser-safe publishable key (pk_live_…) that scopes a public, read-only booking-profile read to one project. Not a secret; grants no writes

Path Parameters

type*string

Customer-defined entity type, e.g. "listing" or "doctor"

Match^[a-z][a-z0-9_]{0,63}$
externalId*string

The entity's id in the customer's database

Length1 <= length <= 255

Response Body

The booking profile

application/json
  1. response

The server-derived, booking-safe view of a bookable: display identity, project chrome and bookable offerings. Never contains the raw attribute bag

title*string

Display name of the bookable

photoUrl?string
bio?string
chrome*

Project-level presentation the booking page renders around a profile

offerings*array<>
Example Request
curl -X GET 'https://api.slotr.dev/v1/bookables/string/string/profile'
Example Response
{
  "title": "string",
  "photoUrl": "string",
  "bio": "string",
  "chrome": {
    "brandLogoUrl": "string",
    "theme": "string",
    "timezone": "string",
    "currency": "string",
    "locale": "string"
  },
  "offerings": [
    {
      "id": "string",
      "name": "string",
      "priceAmount": 0,
      "currency": "string",
      "durationMin": 0,
      "availability": [
        {
          "dayOfWeek": 0,
          "startTime": "string",
          "endTime": "string"
        }
      ]
    }
  ]
}

Get a bookable's booking profile by its Slotr id GET

Public, read-only booking profile of one bookable, identified by its Slotr id. No credential required — the id is a globally-unique, unguessable capability (a shareable booking link). Derived server-side from the indexed data and field map; exposes only booking-safe display fields and active offerings, never the raw attribute bag. Price always comes from the server

Create or replace one bookable PUT

Creates the bookable or fully replaces its name, status and attributes, keyed by type and externalId. Use it to index or update a single object from your database; the type is created on first use. Sending status active restores an archived entity