List Subscriptions

curl -X GET 'https://developers.flouci.com/api/v2/subscriptions?status=active&client_id=customer-9f3a&page=1&page_size=20' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>'

{
  "success": true,
  "count": 42,
  "next": "https://developers.flouci.com/api/v2/subscriptions?client_id=customer-9f3a&page=2&page_size=20&status=active",
  "previous": null,
  "results": [
    {
      "subscription_id": "s7Qm3kLpTq2e9hZx0bYw1A",
      "status": "active",
      "payment_method": "flouci",
      "amount": 15000,
      "currency": "TND",
      "interval": "month",
      "interval_count": 1,
      "name": "Gold plan",
      "description": "",
      "client_id": "customer-9f3a",
      "developer_tracking_id": "sub-2026-000418",
      "is_test": false,
      "created_at": "2026-09-30T14:02:11+01:00",
      "activated_at": "2026-09-30T14:05:48+01:00",
      "current_period_start": "2026-09-30T14:05:48+01:00",
      "current_period_end": "2026-10-30T00:00:00+01:00",
      "next_charge_at": "2026-10-30T09:00:00+01:00",
      "cycles_completed": 1,
      "max_cycles": null,
      "cancel_at_period_end": false,
      "canceled_at": null,
      "cancellation_initiator": null,
      "cancellation_reason": null,
      "latest_charge": {
        "payment_id": "AgCKuBm0S5uLPghBo571MQ",
        "status": "SUCCESS",
        "type": "flouci",
        "billing_reason": "subscription_create",
        "attempt": 0,
        "period_start": "2026-09-30",
        "period_end": null,
        "amount": 15000,
        "fee": 150,
        "tva": 28,
        "created_at": "2026-09-30T14:02:11+01:00",
        "paid_at": "2026-09-30T14:05:48+01:00"
      }
    }
  ],
  "name": "developers",
  "code": 0,
  "version": "v2"
}

curl -X GET 'https://developers.flouci.com/api/v2/subscriptions?status=active&client_id=customer-9f3a&page=1&page_size=20' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>'

{
  "success": true,
  "count": 42,
  "next": "https://developers.flouci.com/api/v2/subscriptions?client_id=customer-9f3a&page=2&page_size=20&status=active",
  "previous": null,
  "results": [
    {
      "subscription_id": "s7Qm3kLpTq2e9hZx0bYw1A",
      "status": "active",
      "payment_method": "flouci",
      "amount": 15000,
      "currency": "TND",
      "interval": "month",
      "interval_count": 1,
      "name": "Gold plan",
      "description": "",
      "client_id": "customer-9f3a",
      "developer_tracking_id": "sub-2026-000418",
      "is_test": false,
      "created_at": "2026-09-30T14:02:11+01:00",
      "activated_at": "2026-09-30T14:05:48+01:00",
      "current_period_start": "2026-09-30T14:05:48+01:00",
      "current_period_end": "2026-10-30T00:00:00+01:00",
      "next_charge_at": "2026-10-30T09:00:00+01:00",
      "cycles_completed": 1,
      "max_cycles": null,
      "cancel_at_period_end": false,
      "canceled_at": null,
      "cancellation_initiator": null,
      "cancellation_reason": null,
      "latest_charge": {
        "payment_id": "AgCKuBm0S5uLPghBo571MQ",
        "status": "SUCCESS",
        "type": "flouci",
        "billing_reason": "subscription_create",
        "attempt": 0,
        "period_start": "2026-09-30",
        "period_end": null,
        "amount": 15000,
        "fee": 150,
        "tva": 28,
        "created_at": "2026-09-30T14:02:11+01:00",
        "paid_at": "2026-09-30T14:05:48+01:00"
      }
    }
  ],
  "name": "developers",
  "code": 0,
  "version": "v2"
}

Returns your subscriptions, newest first. Each item has the shape documented on Get Subscription.

curl -X GET 'https://developers.flouci.com/api/v2/subscriptions?status=active&client_id=customer-9f3a&page=1&page_size=20' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>'

Query Parameters

string

Keep only one status: incomplete, incomplete_expired, active, past_due, unpaid or canceled.

string

Keep only the subscriptions created with this client_id.

integer

default:"1"

Page number.

integer

default:"10"

Items per page, maximum 100.

{
  "success": true,
  "count": 42,
  "next": "https://developers.flouci.com/api/v2/subscriptions?client_id=customer-9f3a&page=2&page_size=20&status=active",
  "previous": null,
  "results": [
    {
      "subscription_id": "s7Qm3kLpTq2e9hZx0bYw1A",
      "status": "active",
      "payment_method": "flouci",
      "amount": 15000,
      "currency": "TND",
      "interval": "month",
      "interval_count": 1,
      "name": "Gold plan",
      "description": "",
      "client_id": "customer-9f3a",
      "developer_tracking_id": "sub-2026-000418",
      "is_test": false,
      "created_at": "2026-09-30T14:02:11+01:00",
      "activated_at": "2026-09-30T14:05:48+01:00",
      "current_period_start": "2026-09-30T14:05:48+01:00",
      "current_period_end": "2026-10-30T00:00:00+01:00",
      "next_charge_at": "2026-10-30T09:00:00+01:00",
      "cycles_completed": 1,
      "max_cycles": null,
      "cancel_at_period_end": false,
      "canceled_at": null,
      "cancellation_initiator": null,
      "cancellation_reason": null,
      "latest_charge": {
        "payment_id": "AgCKuBm0S5uLPghBo571MQ",
        "status": "SUCCESS",
        "type": "flouci",
        "billing_reason": "subscription_create",
        "attempt": 0,
        "period_start": "2026-09-30",
        "period_end": null,
        "amount": 15000,
        "fee": 150,
        "tva": 28,
        "created_at": "2026-09-30T14:02:11+01:00",
        "paid_at": "2026-09-30T14:05:48+01:00"
      }
    }
  ],
  "name": "developers",
  "code": 0,
  "version": "v2"
}

Response Fields

integer

required

Total number of subscriptions matching the filters.

string | null

URL of the next page, or null on the last page.

string | null

URL of the previous page, or null on the first page.

array

required

Subscriptions, newest first. Same shape as Get Subscription.

To reconcile your own records, list with status=past_due once a day: those are the customers whose renewal failed and whose access you may want to restrict.

Introduction

Basic Payment Flows

Advanced payment flows

Partner APIs

Payment Plugins

Business Dashboard

Environments

Changelog

Query Parameters

Response Fields

​Query Parameters

​Response Fields

Query Parameters

Response Fields