---
title: "Get a business record"
method: GET
path: "/businesses/{businessId}"
tags: ["discovery"]
---

# Get a business record

`GET /businesses/{businessId}`

## Request

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

Normalized details + capability flags. Accepts an `ab_bus_*` id or a public slug (e.g. `agentbookable-demo`). Always read `capabilities` before attempting actions.

## Path parameters

- `businessId` string, required

## Response `200`

The business record

- 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

- `404`: Business not found
- `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)