List feature usage

GET

Query parameters

company_idstringOptional

company_keysmap from strings to stringsOptional

feature_idsstringOptional

qstringOptional

without_negative_entitlementsbooleanOptionalDefaults to false

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/feature-usage \
2      -H "X-Schematic-Api-Key: <apiKey>"

200Retrieved

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

Built with

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

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