Get payment analytics

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/payments/analytics \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/payments/analytics', 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://app.base44.com/api/apps/{app_id}/payments/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/payments/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/payments/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "summary": {
    "gross_revenue": 125000,
    "total_refunds": 4500,
    "total_disputes": 0,
    "net_revenue": 120500,
    "transaction_count": 64,
    "refund_count": 3,
    "dispute_count": 0,
    "unique_customers": 51,
    "currency": "usd"
  },
  "daily": [
    {
      "date": "2026-08-25",
      "payment_count": 4,
      "payments": 8200,
      "unique_customers": 4
    }
  ],
  "available_currencies": [
    "usd",
    "eur"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Get payment analytics

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Returns what an app earned: the totals for a window, and a day-by-day series you can chart.

Money is reported in the smallest unit of the currency, so 125000 is 1,250.00 where the currency has two decimal places. Read net_revenue for what the app actually kept, since gross_revenue counts refunded and disputed payments too.

Set the window with start_date and end_date, which you must send together. With neither, period picks the last 7, 30 or 90 whole UTC days including today, and 30 is the default. Sending only one of the two dates falls back to period and silently ignores the date you sent, so send both or neither.

Read summary.currency before you read any amount. It is null when the app took money in more than one currency in the window, and the amounts are then sums across currencies, which is not a number you can show anyone. Use available_currencies to see which ones are present and pass currencies to narrow to one.

An unknown or malformed currency code in currencies is dropped rather than rejected, and if every code you send is unusable the response comes back as zeros rather than an error. Send lowercase three-letter codes taken from available_currencies.

Only live money is counted. Payments an app took while its payment provider was still in test mode are excluded.

This reads an analytics store rather than the payment provider, so the last few minutes of activity can be missing, and a window with no transactions is reported as zeros rather than as an error.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

payments

analytics

Get payment analytics

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/payments/analytics \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/payments/analytics', 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://app.base44.com/api/apps/{app_id}/payments/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/payments/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/payments/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "summary": {
    "gross_revenue": 125000,
    "total_refunds": 4500,
    "total_disputes": 0,
    "net_revenue": 120500,
    "transaction_count": 64,
    "refund_count": 3,
    "dispute_count": 0,
    "unique_customers": 51,
    "currency": "usd"
  },
  "daily": [
    {
      "date": "2026-08-25",
      "payment_count": 4,
      "payments": 8200,
      "unique_customers": 4
    }
  ],
  "available_currencies": [
    "usd",
    "eur"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose payments to read.

Query Parameters

start_date

string<date-time> | null

First moment of the window, as an ISO 8601 timestamp. Send it together with end_date, because sending only one falls back to period and ignores the one you sent.

end_date

string<date-time> | null

Last moment of the window, as an ISO 8601 timestamp. Send it together with start_date.

period

enum<string>

default:30d

Window to use when you send no dates, counted back over whole UTC days including today. Either 7d, 30d or 90d.

Available options:

7d,

30d,

90d

currencies

string | null

Narrow the totals to these currencies, as a comma-separated list of three-letter ISO 4217 codes. Case does not matter. For example, usd,eur reports only those two. Take the values from available_currencies.

Response

The app's payment totals and daily series.

An app's payment totals and its day-by-day series.

summary

PaymentSummary · object

required

Totals across the whole window.

Show child attributes

daily

DailyMetrics · object[]

required

One entry per day that had activity, oldest first. A day with no transactions is absent rather than zero-filled, so chart against the window you asked for rather than assuming a contiguous series.

Show child attributes

Example:

[
  {
    "date": "2026-08-25",
    "payment_count": 4,
    "payments": 8200,
    "unique_customers": 4
  }
]

available_currencies

string[]

Every currency the app took money in during the window, as lowercase three-letter ISO 4217 codes. Pass one or more of these back in currencies to narrow the totals to a single currency.

Example:

["usd", "eur"]

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Get payment analytics

Authorizations

Path Parameters

Query Parameters

Response