---
title: "Get the Stripe net revenue time series"
method: GET
path: "/admin/billing/analytics/revenue/timeseries"
tags: ["Billing"]
---

# Get the Stripe net revenue time series

`GET /admin/billing/analytics/revenue/timeseries`

## Request

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

Returns Stripe net revenue over time (admin only), bucketed by UTC `day`, `week` or `month` using `bucket`. Narrow with `from` (inclusive) and `to` (exclusive) in RFC 3339, `currency` and `attribution_model` (`first_touch_v1` or `last_touch_v1`). Each point has net, new-customer and renewal revenue, refunds, paid customers and paid invoices. Currencies are never merged.

## Query parameters

- `from` string
- `to` string
- `attribution_model` 'first_touch_v1' | 'last_touch_v1'
- `currency` string
- `bucket` 'day' | 'week' | 'month'

## Headers

- `x-api-key` string, required

## Response `200`

Revenue analytics time series

- BillingRevenueAnalyticsTimeseriesResponseDoc
  - `code` integer
  - `data` ModelsRevenueAnalyticsTimeseries
    - `items` ModelsRevenueAnalyticsTimeseriesPoint[]
      - `bucket_start` string
      - `currency` string
      - `net_revenue_cents` integer
      - `new_customer_revenue_cents` integer
      - `paid_customers` integer
      - `paid_invoice_count` integer
      - `refund_cents` integer
      - `renewal_revenue_cents` integer
    - `meta` ModelsRevenueAnalyticsMeta
      - `attribution_model` string
      - `channel_rules_version` string
      - `currency` string
      - `from` string
      - `revenue_basis` string
      - `timezone` string
      - `to` string
  - `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/028417aa35bb?raw)