Groups in Flexprice let you organize prices and features into named buckets—e.g. by product line, region, or tier. You can then filter and display them by group in invoices, catalogs, analytics, and the customer portal Usage tab.
Flexprice supports grouping for prices and features. Each group holds one entity type only (entity_type: "price" or "feature").
- Organize — Bucket prices or features by product line, region, tier, or any dimension
- Filter — Search groups by
lookup_key, name, entity_type. List entities with group on each
- Charges (prices) — Group charges in a plan. Grouped invoice line-items
- Features — Group features for lists and filters. Feature search can filter by
group_id. Usage breakdown in analytics and customer portal reflects feature usage and cost by group
API reference
| Action | Method | Endpoint |
|---|
| Create group | POST | /v1/groups |
| Get group | GET | /v1/groups/:id |
| Query groups | POST | /v1/groups/search |
| Delete group | DELETE | /v1/groups/:id |
| Create price (with group) | POST | /v1/prices |
| Update price (set/clear group) | PUT | /v1/prices/:id |
| Create feature (with group) | POST | /v1/features |
| Update feature (set/clear group) | PUT | /v1/features/:id |
name, entity_type ("price" or "feature"), lookup_key. Response returns id — use as group_id on prices or features.
Delete group: Soft-delete. Every entity in that group has group_id cleared.
When you delete a group, every price or feature in that group has its group_id cleared (no orphaned references).
Validation
| Scope | Rule |
|---|
| Group | entity_type must be "price" or "feature". lookup_key required; unique per tenant and environment (published groups). |
| Price | If group_id is set, the group must exist, be published, and have entity_type "price". |
| Feature | If group_id is set, the group must exist, be published, and have entity_type "feature". |
What’s next
- Create a group — Choose Entity Type (Price or Feature), then assign entities
- Charges grouping — Assign prices to a group when adding or editing a charge
- Feature grouping — Assign features to a group when creating or editing a feature
