---
title: "Per-location appointment summary"
method: GET
path: "/analytics"
tags: ["Analytics"]
---

# Per-location appointment summary

`GET /analytics`

## Request

- Base URL: `https://simpledock.ai/api/v1`
- URL: `https://simpledock.ai/api/v1/analytics`
- Auth: HTTP bearer

Summarize appointments at one location over a date range: totals, counts by status, and counts by appointment type. The range may not exceed 366 days.

## Query parameters

- `locationId` string, required
- `from` string, date-time
- `to` string, date-time

## Response `200`

Success

- object
  - `data` AnalyticsSummary, required
    - `locationId` string
    - `timezone` string
    - `from` string, date-time
    - `to` string, date-time
    - `total` integer
    - `byStatus` object
    - `byType` object[]
      - `appointmentTypeId` string
      - `name` string, nullable
      - `count` integer

## Other responses

- `401`: Unauthorized — missing, invalid, or expired key
- `402`: Payment required — a Pro feature or a Free plan limit
- `403`: Forbidden — key is missing the required scope
- `404`: Not found
- `429`: Rate limited — slow down and retry after Retry-After

---

[API](https://skmtc.dev/simpledock/apis/simpledock-api.md) · [All operations](https://skmtc.dev/simpledock/apis/simpledock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/simpledock/apis/simpledock-api/revisions/d6e8fedfc000?raw)