---
title: "GET /v1/billing/summary"
method: GET
path: "/v1/billing/summary"
---

# GET /v1/billing/summary

`GET /v1/billing/summary`

## Request

- Base URL: `https://thumbgate.ai`
- URL: `https://thumbgate.ai/v1/billing/summary`
- Auth: HTTP bearer

## Response `200`

Admin-only business summary from the funnel ledger, revenue ledger, and key store

- BillingSummaryResponse
  - `generatedAt` string, date-time
  - `coverage` object
    - `source` string
    - `tracksBookedRevenue` boolean
    - `tracksPaidOrders` boolean
    - `tracksInvoices` boolean
    - `tracksAttribution` boolean
    - `providerCoverage` object
  - `funnel` object
    - `totalEvents` integer
    - `stageCounts` object
      - `acquisition` integer
      - `activation` integer
      - `paid` integer
    - `eventCounts` object
    - `conversionRates` object
      - `acquisitionToActivation` number
      - `activationToPaid` number
      - `acquisitionToPaid` number
    - `paidProviderEvents` integer
    - `uniqueAcquisitionLeads` integer
    - `uniquePaidCustomers` integer
    - `firstPaidAt` string, nullable
    - `lastPaidAt` string, nullable
    - `lastPaidEvent` object, nullable
      - `timestamp` string, nullable
      - `event` string, nullable
      - `evidence` string, nullable
      - `customerId` string, nullable
      - `traceId` string, nullable
  - `signups` object
    - `total` integer
    - `uniqueLeads` integer
    - `bySource` object
    - `byCampaign` object
  - `pipeline` object
    - `workflowSprintLeads` object
      - `total` integer
      - `bySource` object
    - `qualifiedWorkflowSprintLeads` object
      - `total` integer
      - `bySource` object
  - `revenue` object
    - `paidProviderEvents` integer
    - `paidOrders` integer
    - `paidCustomers` integer
    - `bookedRevenueCents` integer
    - `bookedRevenueByCurrency` object
    - `amountKnownOrders` integer
    - `amountUnknownOrders` integer
    - `amountKnownCoverageRate` number
    - `unreconciledPaidEvents` integer
    - `latestPaidAt` string, nullable
    - `latestPaidOrder` object, nullable
      - `timestamp` string, nullable
      - `provider` string, nullable
      - `event` string, nullable
      - `orderId` string, nullable
      - `customerId` string, nullable
      - `amountCents` integer, nullable
      - `currency` string, nullable
      - `amountKnown` boolean
    - `byProvider` object
  - `attribution` object
    - `acquisitionBySource` object
    - `acquisitionByCampaign` object
    - `paidBySource` object
    - `paidByCampaign` object
    - `bookedRevenueBySourceCents` object
    - `bookedRevenueByCampaignCents` object
    - `conversionBySource` object
    - `conversionByCampaign` object
  - `keys` object
    - `total` integer
    - `active` integer
    - `disabled` integer
    - `activeCustomers` integer
    - `totalUsage` integer
    - `bySource` object
    - `activeBySource` object
  - `customers` object[]
    - `customerId` string
    - `activeKeys` integer
    - `totalKeys` integer
    - `usageCount` integer
    - `source` string
    - `installId` string, nullable
    - `createdAt` string, nullable
    - `disabledAt` string, nullable
  - `trafficMetrics` object
    - `visitors` integer
    - `sessions` integer
    - `pageViews` integer
    - `ctaClicks` integer
    - `checkoutStarts` integer
    - `buyerLossFeedback` integer
    - `seoLandingViews` integer
  - `operatorGeneratedAcquisition` object
    - `totalEvents` integer
    - `uniqueLeads` integer
    - `bySource` object
  - `dataQuality` object
    - `telemetryCoverage` number
    - `attributionCoverage` number
    - `amountKnownCoverage` number
    - `unreconciledPaidEvents` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

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