Capabilities and plans
Authorization checks capabilities, not plan names in URLs. .basic and .enriched are capability levels, not API versions.
Capability map
Section titled “Capability map”| Surface | Capability tier | Capability |
|---|---|---|
GET /brands | .basic | catalog.brands.read |
GET /brands/:brandId/tobaccos | .basic | catalog.tobaccos.basic.read |
GET /flavors | .enriched | catalog.flavors.read |
GET /tobaccos/search | .enriched | catalog.search |
Search returns enriched product data (variants and flavors). That enriched shape is part of the .enriched tier alongside the endpoints above.
| Plan | Capabilities | Max active keys | Notes |
|---|---|---|---|
| Starter | .basic | 1 | Brands and tobaccos; self-serve checkout |
| Pro | .enriched (includes all .basic) | 3 | Flavors + search; self-serve checkout |
| Business | .enriched | 10 | Higher RPM; sales-configured (contact support); custom RPM possible |
What each tier exposes
Section titled “What each tier exposes”.basic
Section titled “.basic”Normalized catalog structure: brands, tobacco products, variants, formats, gram weights, names / display names.
.enriched
Section titled “.enriched”Everything in .basic, plus flavors and tobacco search (q, optional grams, pagination).
Billing grace
Section titled “Billing grace”If a subscription becomes past due, API access continues for 7 calendar days. After that window, requests receive 402 BILLING_REQUIRED until billing is restored. See Errors and rate limits.
Pricing
Section titled “Pricing”Commercial details and checkout: shishapp.es/pricing. Business and key support: support@shishapp.es.