List feature usage

GET

Query parameters

company_idstringOptional

company_keysmap from strings to stringsOptional

feature_idsstringOptional

qstringOptional

without_negative_entitlementsbooleanOptional

limitintegerOptional

Page limit (default 100)

offsetintegerOptional

Page offset (default 0)

Response

datalist of objects

The returned resources

paramsobject

Input parameters

Errors

GET

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

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         "is_active": true,
108         "price": 1,
109         "price_external_id": "price_external_id",
110         "price_id": "price_id",
111         "product_external_id": "product_external_id",
112         "product_id": "product_id",
113         "product_name": "product_name",
114         "updated_at": "2024-01-15T09:30:00Z",
115         "usage_type": "usage_type"
116       },
117       "period": "period",
118       "plan": {
119         "created_at": "2024-01-15T09:30:00Z",
120         "description": "description",
121         "icon": "icon",
122         "id": "id",
123         "name": "name",
124         "plan_type": "plan_type",
125         "updated_at": "2024-01-15T09:30:00Z"
126       },
127       "price_behavior": "price_behavior",
128       "usage": 1,
129       "yearly_usage_based_price": {
130         "created_at": "2024-01-15T09:30:00Z",
131         "currency": "currency",
132         "id": "id",
133         "interval": "interval",
134         "is_active": true,
135         "price": 1,
136         "price_external_id": "price_external_id",
137         "price_id": "price_id",
138         "product_external_id": "product_external_id",
139         "product_id": "product_id",
140         "product_name": "product_name",
141         "updated_at": "2024-01-15T09:30:00Z",
142         "usage_type": "usage_type"
143       }
144     }
145   ],
146   "params": {
147     "company_id": "company_id",
148     "company_keys": {
149       "key": "value"
150     },
151     "feature_ids": [
152       "feature_ids"
153     ],
154     "limit": 1,
155     "offset": 1,
156     "q": "q",
157     "without_negative_entitlements": true
158   }
159 }

Built with

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

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	"is_active": true,
108	"price": 1,
109	"price_external_id": "price_external_id",
110	"price_id": "price_id",
111	"product_external_id": "product_external_id",
112	"product_id": "product_id",
113	"product_name": "product_name",
114	"updated_at": "2024-01-15T09:30:00Z",
115	"usage_type": "usage_type"
116	},
117	"period": "period",
118	"plan": {
119	"created_at": "2024-01-15T09:30:00Z",
120	"description": "description",
121	"icon": "icon",
122	"id": "id",
123	"name": "name",
124	"plan_type": "plan_type",
125	"updated_at": "2024-01-15T09:30:00Z"
126	},
127	"price_behavior": "price_behavior",
128	"usage": 1,
129	"yearly_usage_based_price": {
130	"created_at": "2024-01-15T09:30:00Z",
131	"currency": "currency",
132	"id": "id",
133	"interval": "interval",
134	"is_active": true,
135	"price": 1,
136	"price_external_id": "price_external_id",
137	"price_id": "price_id",
138	"product_external_id": "product_external_id",
139	"product_id": "product_id",
140	"product_name": "product_name",
141	"updated_at": "2024-01-15T09:30:00Z",
142	"usage_type": "usage_type"
143	}
144	}
145	],
146	"params": {
147	"company_id": "company_id",
148	"company_keys": {
149	"key": "value"
150	},
151	"feature_ids": [
152	"feature_ids"
153	],
154	"limit": 1,
155	"offset": 1,
156	"q": "q",
157	"without_negative_entitlements": true
158	}
159	}