ServiceReserve

Developer

API

List business profiles

Paginated list of the business profiles (locations) in the workspace, with address, linked form, and Reserve with Google flag.

Updated Sep 30, 2026

Returns the business profiles in the workspace. A business profile is a service location, usually assigned to a booking form. Deleted profiles are left out. The default profile comes first, then the rest, newest first.

GET/api/v1/profiles
Business profiles (locations) in the authenticated workspace.

Query parameters

page
integer (default 1)
1-indexed page number.
per_page
integer (default 25)
Items per page. Maximum 100.
form_id
uuid
Only profiles assigned to this booking form.

Example request

curl https://api.servicereserve.com/api/v1/profiles \
-H "Authorization: Bearer $SERVICERESERVE_API_KEY"

Example response

{
"items": [
  {
    "id": "52c58cc6-c7fb-4419-ad88-9c4a0e89ad2f",
    "title": "Pacific Plumbing & Heating",
    "form_id": "bd28906b-7f9a-4aaf-ab86-85c1a1ccd4f2",
    "service_area_id": "7b8c9d0e-1f2a-4b3c-9d4e-5f6a7b8c9d0e",
    "service_template_id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
    "service_schedule_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
    "primary_phone": "+15555550188",
    "website_url": "https://example.com",
    "address": "434 Northwest 1st Avenue",
    "address_city": "Fort Lauderdale",
    "address_state": "FL",
    "is_default": true,
    "source": "google",
    "reserve_with_google": true,
    "created_at": "2025-11-04T19:01:13.000Z",
    "updated_at": "2026-09-12T15:40:02.000Z"
  }
],
"pagination": { "page": 1, "per_page": 25, "total": 1 }
}

Pass a profile's id as business_profile_id to List requests to scope requests to one location. form_id must be a valid UUID.

Reserve with Google

reserve_with_google is the profile's Reserve with Google toggle. It changes only when someone on your team turns it on or off. It can only be turned on while the workspace has an active trial or subscription and the profile has a title plus a full street address (with ZIP), city, and state.

If the workspace's plan expires, the flag keeps its stored value, but ServiceReserve stops sending Reserve with Google conversions for new bookings. The booking page keeps working.

Field reference

id
uuid
Profile id.
title
string | null
Business name shown for the location.
form_id
uuid | null
Booking form the profile is assigned to.
service_area_id, service_template_id, service_schedule_id
uuid | null
Location-specific service area, services, and schedule, when set.
primary_phone, website_url
string | null
Contact details for the location.
address, address_city, address_state
string | null
Street address, city, and state.
is_default
boolean
true for the workspace's default profile.
source
string | null
How the profile was created: manual for profiles added by hand, google or gbp for profiles imported from Google Business Profile.
reserve_with_google
boolean
Reserve with Google toggle for this profile.
created_at, updated_at
ISO 8601 string | null
Row timestamps.

The endpoint shares the 1 request per second per key rate limit.

Related

Authentication

Authenticate ServiceReserve API requests with a Bearer key issued from your workspace, and handle rate limits and errors.

List forms

Paginated list of the booking forms in the workspace, with default flag, linked template ids, and per-form settings.