Analytics

List transactions

A keyset-paginated list of payments for one project. project_id is required.

curl "https://api.subscriby.net/v1/analytics/transactions?project_id=$PROJECT_ID&limit=100" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Every row carries its owning project, plan and subscriber, so a payment can be attributed without a follow-up lookup. Follow meta.next_cursor on the next call to paginate. A null or missing cursor means the end of the range has been reached.

get/v1/analytics/transactions

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/analytics/transactions
  • Auth: HTTP bearer

Query parameters

project_idstring uuid required

The project whose payments to list. Required: transactions are always read for one project.

periodstring

The preset window: 7d, 14d, 30d (the default), 60d, 90d, mtd, qtd, ytd, 1y or all. Ignored when both from and to are given; an unknown value falls back to the default rather than failing.

fromstring date

The first day of an explicit window, YYYY-MM-DD. Both from and to are needed to override period.

tostring date

The last day of an explicit window, YYYY-MM-DD. Both from and to are needed to override period.

statuses[]string[]

Only payments in these states: successful, failed, pending, refunded. Send them as statuses[]=a&statuses[]=b or as one comma-separated string; an unknown state is ignored.

provider_ids[]string[]

Only payments taken through these payment methods. Send them as provider_ids[]=a&provider_ids[]=b or as one comma-separated string.

plan_ids[]string[]

Count only these plans. Send it as plan_ids[]=a&plan_ids[]=b or as one comma-separated string.

currency_ids[]string[]

Only payments in these currencies, by currency id. Send them as currency_ids[]=a&currency_ids[]=b or as one comma-separated string.

cursorstring

The opaque keyset cursor a previous page returned as meta.next_cursor. Omit for the first page.

limitinteger

Rows per page, 1 to 200; a value outside the range clamps. Defaults to 50.

Response

One keyset page of transactions.

Example response

{
  "data": [
    {
      "id": "8b0c4a15-e792-4360-95d8-1f47c0b3e926",
      "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "project_name": "Beautiful Mouths",
      "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
      "plan_name": "Monthly",
      "subscriber_id": "6f9b2e37-c184-4a05-8d72-30e16bc9f458",
      "subscriber_name": "Ada Lovelace",
      "status": "successful",
      "amount": "29.00",
      "currency": "USD",
      "provider": "stripe",
      "provider_label": "Stripe",
      "method_id": "a15d70c8-3e46-4b92-b70f-58c9d2140e63",
      "calculated_fee": "1.16",
      "billing_reason": "subscription_cycle",
      "external_payment_id": "pi_3Nxy...",
      "occurred_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 100,
    "next_cursor": "eyJpZCI6InR4bl8uLi4i...",
    "range": {
      "from": "2026-08-13",
      "to": "2026-09-12"
    },
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.