SalonifyDevelopers

API Reference

Business

Read the public profile and settings of a business: its name, contact details, address, booking rules, and the businesses your key's owner has access to. The business profile is the anchor for every other resource; its id is the businessId in every nested path.

Scope and plan

Reading the business profile uses the business:read scope. API keys are available on the PRO and ENTERPRISE plans. Profile editing, deletion, and billing changes are intentionally not exposed to API keys.

Retrieve a business

GET/businesses/{businessId}
business:readPRO plan

Returns the full profile for a business. This is also the canonical way to read your own configured booking rules (slot duration, buffers, advance-booking window, payment mode).

Path parameters

NameTypeRequiredDescription
businessIduuidRequiredThe business id (your key's own business).
curl "https://api.salonify.eu/api/v1/businesses/b_8f3a" \
  -H "X-API-Key: sk_live_..."
{
  "id": "b_8f3a",
  "name": "Studio Centre",
  "slug": "studio-centre",
  "description": "Modern hair studio in the heart of the city.",
  "categories": ["HAIR_SALON"],
  "email": "[email protected]",
  "phone": "+352 27 000 000",
  "website": "https://studiocentre.lu",
  "street": "Rue de la Gare",
  "houseNumber": "12",
  "city": "Luxembourg",
  "postalCode": "1611",
  "country": "LU",
  "latitude": 49.6006,
  "longitude": 6.1296,
  "slotDuration": 15,
  "slotCapacity": 1,
  "bufferTimeBefore": 0,
  "bufferTimeAfter": 0,
  "minAdvanceBooking": 60,
  "maxAdvanceBooking": 60,
  "onlinePaymentMode": "ALL",
  "acceptingBookings": true,
  "isPublic": true,
  "isVerified": true,
  "averageRating": 4.8,
  "reviewCount": 142
}

List accessible businesses

GET/businesses/my-businesses
business:readPRO plan

Returns every business the key's owner can access, with the access role (owner or staff). Useful to discover the businessId your key is bound to.

curl "https://api.salonify.eu/api/v1/businesses/my-businesses" \
  -H "X-API-Key: sk_live_..."
[
  { "id": "b_8f3a", "name": "Studio Centre", "slug": "studio-centre", "accessRole": "OWNER" },
  { "id": "b_2c19", "name": "Studio Kirchberg", "slug": "studio-kirchberg", "accessRole": "OWNER" }
]

Retrieve a business by slug

GET/businesses/slug/{slug}
business:readPRO plan

Path parameters

NameTypeRequiredDescription
slugstringRequiredThe public URL slug, e.g. studio-centre.
curl "https://api.salonify.eu/api/v1/businesses/slug/studio-centre" \
  -H "X-API-Key: sk_live_..."
{ "id": "b_8f3a", "name": "Studio Centre", "slug": "studio-centre", "city": "Luxembourg" }

Editing the business profile

Updating profile, address, booking rules, or payment settings (PATCH /businesses/{id}), and deleting a business, are done from the Salonify dashboard. They are not available to API keys, by design: changing payment or billing configuration is a protected operation.