RevKeenDocs
StatusSupport
API Reference

Revenue Time Series

Get revenue data over time with configurable granularity --- **Related endpoints** - `GET /analytics/revenue/mrr-summary` — MRR Summary - `GET /analytics/invoices/ar-aging` — A/R Aging Report - `GET /analytics/collections/dso` — Days Sales Outstanding - `GET /analytics/customers/ltv` — Customer LTV - `GET /analytics/customers/{customerId}` — Customer Analytics - `GET /analytics/payment-links/conversion` — Payment Link Conversion - `GET /analytics/checkout/funnel` — Checkout Funnel Analytics - `GET /analytics/checkout/abandonment/summary` — Abandonment Alert Summary

GET
/analytics/revenue/time-series

Get revenue data over time with configurable granularity

Related endpoints

  • GET /analytics/revenue/mrr-summary — MRR Summary
  • GET /analytics/invoices/ar-aging — A/R Aging Report
  • GET /analytics/collections/dso — Days Sales Outstanding
  • GET /analytics/customers/ltv — Customer LTV
  • GET /analytics/customers/{customerId} — Customer Analytics
  • GET /analytics/payment-links/conversion — Payment Link Conversion
  • GET /analytics/checkout/funnel — Checkout Funnel Analytics
  • GET /analytics/checkout/abandonment/summary — Abandonment Alert Summary

Authorization

x-api-key<token>

Your RevKeen merchant API key. Create and manage keys in Dashboard → Settings → Developer. Use rk_sandbox_* for staging/test and rk_live_* for production. The same key may be sent as Authorization: Bearer <key> if that suits your HTTP client better. A missing, invalid, expired, or revoked key returns 401 with a WWW-Authenticate: Bearer challenge; a valid key without the required scope returns 403.

In: header

Query Parameters

startDate*string

Start date (ISO 8601)

Formatdate-time
endDate*string

End date (ISO 8601)

Formatdate-time
granularity?string

Time granularity for data points

Default"month"

Value in

  • "day"
  • "week"
  • "month"
  • "quarter"
  • "year"

Response Body

application/json

application/json

application/json

Stuck on an error response? Ask the RevKeen assistant to explain it.
curl "https://api.revkeen.com/v2/analytics/revenue/time-series?startDate=2024-01-01T00%3A00%3A00Z&endDate=2024-12-31T23%3A59%3A59Z" \
  -H "x-api-key: $REVKEEN_API_KEY"
{  "data_points": [    {      "date": "string",      "revenue": 0,      "invoice_count": 0,      "avg_invoice_value": 0    }  ],  "total_revenue": 0,  "total_invoices": 0,  "period_start": "string",  "period_end": "string"}

MRR Summary GET

Get Monthly Recurring Revenue metrics and growth --- **Related endpoints** - `GET /analytics/revenue/time-series` — Revenue Time Series - `GET /analytics/invoices/ar-aging` — A/R Aging Report - `GET /analytics/collections/dso` — Days Sales Outstanding - `GET /analytics/customers/ltv` — Customer LTV - `GET /analytics/customers/{customerId}` — Customer Analytics - `GET /analytics/payment-links/conversion` — Payment Link Conversion - `GET /analytics/checkout/funnel` — Checkout Funnel Analytics - `GET /analytics/checkout/abandonment/summary` — Abandonment Alert Summary

List approvals GET

List pending and resolved automation approval requests. --- **Related endpoints** - `GET /automations` — List automations - `POST /automations` — Create an automation - `GET /automations/{id}` — Retrieve an automation - `GET /automations/{id}/runs` — List runs for an automation - `POST /automations/{id}/runs` — Run an automation - `GET /automations/{id}/runs/{runId}` — Retrieve a run - `POST /automations/approvals/{approvalId}/approve` — Approve an automation approval - `POST /automations/approvals/{approvalId}/reject` — Reject an automation approval **Common errors** - `400 invalid_request` — malformed payload or failed validation. - `401 authentication_error` — missing, invalid, expired, or revoked credential. Codes: `authentication_failed`, `invalid_api_key`, `expired_api_key`, `api_key_revoked`, `session_invalid`, `merchant_required`. Carries a `WWW-Authenticate: Bearer` challenge. **Pagination** Offset-based with `limit` (default 25, max 100) and `offset`. The response `pagination` block includes `total` and `hasMore`. See [the pagination guide](/docs/fundamentals/pagination) for SDK auto-paging helpers.