FlintflintDocs

Analytics

Analytics endpoints return pre-aggregated reporting data for your merchant account: summary metrics like gross and net volume, refunds, payment counts, and new customers; bucketed payment volume timeseries; and subscription metrics including MRR, ARR, and subscription status counts. All endpoints are read-only.

Queries take a range (today, last_7_days, last_30_days) and an optional timezone for bucket boundaries. The overview and timeseries endpoints can also include previous-period values and change percentages for comparison, and responses flag when multiple currencies are present so you can render per-currency breakdowns correctly.

For per-event data instead of aggregates, use webhooks or list the underlying resources directly.

Endpoints

Get analytics overview#

GET/v1/analytics/overview

Returns high-level merchant analytics for the requested time range.

Query parameters
rangeenumrequired

Requested analytics time range.

todaylast_7_dayslast_30_days
timezonestring

Optional IANA timezone, for example America/New_York.

include_previous_periodboolean

Include previous-period comparison metrics.

Response · 200
dataobjectrequired
metaobject
request_idstring
Bash
curl https://api.withflintpay.com/v1/analytics/overview \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "range": "last_7_days",
    "timezone": "America/New_York",
    "gross_volume": {
      "current_money": {
        "amount": 125000,
        "currency": "USD"
      },
      "previous_money": {
        "amount": 112000,
        "currency": "USD"
      },
      "change_percent": 11.61
    },
    "net_volume": {
      "current_money": {
        "amount": 119500,
        "currency": "USD"
      },
      "previous_money": {
        "amount": 108000,
        "currency": "USD"
      },
      "change_percent": 10.65
    },
    "refunds_total": {
      "current_money": {
        "amount": 5500,
        "currency": "USD"
      },
      "previous_money": {
        "amount": 4000,
        "currency": "USD"
      },
      "change_percent": 37.5
    },
    "payments_count": {
      "current_count": 48,
      "previous_count": 41,
      "change_percent": 17.07
    },
    "average_payment": {
      "current_money": {
        "amount": 2604,
        "currency": "USD"
      },
      "previous_money": {
        "amount": 2731,
        "currency": "USD"
      },
      "change_percent": -4.65
    },
    "new_customers": {
      "current_count": 9,
      "previous_count": 6,
      "change_percent": 50
    },
    "active_subscriptions": {
      "current_count": 27,
      "previous_count": 25,
      "change_percent": 8
    },
    "has_multiple_currencies": false,
    "currencies": [
      "USD"
    ]
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Get payment volume timeseries#

GET/v1/analytics/payment-volume-timeseries

Returns merchant payment volume buckets for the requested time range.

Query parameters
rangeenumrequired

Requested analytics time range.

todaylast_7_dayslast_30_days
timezonestring

Optional IANA timezone, for example America/New_York.

include_previous_periodboolean

Include previous-period comparison buckets.

Response · 200
dataobjectrequired
metaobject
request_idstring
Bash
curl https://api.withflintpay.com/v1/analytics/payment-volume-timeseries \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "range": "last_7_days",
    "timezone": "America/New_York",
    "buckets": [
      {
        "label": "Mar 10",
        "period_start": "2026-03-10T05:00:00Z",
        "period_end": "2026-03-11T05:00:00Z",
        "volume_money": {
          "amount": 18000,
          "currency": "USD"
        },
        "payments_count": {
          "current_count": 7,
          "previous_count": 6,
          "change_percent": 16.67
        },
        "previous_volume_money": {
          "amount": 15000,
          "currency": "USD"
        }
      },
      {
        "label": "Mar 11",
        "period_start": "2026-03-11T05:00:00Z",
        "period_end": "2026-03-12T05:00:00Z",
        "volume_money": {
          "amount": 22000,
          "currency": "USD"
        },
        "payments_count": {
          "current_count": 9,
          "previous_count": 7,
          "change_percent": 28.57
        },
        "previous_volume_money": {
          "amount": 17000,
          "currency": "USD"
        }
      }
    ],
    "has_multiple_currencies": false,
    "currencies": [
      "USD"
    ]
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Get subscription analytics#

GET/v1/analytics/subscriptions

Returns windowed subscription metrics plus current subscription snapshot metrics.

Query parameters
rangeenumrequired

Requested analytics time range.

todaylast_7_dayslast_30_days
timezonestring

Optional IANA timezone, for example America/New_York.

Response · 200
dataobjectrequired
metaobject
request_idstring
Bash
curl https://api.withflintpay.com/v1/analytics/subscriptions \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "range": "last_30_days",
    "timezone": "America/New_York",
    "window_metrics": {
      "new_subscriptions": 14,
      "canceled_subscriptions": 3,
      "subscription_collected_money_by_currency": [
        {
          "amount": 485000,
          "currency": "USD"
        }
      ]
    },
    "snapshot_metrics": {
      "mrr_by_currency": [
        {
          "amount": 129900,
          "currency": "USD"
        }
      ],
      "arr_by_currency": [
        {
          "amount": 1558800,
          "currency": "USD"
        }
      ],
      "status_counts": {
        "trialing_count": 5,
        "active_count": 42,
        "paused_count": 2,
        "past_due_count": 3,
        "canceled_count": 18,
        "incomplete_count": 4
      }
    }
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}
Rate this doc