List plans

GET

Query parameters

company_idstringOptional

has_product_idbooleanOptional

Filter out plans that do not have a billing product ID

idsstringOptional

plan_type"plan" or "add_on"Optional

Filter by plan type

Allowed values: planadd_on

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

limitintegerOptional

Page limit (default 100)

offsetintegerOptional

Page offset (default 0)

Response

datalist of objects

The returned resources

paramsobject

Input parameters

GET

1 curl https://api.schematichq.com/plans \
2      -H "X-Schematic-Api-Key: <apiKey>"

200Retrieved

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_trialable": true,
103       "name": "name",
104       "plan_type": "plan_type",
105       "updated_at": "2024-01-15T09:30:00Z",
106       "audience_type": "audience_type",
107       "billing_product": {
108         "account_id": "account_id",
109         "created_at": "2024-01-15T09:30:00Z",
110         "currency": "currency",
111         "environment_id": "environment_id",
112         "external_id": "external_id",
113         "name": "name",
114         "price": 1.1,
115         "prices": [
116           {
117             "currency": "currency",
118             "external_price_id": "external_price_id",
119             "id": "id",
120             "interval": "interval",
121             "price": 1
122           }
123         ],
124         "product_id": "product_id",
125         "quantity": 1.1,
126         "updated_at": "2024-01-15T09:30:00Z"
127       },
128       "monthly_price": {
129         "currency": "currency",
130         "external_price_id": "external_price_id",
131         "id": "id",
132         "interval": "interval",
133         "price": 1
134       },
135       "trial_days": 1,
136       "yearly_price": {
137         "currency": "currency",
138         "external_price_id": "external_price_id",
139         "id": "id",
140         "interval": "interval",
141         "price": 1
142       }
143     }
144   ],
145   "params": {
146     "company_id": "company_id",
147     "has_product_id": true,
148     "ids": [
149       "ids"
150     ],
151     "limit": 1,
152     "offset": 1,
153     "plan_type": "plan",
154     "q": "q",
155     "without_entitlement_for": "without_entitlement_for",
156     "without_product_id": true
157   }
158 }

Built with

1	curl https://api.schematichq.com/plans \
2	-H "X-Schematic-Api-Key: <apiKey>"

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_trialable": true,
103	"name": "name",
104	"plan_type": "plan_type",
105	"updated_at": "2024-01-15T09:30:00Z",
106	"audience_type": "audience_type",
107	"billing_product": {
108	"account_id": "account_id",
109	"created_at": "2024-01-15T09:30:00Z",
110	"currency": "currency",
111	"environment_id": "environment_id",
112	"external_id": "external_id",
113	"name": "name",
114	"price": 1.1,
115	"prices": [
116	{
117	"currency": "currency",
118	"external_price_id": "external_price_id",
119	"id": "id",
120	"interval": "interval",
121	"price": 1
122	}
123	],
124	"product_id": "product_id",
125	"quantity": 1.1,
126	"updated_at": "2024-01-15T09:30:00Z"
127	},
128	"monthly_price": {
129	"currency": "currency",
130	"external_price_id": "external_price_id",
131	"id": "id",
132	"interval": "interval",
133	"price": 1
134	},
135	"trial_days": 1,
136	"yearly_price": {
137	"currency": "currency",
138	"external_price_id": "external_price_id",
139	"id": "id",
140	"interval": "interval",
141	"price": 1
142	}
143	}
144	],
145	"params": {
146	"company_id": "company_id",
147	"has_product_id": true,
148	"ids": [
149	"ids"
150	],
151	"limit": 1,
152	"offset": 1,
153	"plan_type": "plan",
154	"q": "q",
155	"without_entitlement_for": "without_entitlement_for",
156	"without_product_id": true
157	}
158	}