---
title: "Search published businesses"
method: GET
path: "/businesses"
tags: ["discovery"]
---

# Search published businesses

`GET /businesses`

## Request

- Base URL: `https://agentbookable.com`
- URL: `https://agentbookable.com/businesses`
- Auth: none declared

Search the AgentBookable registry. Falls back to legacy seeded businesses when the registry has no matches. Returns capability flags for each business.

## Query parameters

- `query` string
- `category` string
- `city` string
- `country` string
- `service` string
- `latitude` number
- `longitude` number
- `radiusKm` number

## Response `200`

Matching published businesses

- Business[]
  - `id` string
  - `name` string
  - `slug` string, nullable
  - `category` string, nullable
  - `description` string, nullable
  - `location` object
    - `city` string
    - `postcode` string
    - `country` string
  - `timezone` string
  - `provider` object
    - `type` 'registry' | 'calcom' | 'zoho' | 'simplybook': Internal provider family. Providers are never exposed by name to agents.
  - `capabilities` Capabilities: What is possible for this business. Agents MUST respect these: do not promise actions whose flag is false.
    - `services` boolean: Service listing supported.
    - `availability` boolean: Live availability lookup supported. When true you may call POST /businesses/{id}/availability.
    - `booking` boolean: Booking creation supported. When true you may call POST /bookings (with a mandate).
    - `reschedule` boolean: Rescheduling supported. When false, never offer to move an appointment.
    - `cancellation` boolean: Cancellation supported. When false, never offer to cancel.
    - `payment` boolean: Payment through AgentBookable. When false, payment (if any) is handled at the venue.
    - `instantConfirmation` boolean: True when bookings are confirmed immediately; false means the provider may hold requests for manual confirmation.

## Other responses

- `429`: Too many requests — slow down

---

[API](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents.md) · [All operations](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/revisions/736963f5951a?raw)