---
title: "Get fan analytics"
method: GET
path: "/v1/analytics/fans"
tags: ["analytics"]
---

# Get fan analytics

`GET /v1/analytics/fans`

## Query parameters

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

## Response `200`

Aggregate customer fan analytics for the requested time range.

- object
  - `fansAdded` integer, required — Fans added during the requested range.
  - `totalFans` integer, required — Customer fan count at the end of the range.
  - `unsubscribed` integer, required — Fans who unsubscribed during the requested range.

## Other responses

- `400` — The request body is malformed.
- `401` — The integrator credential or customer API key is invalid.
- `403` — The customer account behind the API key has no paid Laylo plan.
- `404` — No route matches the requested path.
- `405` — The path exists, but the HTTP method is not supported.
- `409` — The request conflicts with the current resource state.
- `429` — The per-integrator rate limit for this operation is exceeded.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/laylo/apis/laylo-api.md) · [All operations](https://skmtc.dev/laylo/apis/laylo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/laylo/laylo-api/revisions/000d81a01b74/schema)