Skip to main content
GET
/
api
/
v1
/
payments
/
subscriptions
List All Subscriptions
curl --request GET \
  --url https://api.devkit4ai.com/api/v1/payments/subscriptions \
  --header 'Authorization: Bearer <token>'
{
  "subscriptions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_name": "<string>",
      "is_test_mode": true,
      "subscription_id": "<string>",
      "status": "<string>",
      "quantity": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "provider": "stripe",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customer_id": "<string>",
      "plan_name": "<string>",
      "current_period_start": "2023-11-07T05:31:56Z",
      "current_period_end": "2023-11-07T05:31:56Z",
      "cancel_at": "2023-11-07T05:31:56Z",
      "cancelled_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

Documentation Index

Fetch the complete documentation index at: https://devkit4ai.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve all Stripe subscriptions across all projects owned by the authenticated developer. Supports filtering by project, test mode, and subscription status.

​
Authentication

This endpoint requires developer authentication via OAuth2 Bearer Token.

​
Query Parameters

​
project_id
string (UUID)
Filter subscriptions by specific project ID
​
test_mode
boolean
Filter by test mode (true) or live mode (false). If omitted, returns both.
​
status
string
Filter by subscription status: active, canceled, incomplete, incomplete_expired, past_due, trialing, unpaid
​
page
integer
default:"1"
Page number for pagination (minimum: 1)
​
page_size
integer
default:"50"
Number of results per page (1-100)

​
Response

​
subscriptions
array
Array of subscription objects with project information
​
total
integer
Total number of subscriptions matching the filter
​
page
integer
Current page number
​
page_size
integer
Number of results per page

​
Example Request

curl "https://api.devkit4ai.com/api/v1/payments/subscriptions?status=active&page=1&page_size=10" \
  -H "Authorization: Bearer {developer_jwt}"

​
Example Response

{
  "subscriptions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "project_id": "660e8400-e29b-41d4-a716-446655440001",
      "project_name": "My SaaS App",
      "provider": "stripe",
      "user_id": "770e8400-e29b-41d4-a716-446655440002",
      "is_test_mode": true,
      "subscription_id": "sub_1234567890",
      "customer_id": "cus_1234567890",
      "status": "active",
      "plan_name": "Pro Plan",
      "quantity": 1,
      "current_period_start": "2026-01-01T00:00:00Z",
      "current_period_end": "2026-02-01T00:00:00Z",
      "cancel_at": null,
      "cancelled_at": null,
      "created_at": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 10
}

​
Use Cases

​
View All Active Subscriptions

curl "https://api.devkit4ai.com/api/v1/payments/subscriptions?status=active" \
  -H "Authorization: Bearer {developer_jwt}"

​
Filter by Specific Project

curl "https://api.devkit4ai.com/api/v1/payments/subscriptions?project_id=660e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer {developer_jwt}"

​
View Only Live Mode Subscriptions

curl "https://api.devkit4ai.com/api/v1/payments/subscriptions?test_mode=false" \
  -H "Authorization: Bearer {developer_jwt}"

List Transactions

View payment transactions

Payment Statistics

Aggregated payment metrics

Project Subscriptions

View subscriptions for a specific project

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
project_id
string<uuid> | null

Filter by project

​
test_mode
boolean | null

Filter by test mode

​
status
string | null

Filter by status

​
page
integer
default:1
Required range: x >= 1
​
page_size
integer
default:50
Required range: 1 <= x <= 100

Response

Successful Response

Paginated list of subscriptions across projects.

​
subscriptions
AggregatedSubscriptionResponse · object[]
required
​
total
integer
required
​
page
integer
required
​
page_size
integer
required