Home dashboard
Home > Overview subscription-engine card (4-week schedule + health tiles)
Returns the forward-looking recurring-revenue snapshot: four weekly scheduled-revenue bars for the next 28 days, the active subscriber count (with net change this month), the recovery rate (with a trailing 6-month baseline), and cancels this month (with a trailing 6-month monthly-average baseline).
Active subscribers = active + past_due — past-due subs
still bill through dunning and still count as customers.
Recovery rate uses a simple failed→succeeded transition proxy;
Card 6 will formalise the full recovered / retrying /
written-off split.
GET
/
api
/
v202604
/
analytics
/
dashboard
/
subscription_engine
Home > Overview subscription-engine card (4-week schedule + health tiles)
curl --request GET \
--url https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"scheduled": [
{
"week_start": "2026-09-10",
"week_end": "2026-09-16",
"revenue": "9842.35"
},
{
"week_start": "2026-09-17",
"week_end": "2026-09-23",
"revenue": "10217.8"
},
{
"week_start": "2026-09-24",
"week_end": "2026-09-30",
"revenue": "9655.05"
},
{
"week_start": "2026-10-01",
"week_end": "2026-10-07",
"revenue": "11390.6"
}
],
"scheduled_total": "41105.8",
"subscribers": {
"active": 1284,
"net_new_this_month": 37
},
"recovery": {
"rate": "62.5",
"baseline_rate": "58.3"
},
"cancels": {
"this_month": 19,
"typical": 44
},
"currency": "USD",
"meta": {
"request_uuid": "a93e5c07-4b1d-4f82-9e6a-3c05d7b2f814",
"timestamp": "2026-09-10T15:42:07Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>",
"request_uuid": "<string>"
}
}{
"message": "<string>"
}{
"message": "<string>",
"error": "<string>"
}{
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>",
"request_uuid": "<string>"
}
}Authorizations
Query Parameters
ISO alpha-2 code of one of the requesting company's configured
countries (see GET /countries). When present, every service
on this endpoint filters its data to that country and reports
money in the country's own currency. Omit (or send "all")
for the aggregate-across-countries view, which is the default
and matches pre-Phase-004 behavior. Unknown ISO codes or ones
the company is not configured for return 400.
Example:
"US"
Response
Subscription-engine card payload
Decimal amount, expressed as a string to preserve arbitrary
precision across the wire. Parsed to Number on the client and
formatted with Intl.NumberFormat. Once the in-flight
money-cents-migration lands, this will switch to a
{ amount_cents: integer, currency: string } object.
Example:
"180.25"
⌘I
Home > Overview subscription-engine card (4-week schedule + health tiles)
curl --request GET \
--url https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/analytics/dashboard/subscription_engine")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"scheduled": [
{
"week_start": "2026-09-10",
"week_end": "2026-09-16",
"revenue": "9842.35"
},
{
"week_start": "2026-09-17",
"week_end": "2026-09-23",
"revenue": "10217.8"
},
{
"week_start": "2026-09-24",
"week_end": "2026-09-30",
"revenue": "9655.05"
},
{
"week_start": "2026-10-01",
"week_end": "2026-10-07",
"revenue": "11390.6"
}
],
"scheduled_total": "41105.8",
"subscribers": {
"active": 1284,
"net_new_this_month": 37
},
"recovery": {
"rate": "62.5",
"baseline_rate": "58.3"
},
"cancels": {
"this_month": 19,
"typical": 44
},
"currency": "USD",
"meta": {
"request_uuid": "a93e5c07-4b1d-4f82-9e6a-3c05d7b2f814",
"timestamp": "2026-09-10T15:42:07Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>",
"request_uuid": "<string>"
}
}{
"message": "<string>"
}{
"message": "<string>",
"error": "<string>"
}{
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>",
"request_uuid": "<string>"
}
}