Skip to content

Capabilities and plans

Authorization checks capabilities, not plan names in URLs. .basic and .enriched are capability levels, not API versions.

SurfaceCapability tierCapability
GET /brands.basiccatalog.brands.read
GET /brands/:brandId/tobaccos.basiccatalog.tobaccos.basic.read
GET /flavors.enrichedcatalog.flavors.read
GET /tobaccos/search.enrichedcatalog.search

Search returns enriched product data (variants and flavors). That enriched shape is part of the .enriched tier alongside the endpoints above.

PlanCapabilitiesMax active keysNotes
Starter.basic1Brands and tobaccos; self-serve checkout
Pro.enriched (includes all .basic)3Flavors + search; self-serve checkout
Business.enriched10Higher RPM; sales-configured (contact support); custom RPM possible

Normalized catalog structure: brands, tobacco products, variants, formats, gram weights, names / display names.

Everything in .basic, plus flavors and tobacco search (q, optional grams, pagination).

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.

Commercial details and checkout: shishapp.es/pricing. Business and key support: support@shishapp.es.