Base URL & headers
Pagination
Solya uses two pagination schemes depending on the endpoint family. Always check the endpoint in the API Reference tab for which one applies.- Page-based (most endpoints)
- Offset-based (data-platform)
Query parameters: Response envelope:
page (1-indexed) and pageSize.Filtering & search
List endpoints accept query parameters to filter results (for exampleq 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
UseGET /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 on429 responses if you receive them. See
Error codes.
