List plans

GET

https://api.schematichq.com/plans

GET

/plans

1 import { SchematicClient } from "@schematichq/schematic-typescript-node";
2 
3 const client = new SchematicClient({ apiKey: "YOUR_API_KEY" });
4 await client.plans.listPlans();

Try it

1 {
2   "data": [
3     {
4       "company_count": 1,
5       "created_at": "2024-01-15T09:30:00Z",
6       "description": "description",
7       "features": [
8         {
9           "created_at": "2024-01-15T09:30:00Z",
10           "description": "description",
11           "feature_type": "feature_type",
12           "flags": [
13             {
14               "created_at": "2024-01-15T09:30:00Z",
15               "default_value": true,
16               "description": "description",
17               "flag_type": "flag_type",
18               "id": "id",
19               "key": "key",
20               "name": "name",
21               "rules": [
22                 {
23                   "condition_groups": [
24                     {
25                       "conditions": [
26                         {
27                           "condition_type": "condition_type",
28                           "created_at": "2024-01-15T09:30:00Z",
29                           "environment_id": "environment_id",
30                           "id": "id",
31                           "operator": "operator",
32                           "resource_ids": [
33                             "resource_ids"
34                           ],
35                           "resources": [
36                             {
37                               "id": "id",
38                               "name": "name"
39                             }
40                           ],
41                           "rule_id": "rule_id",
42                           "trait_value": "trait_value",
43                           "updated_at": "2024-01-15T09:30:00Z"
44                         }
45                       ],
46                       "created_at": "2024-01-15T09:30:00Z",
47                       "environment_id": "environment_id",
48                       "id": "id",
49                       "rule_id": "rule_id",
50                       "updated_at": "2024-01-15T09:30:00Z"
51                     }
52                   ],
53                   "conditions": [
54                     {
55                       "condition_type": "condition_type",
56                       "created_at": "2024-01-15T09:30:00Z",
57                       "environment_id": "environment_id",
58                       "id": "id",
59                       "operator": "operator",
60                       "resource_ids": [
61                         "resource_ids"
62                       ],
63                       "resources": [
64                         {
65                           "id": "id",
66                           "name": "name"
67                         }
68                       ],
69                       "rule_id": "rule_id",
70                       "trait_value": "trait_value",
71                       "updated_at": "2024-01-15T09:30:00Z"
72                     }
73                   ],
74                   "created_at": "2024-01-15T09:30:00Z",
75                   "environment_id": "environment_id",
76                   "id": "id",
77                   "name": "name",
78                   "priority": 1,
79                   "rule_type": "rule_type",
80                   "updated_at": "2024-01-15T09:30:00Z",
81                   "value": true
82                 }
83               ],
84               "updated_at": "2024-01-15T09:30:00Z"
85             }
86           ],
87           "icon": "icon",
88           "id": "id",
89           "name": "name",
90           "plans": [
91             {
92               "id": "id",
93               "name": "name"
94             }
95           ],
96           "updated_at": "2024-01-15T09:30:00Z"
97         }
98       ],
99       "icon": "icon",
100       "id": "id",
101       "is_default": true,
102       "is_free": true,
103       "is_trialable": true,
104       "name": "name",
105       "plan_type": "plan_type",
106       "updated_at": "2024-01-15T09:30:00Z",
107       "audience_type": "audience_type",
108       "billing_product": {
109         "account_id": "account_id",
110         "created_at": "2024-01-15T09:30:00Z",
111         "currency": "currency",
112         "environment_id": "environment_id",
113         "external_id": "external_id",
114         "name": "name",
115         "price": 1.1,
116         "prices": [
117           {
118             "currency": "currency",
119             "external_price_id": "external_price_id",
120             "id": "id",
121             "interval": "interval",
122             "price": 1
123           }
124         ],
125         "product_id": "product_id",
126         "quantity": 1.1,
127         "subscription_count": 1,
128         "updated_at": "2024-01-15T09:30:00Z"
129       },
130       "monthly_price": {
131         "currency": "currency",
132         "external_price_id": "external_price_id",
133         "id": "id",
134         "interval": "interval",
135         "price": 1
136       },
137       "trial_days": 1,
138       "yearly_price": {
139         "currency": "currency",
140         "external_price_id": "external_price_id",
141         "id": "id",
142         "interval": "interval",
143         "price": 1
144       }
145     }
146   ],
147   "params": {
148     "company_id": "company_id",
149     "has_product_id": true,
150     "ids": [
151       "ids"
152     ],
153     "limit": 1,
154     "offset": 1,
155     "plan_type": "plan",
156     "q": "q",
157     "without_entitlement_for": "without_entitlement_for",
158     "without_paid_product_id": true,
159     "without_product_id": true
160   }
161 }

Query parameters

company_idstringOptional

has_product_idbooleanOptional

Filter out plans that do not have a billing product ID

idsstringOptional

plan_typeenumOptional

Filter by plan type

Allowed values:

qstringOptional

without_entitlement_forstringOptional

Filter out plans that already have a plan entitlement for the specified feature ID

without_product_idbooleanOptional

Filter out plans that have a billing product ID

without_paid_product_idbooleanOptional

Filter out plans that have a paid billing product ID

limitintegerOptional

Page limit (default 100)

offsetintegerOptional

Page offset (default 0)

Response

datalist of objects

The returned resources

paramsobject

Input parameters

List plans

Headers

Query parameters

Response

Errors