---
title: "Get acquisition-attributed Stripe net revenue summary"
method: GET
path: "/admin/billing/analytics/revenue/summary"
tags: ["Billing"]
---

# Get acquisition-attributed Stripe net revenue summary

`GET /admin/billing/analytics/revenue/summary`

## Request

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

Admin-only invoice-date net-cash totals, new-versus-renewal revenue, refunds, customer counts, attribution coverage, an equal-length previous-period comparison, current subscription MRR, and a historical opening-to-ending MRR bridge with failed-payment recovery. Multiple currencies are returned as separate rows and are never converted or summed.

## Query parameters

- `from` string
- `to` string
- `attribution_model` 'first_touch_v1' | 'last_touch_v1'
- `currency` string

## Headers

- `x-api-key` string, required

## Response `200`

Revenue analytics summary

- BillingRevenueAnalyticsSummaryResponseDoc
  - `code` integer
  - `data` ModelsRevenueAnalyticsSummary
    - `coverage` ModelsRevenueAnalyticsCoverage
      - `attributed_net_revenue_cents` integer
      - `attributed_paid_customers` integer
      - `currency` string
      - `customer_coverage_rate` number
      - `net_revenue_cents` integer
      - `paid_customers` integer
      - `revenue_coverage_rate` number
      - `unmatched_invoice_count` integer
      - `unmatched_net_revenue_cents` integer
    - `coverage_by_currency` ModelsRevenueAnalyticsCoverage[]
      - `attributed_net_revenue_cents` integer
      - `attributed_paid_customers` integer
      - `currency` string
      - `customer_coverage_rate` number
      - `net_revenue_cents` integer
      - `paid_customers` integer
      - `revenue_coverage_rate` number
      - `unmatched_invoice_count` integer
      - `unmatched_net_revenue_cents` integer
    - `currencies` ModelsRevenueAnalyticsCurrency[]
      - `currency` string
      - `net_revenue_cents` integer
      - `new_customer_revenue_cents` integer
      - `new_paid_customers` integer
      - `paid_customers` integer
      - `paid_invoice_count` integer
      - `refund_cents` integer
      - `renewal_revenue_cents` integer
      - `revenue_per_paid_customer_cents` integer
    - `meta` ModelsRevenueAnalyticsMeta
      - `attribution_model` string
      - `channel_rules_version` string
      - `currency` string
      - `from` string
      - `revenue_basis` string
      - `timezone` string
      - `to` string
    - `mrr_by_currency` ModelsRevenueAnalyticsMRR[]
      - `currency` string
      - `mrr_cents` integer
      - `paid_subscriptions` integer
    - `mrr_movements_by_currency` ModelsRevenueAnalyticsMRRMovement[]
      - `churn_mrr_cents` integer
      - `churned_subscriptions` integer
      - `contraction_mrr_cents` integer
      - `contraction_subscriptions` integer
      - `currency` string
      - `ending_mrr_cents` integer
      - `ending_subscriptions` integer
      - `expansion_mrr_cents` integer
      - `expansion_subscriptions` integer
      - `net_change_mrr_cents` integer
      - `new_mrr_cents` integer
      - `new_subscriptions` integer
      - `opening_mrr_cents` integer
      - `opening_subscriptions` integer
      - `reactivated_subscriptions` integer
      - `reactivation_mrr_cents` integer
      - `recovered_mrr_cents` integer
      - `recovered_subscriptions` integer
    - `previous_period` ModelsRevenueAnalyticsPreviousPeriod
      - `currencies` ModelsRevenueAnalyticsCurrency[]
        - `currency` string
        - `net_revenue_cents` integer
        - `new_customer_revenue_cents` integer
        - `new_paid_customers` integer
        - `paid_customers` integer
        - `paid_invoice_count` integer
        - `refund_cents` integer
        - `renewal_revenue_cents` integer
        - `revenue_per_paid_customer_cents` integer
      - `from` 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/0497899e2016?raw)