# get_business_overview

OWNER ONLY. Read booking totals, conversion, no-show rates and estimated commission savings for the last days (default 30). Money values use minor currency units; commission savings are estimates. Requires business ownership.

Canonical: https://bookwise.live/docs/tools/get_business_overview

Version: 1.1.0
Scope: Directory + business
Authentication: Owner session
Category: Owner operations

## Parameters

- **businessId** (string; required): Published business ID from search_businesses, or the business's booking-page slug (e.g. "studio-nine"); owner calls may also use the business ID shown in the dashboard.
- **days** (integer; optional): Number of trailing days used for dashboard metrics, 1–366.

## Example MCP call

Replace placeholders with returned IDs and saved credentials. Example dates must be replaced with the customer's future dates.

```json
{
  "name": "get_business_overview",
  "arguments": {
    "businessId": "<businessId>"
  }
}
```

## Input JSON Schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "businessId": {
      "type": "string",
      "minLength": 1,
      "description": "Published business ID from search_businesses, or the business's booking-page slug (e.g. \"studio-nine\"); owner calls may also use the business ID shown in the dashboard."
    },
    "days": {
      "default": 30,
      "description": "Number of trailing days used for dashboard metrics, 1–366.",
      "type": "integer",
      "minimum": 1,
      "maximum": 366
    }
  },
  "required": [
    "businessId"
  ]
}
```

## Output JSON Schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "businessId": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "days": {
          "type": "number"
        },
        "since": {
          "type": "string"
        },
        "until": {
          "type": "string"
        }
      },
      "required": [
        "days",
        "since",
        "until"
      ],
      "additionalProperties": false
    },
    "totals": {
      "type": "object",
      "properties": {
        "bookings": {
          "type": "number"
        },
        "confirmed": {
          "type": "number"
        }
      },
      "required": [
        "bookings",
        "confirmed"
      ],
      "additionalProperties": false
    },
    "conversion": {
      "type": "object",
      "properties": {
        "attempts": {
          "type": "number"
        },
        "converted": {
          "type": "number"
        },
        "rate": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "attempts",
        "converted",
        "rate"
      ],
      "additionalProperties": false
    },
    "noShow": {
      "type": "object",
      "properties": {
        "noShows": {
          "type": "number"
        },
        "finished": {
          "type": "number"
        },
        "rate": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "noShows",
        "finished",
        "rate"
      ],
      "additionalProperties": false
    },
    "commission": {
      "type": "object",
      "properties": {
        "bps": {
          "type": "number"
        },
        "directRevenueMinor": {
          "type": "number"
        },
        "estimatedSavedMinor": {
          "type": "number"
        },
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "bps",
        "directRevenueMinor",
        "estimatedSavedMinor",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "businessId",
    "currency",
    "timezone",
    "period",
    "totals",
    "conversion",
    "noShow",
    "commission"
  ],
  "additionalProperties": false
}
```

## Annotations

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

On failure, inspect isError and content; domain errors may include structuredContent.code, retryable, details.fields or alternatives. Annotations are behavior hints, not authorization.