---
title: "User signups over time"
method: GET
path: "/admin/billing/stats/users/timeseries"
tags: ["Billing"]
---

# User signups over time

`GET /admin/billing/stats/users/timeseries`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stats/users/timeseries`
- Auth: API key in header `x-api-key`

Admin-only endpoint that returns new-user counts bucketed by signup time across all users. Without an explicit range it defaults to the last 30 days.

## Query parameters

- `from` string
- `to` string
- `bucket` 'hour' | 'day'

## Headers

- `x-api-key` string, required

## Response `200`

User signup timeseries

- BillingAdminUserSignupTimeseriesResponseDoc
  - `code` integer
  - `data` BillingAdminUserSignupPointDoc[]
    - `bucket_end` string
    - `bucket_start` string
    - `signups` integer
  - `msg` string

## Other responses

- `400`: Invalid query parameters
- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

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