---
title: "One page (50) of the people behind a drill, masked emails only."
method: GET
path: "/api/v1/admin/metrics/drill/people"
tags: ["Metrics Admin"]
---

# One page (50) of the people behind a drill, masked emails only.

`GET /api/v1/admin/metrics/drill/people`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/admin/metrics/drill/people`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

## Query parameters

- `tz` string, nullable
- `include_internal` '0' | '1', nullable
- `from` string, date, nullable
- `to` string, date, nullable
- `filters` string, nullable
- `steps` string, nullable
- `window_days` integer
- `kind` 'funnel_dropoff' | 'metric' | 'churn', required
- `metric` 'signups' | 'trials' | 'new_paid', nullable
- `step_index` integer, nullable
- `by` 'country' | 'device' | 'source' | 'medium' | 'campaign' | 'plan' | 'billing' | 'reason', nullable
- `offset` integer

## Response `200`

OK

- DrillPeopleResponse
  - `limit` integer, required
  - `meta` ResponseMeta, required: The zone the answer's dates are in (ruling 11). tz_applied is false where the data is UTC by nature (/freshness, /exports).
    - `tz` string, required
    - `tz_applied` boolean
  - `notes` string[]
  - `offset` integer, required
  - `people` Person[], required
    - `billing_interval` string, nullable, required
    - `cancel_reason` string, nullable, required
    - `country` string, nullable, required
    - `device` string, nullable, required
    - `event_date` string, date, nullable, required
    - `last_activity_date` string, date, nullable, required
    - `last_step_id` string, nullable, required
    - `links` PersonLinks, required
      - `stripe_customer` string, nullable, required
    - `masked_email` string, nullable, required
    - `mrr_lost_cents` integer, nullable, required
    - `person_type` 'user' | 'visitor' | 'customer', required
    - `plan_slug` string, nullable, required
    - `platform_user_id` integer, nullable, required
    - `reason` string, nullable, required
    - `signup_date` string, date, nullable, required
    - `source` string, nullable, required
    - `stripe_customer_id` string, nullable, required
    - `subscription_id` string, nullable, required
    - `tenure_days` integer, nullable, required
    - `user_id` string, nullable, required
  - `total` integer, required
  - `truncated` boolean, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `503`: Service Unavailable

---

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