Skip to main content

Base URL & headers

https://app.solya.app/api/...
Send JSON and your bearer token:
curl https://app.solya.app/api/brands \
  -H "Authorization: Bearer solya_sa_…" \
  -H "Content-Type: application/json"

Pagination

Solya uses two pagination schemes depending on the endpoint family. Always check the endpoint in the API Reference tab for which one applies.
Query parameters: page (1-indexed) and pageSize.
curl "https://app.solya.app/api/collections?page=1&pageSize=20" \
  -H "Authorization: Bearer solya_sa_…"
Response envelope:
{ "data": [ /* … */ ], "total": 8, "page": 1, "pageSize": 20 }
List endpoints accept query parameters to filter results (for example q for text search on catalog endpoints, plus domain-specific filters like variantId or date ranges). The exact parameters for each endpoint are documented in the API Reference tab, generated from the live OpenAPI spec.

Token introspection

Use GET /api/auth/whoami to verify a token and read its organization and effective permissions — see Authentication.

Rate limiting

The application does not currently enforce request rate limits at the API layer. Limits may be applied by infrastructure in front of the API, so write clients defensively: honor standard HTTP semantics and back off on 429 responses if you receive them. See Error codes.