> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmarkt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant analytics

> Bearer-authenticated analytics for widgets and integrations.

All routes require:

```txt theme={null}
Authorization: Bearer mk_live_<your_key>
```

## Store summary

```http theme={null}
GET /api/merchant/v1/stores/{storeId}
```

Scopes: `store:read` or `widget:read`

## Widget metrics

```http theme={null}
GET /api/merchant/v1/stores/{storeId}/analytics
```

Scope: `widget:read`

Response:

```json theme={null}
{
  "revenue": 0,
  "revenueChange": 0,
  "orders": 0,
  "ordersChange": 0,
  "customers": 0,
  "customersChange": 0
}
```

## Chart (7 days)

```http theme={null}
GET /api/merchant/v1/stores/{storeId}/analytics/chart
```

Scope: `analytics:read`

```json theme={null}
{
  "chart": [
    { "date": "2026-09-15", "revenue": 120, "orders": 3 }
  ]
}
```

## Errors

| Status | Meaning |
| - | - |
| 401 | Missing, invalid, expired, or revoked token |
| 403 | Scope or shop not allowed for this key |
| 429 | Rate limit exceeded |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.