# GET Get daily analytics counts

Returns the per-day counts the merchant admin's dashboard and Analytics charts show, for the last `days` calendar days in `timezone`, oldest first. Today is the last day and is still incomplete. Every day in the range is listed, with zero counts on a day with nothing. Requires `analytics:read`; this operation is read-only and safe to retry. The counts follow the rest of API v3: orders and products are modern rows only, as `listOrders` and `listProducts` return them, and quotes are the ones `listQuotes` returns. The admin's 30, 60 and 90 day order totals are sums of `order_count` over the last 30, 60 or 90 days.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-get-daily-analytics-counts/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-get-daily-analytics-counts.md
- Group: Analytics
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/analytics.json
- Method: GET
- Path: /api/v3/analytics/daily-counts
- Auth: Bearer token
- Required scopes: `analytics:read`

## Query parameters

- days (string, optional): The number of days, from 1 to 90, today included. Defaults to 30. Example: 30
- timezone (string, optional): The IANA timezone the days are counted in. Defaults to `UTC`. Example: Australia/Sydney

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/analytics/daily-counts?days=30&timezone=Australia%2FSydney \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 GET 200 example 1

```json
{
  "data": {
    "object": "analytics_daily_counts",
    "timezone": "Australia/Sydney",
    "days": [
      {
        "date": "2026-07-18",
        "order_count": 2,
        "product_count": 5,
        "quote_count": 1,
        "custom_design_count": 0,
        "ai_design_count": 3,
        "ordered_ai_design_count": 1
      },
      {
        "date": "2026-07-19",
        "order_count": 0,
        "product_count": 1,
        "quote_count": 0,
        "custom_design_count": 1,
        "ai_design_count": 0,
        "ordered_ai_design_count": 0
      }
    ]
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/analytics/daily-counts?days=2&timezone=Australia%2FSydney",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}
```

### 401 Missing or invalid API key

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
  "title": "Missing API key",
  "status": 401,
  "code": "missing_api_key",
  "detail": "Provide a store API key as a bearer token.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 403 Insufficient scope

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "This operation requires the analytics:read scope.",
  "required_scopes": [
    "analytics:read"
  ],
  "granted_scopes": [],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 422 Invalid days

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/invalid_parameter",
  "title": "Invalid query parameter",
  "status": 422,
  "code": "invalid_parameter",
  "detail": "days must be an integer from 1 to 90.",
  "errors": [
    {
      "parameter": "days",
      "code": "invalid_parameter",
      "detail": "days must be an integer from 1 to 90."
    }
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 429 Rate limited

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "You have exceeded the request limit for this API key.",
  "retry_after": 60,
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```
