Skip to content

API reference

Commercial Public API endpoints, parameters, and curl examples — generated from the OpenAPI contract.

All endpoints require the X-API-Key header. Production base URL: https://api.shishapp.es

Download OpenAPI

Authentication

Send your commercial API key on every request:

X-API-Key: ska_v1_…_…
GET /api/public/v1/brands

List brands (.basic)

brand

Returns all tobacco brands in the catalog.

Capability
catalog.brands.read .basic Starter+

Parameters

No parameters.

Responses

  • 200 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Example

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/brands"
GET /api/public/v1/brands/{brandId}/tobaccos

List tobaccos by brand (.basic)

tobacco

Returns tobacco products for a brand (basic product fields).

Capability
catalog.tobaccos.basic.read .basic Starter+

Parameters

Name In Type Description
brandId path string · uuid Brand UUID required

Responses

  • 200 — Default Response
  • 400 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 404 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Example

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/brands/00000000-0000-0000-0000-000000000001/tobaccos"
GET /api/public/v1/flavors

List flavor tags (.enriched)

flavors

Returns all flavor tags.

Capability
catalog.flavors.read .enriched Pro / Business

Parameters

No parameters.

Responses

  • 200 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Example

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/flavors"
GET /api/public/v1/tobaccos/search

Search tobaccos (.enriched)

tobacco

Search tobacco products by name across brands. Returns enriched product data (variants and flavors) with pagination.

Capability
catalog.search .enriched Pro / Business
Query rules
q must be 2–100 characters (trimmed). grams is optional. page defaults to 1; pageSize defaults to 20 (max 50).

Parameters

Name In Type Description
q query string Search query (product name, 2–100 chars) required
grams query integer Optional: filter by grams optional
page query integer Page number (1-based) optional
pageSize query integer Results per page (max 50) optional

Responses

  • 200 — Default Response
  • 400 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Example

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/tobaccos/search?q=kent&grams=50&page=1&pageSize=20"