List of Quotes API
The Quotes List endpoint retrieves a paginated collection of inspirational quotes from the Koniat platform. It supports filtering by authors, themes, categories, and languages, allowing applications to retrieve only the quotes relevant to their users.
Multiple filter values can be supplied as comma-separated IDs, making it easy to fetch quotes that match one or more criteria in a single request.
Purpose
The Quotes List endpoint provides a flexible and efficient way to retrieve quote collections. It enables developers to build powerful browsing, searching, and filtering experiences while minimizing the number of API requests.
Authentication
This endpoint is protected and requires a valid Bearer Access Token.
Include the access token in the request header.
Authorization: Bearer YOUR_ACCESS_TOKEN
Requests without a valid access token will be rejected.
Endpoint
GET
https://api.koniat.com/Api/Gateway/Quote/List
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer Access Token obtained from the Authentication API. |
| Accept | Yes | application/json |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | String | No | Comma-separated author IDs. Example: 1,5,8. |
| order | String | No | |
| sortBy | String | No | |
| page | String | No | |
| limit | String | No |
Multiple filters can be combined within the same request.
API Request
Expected Output
{
"status": 200,
"type": "RFC reference URL",
"title": "Success",
"dateTime": "UTC Datetime string",
"detail": "Reason?"
}Data Credibility
All quotes available through the Koniat API are curated and maintained to ensure:
- High-quality inspirational content
- Accurate author attribution
- Consistent themes and categories
- Reliable multilingual support
- Well-structured metadata
- Regular content updates
The API is designed to provide dependable data suitable for production applications.
Key Features
- Retrieve paginated quote collections
- Filter by multiple authors
- Filter by multiple themes
- Filter by multiple categories
- Filter by multiple languages
- Combine multiple filters in a single request
- Lightweight JSON responses
- Secure Bearer Token authentication
- Consistent response structure
- RESTful API design
- Optimized for high-performance applications
Error Handling
The endpoint returns standard HTTP status codes.
| HTTP Status | Description |
|---|---|
| 200 | Quotes retrieved successfully. |
| 400 | Invalid request parameters. |
| 401 | Unauthorized or invalid access token. |
| 403 | Access forbidden. |
| 404 | No matching quotes found. |
| 429 | Too many requests. |
| 500 | Internal server error. |
Best Practices
- Combine filters to retrieve only the data your application requires.
- Pass multiple IDs as comma-separated values to minimize API requests.
- Use pagination when displaying large quote collections.
- Cache frequently requested data where appropriate.
- Always include a valid Bearer Access Token.
- Handle empty result sets gracefully when no quotes match the supplied filters.
Common Use Cases
The Quotes List endpoint is ideal for:
- Quote browsing pages
- Search and discovery interfaces
- Motivation and wellness applications
- Daily inspiration feeds
- Educational platforms
- Content management systems
- Mobile and web applications
- Personalized quote recommendations
- Advanced filtering and search experiences
Next Step
If you need a single featured quote that refreshes daily, use the Quote of the Day endpoint.