---
title: "Enrichment analytics roll-up"
method: GET
path: "/business/analytics/enrichment"
tags: ["Analytics"]
---

# Enrichment analytics roll-up

`GET /business/analytics/enrichment`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/analytics/enrichment`
- Auth: HTTP basic

Data-enrichment insights for every user whose contacts the token owner can see: distinct contacts whose email was enriched, whose phone was enriched, that were saved, and prospects searched (derived from Prospect Search credit spend), each as a total for the window plus a zero-filled series. Buckets are daily (mode 'daily') for 7d and ISO-weekly (mode 'weekly') for 30d and 90d; each point's date is its bucket's start date as a display label ('Jan 1') with the same date as YYYY-MM-DD in isoDate. enrichment is null when the aggregation fails. Rate limit: 20 requests per minute, 1000 per day.

Errors:
- `422` `VALIDATION_FAILED` — `range` was sent and is not one of 7d, 30d or 90d.
- `429` `RATE_LIMITED` — Per-user quota for this endpoint family exceeded (20 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds.

Requires one of the following token scopes: analytics.

## Query parameters

- `range` '7d' | '30d' | '90d': Rolling window ending now: 7d, 30d (default) or 90d, i.e. the roll-up covers the last 7, 30 or 90 days; time-series bucket sizes (daily, weekly, monthly) are chosen from the window length.
- `timezone` string: IANA timezone name (e.g. `Europe/Kyiv`, `America/New_York`) whose calendar days the time series is bucketed by: each bucket's `isoDate` / `date` is a local day, week, month or quarter in this zone. Offsets such as `+03:00` are rejected. Default: `UTC`.

## Response `200`

Success

- object
  - `range` '7d' | '30d' | '90d', required
  - `enrichment` object, nullable, required
    - `emailsEnriched` object, required
      - `totalSince` integer, required
      - `mode` 'daily' | 'weekly' | 'monthly' | 'quarterly', required
      - `series` object[], required
        - `date` string, required
        - `isoDate` string, required
        - `total` integer, required
    - `phonesEnriched` object, required
      - `totalSince` integer, required
      - `mode` 'daily' | 'weekly' | 'monthly' | 'quarterly', required
      - `series` object[], required
        - `date` string, required
        - `isoDate` string, required
        - `total` integer, required
    - `contactsSaved` object, required
      - `totalSince` integer, required
      - `mode` 'daily' | 'weekly' | 'monthly' | 'quarterly', required
      - `series` object[], required
        - `date` string, required
        - `isoDate` string, required
        - `total` integer, required
    - `contactsSearched` object, required
      - `totalSince` integer, required
      - `mode` 'daily' | 'weekly' | 'monthly' | 'quarterly', required
      - `series` object[], required
        - `date` string, required
        - `isoDate` string, required
        - `total` integer, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)
