Skip to main content
GET
/
api
/
v1
/
payments
/
stats
Get Payment Statistics
curl --request GET \
  --url https://api.devkit4ai.com/api/v1/payments/stats \
  --header 'Authorization: Bearer <token>'
{
  "total_projects": 123,
  "projects_with_config": 123,
  "projects_with_test": 123,
  "projects_with_live": 123,
  "total_subscriptions": 123,
  "active_subscriptions": 123,
  "total_payments": 123,
  "successful_payments": 123,
  "total_revenue_cents": 123,
  "currency": "usd"
}

Documentation Index

Fetch the complete documentation index at: https://devkit4ai.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve aggregated payment statistics across all projects owned by the authenticated developer. Includes subscription counts, payment totals, and revenue metrics.

​
Authentication

This endpoint requires developer authentication via OAuth2 Bearer Token.

​
Query Parameters

​
test_mode
boolean
default:"true"
Include test mode data in statistics. Set to false for live mode only.

​
Response

​
total_projects
integer
Total number of projects owned by the developer
​
projects_with_config
integer
Number of projects with Stripe configuration
​
projects_with_test
integer
Number of projects with test mode credentials
​
projects_with_live
integer
Number of projects with live mode credentials
​
total_subscriptions
integer
Total number of subscriptions across all projects
​
active_subscriptions
integer
Number of currently active subscriptions
​
total_payments
integer
Total number of payment transactions
​
successful_payments
integer
Number of successful payments
​
total_revenue_cents
integer
Total revenue in cents
​
currency
string
default:"usd"
Currency for revenue (lowercase ISO code)

​
Example Request

curl "https://api.devkit4ai.com/api/v1/payments/stats?test_mode=true" \
  -H "Authorization: Bearer {developer_jwt}"

​
Example Response

{
  "total_projects": 3,
  "projects_with_config": 2,
  "projects_with_test": 2,
  "projects_with_live": 1,
  "total_subscriptions": 45,
  "active_subscriptions": 38,
  "total_payments": 127,
  "successful_payments": 120,
  "total_revenue_cents": 359700,
  "currency": "usd"
}

​
Formatting Revenue

To display revenue as currency: 
const revenue = stats.total_revenue_cents / 100;
const formatted = new Intl.NumberFormat('en-US', {
  style: 'currency',
  currency: stats.currency.toUpperCase()
}).format(revenue);

// $3,597.00

​
Dashboard Metrics

Use these statistics to build a developer dashboard: (((REPLACE_THIS_WITH_IMAGE: cloud-admin-payment-stats-dashboard.png: Developer dashboard showing payment statistics with subscription counts, revenue chart, and project configuration status)))

​
Key Metrics Explained

MetricDescription
active_subscriptionsSubscriptions with status active or trialing
successful_paymentsPayments with status succeeded
total_revenue_centsSum of all successful payment amounts
When test_mode=true, statistics include both test and live data. Set test_mode=false to see only production metrics.

List Subscriptions

View all subscriptions

List Transactions

View payment transactions

Console Statistics

Cloud Admin statistics view

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
test_mode
boolean
default:true

Include test mode data

Response

Successful Response

Aggregated payment statistics.

​
total_projects
integer
required
​
projects_with_config
integer
required
​
projects_with_test
integer
required
​
projects_with_live
integer
required
​
total_subscriptions
integer
required
​
active_subscriptions
integer
required
​
total_payments
integer
required
​
successful_payments
integer
required
​
total_revenue_cents
integer
required
​
currency
string
default:usd