List subscriptions | Mitu API Documentation

{
  "message": "Subscriptions retrieved successfully",
  "data": [
    {
      "id": "sub_2f7b46e0d913",
      "url": {
        "checkout": "https://mitu.ai/pay/pay_n8d7piu1yc6h",
        "agent": "https://api.mitu.ai/pay/pay_n8d7piu1yc6h"
      },
      "subscription_plan_id": "plan_6d1a83f95c20",
      "status": "active",
      "subscriber_id": "cus_0t9549fps3xd",
      "subscriber_type": "agent",
      "payment_method": "mpp_crypto",
      "current_period_start": "2026-09-11T15:00:34.915Z",
      "current_period_end": "2026-10-11T15:00:34.915Z",
      "next_billing_at": "2026-10-11T15:00:34.915Z",
      "started_at": "2026-09-11T15:00:34.915Z",
      "cancelled_at": null,
      "ended_at": null,
      "created_at": "2026-09-11T15:00:34.915Z",
      "updated_at": "2026-09-11T15:00:34.915Z"
    }
  ],
  "meta": {
    "total": 84,
    "limit": 20,
    "has_more": true,
    "next_cursor": "cur_01HXYZ9999XXXXXX"
  }
}

List your subscriptions.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Query parameters

statusenumOptional

Filter by subscription status.

Allowed values:

subscription_plan_idstringOptional

Return subscriptions for a specific subscription plan.

limitintegerOptional1-100Defaults to 20

Maximum number of records to return.

cursorstringOptional

Cursor returned as next_cursor from the previous response. Omit for the first request.

Response

Subscriptions retrieved successfully.

messagestring

datalist of objects

metaobject

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error