Donate

Find Themes API

The Themes List endpoint returns a paginated collection of all available quote themes in the Koniat platform. Themes are used to organize quotes based on their subject or message, making it easier to discover and filter inspirational content.

This endpoint is ideal for populating dropdowns, filters, navigation menus, and theme selection interfaces.

Purpose

The Themes List endpoint provides developers with a centralized way to retrieve all available themes. It enables applications to organize quotes by subject and create better browsing and filtering experiences for users.

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/Theme/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
page	Integer	No	Page number for paginated results. Default is 1.
per_page	Integer	No	Number of records returned per page. Default value is configured by the server.

Example Request

curl-G"https://api.koniat.com/Api/Gateway/Theme/List"\

-H"Accept: application/json"\

-H"Authorization: Bearer GENERATED_ACCESSTOKEN"\

--data-urlencode"query: search keywords goes here"\

--data-urlencode"page: 1"\

--data-urlencode"limit: 20"

Expected Output

{
  "status": 200,
  "type": "RFC reference URL",
  "title": "Success",
  "dateTime": "UTC Datetime string",
  "detail": "Reason?"
}

Data Credibility

Theme data is curated and maintained by Koniat to ensure:

Consistent theme naming
Unique theme identifiers
Well-organized quote classification
Reliable metadata
Regular updates and maintenance
Production-ready data quality

Key Features

Retrieve all available quote themes
Paginated responses
Lightweight JSON format
Secure Bearer Token authentication
Consistent response structure
RESTful API design
Fast response times
Easy integration with filtering and navigation components

Error Handling

The endpoint returns standard HTTP status codes.

HTTP Status	Description
200	Themes retrieved successfully.
400	Invalid request parameters.
401	Unauthorized or invalid access token.
403	Access forbidden.
404	No themes found.
429	Too many requests.
500	Internal server error.

Best Practices

Cache theme data since themes generally change infrequently.
Use pagination when displaying large theme collections.
Always send a valid Bearer Access Token.
Use theme IDs when filtering quotes or requesting theme details.
Handle empty result sets gracefully.

Common Use Cases

The Themes List endpoint is ideal for:

Theme selection dropdowns
Quote filtering interfaces
Website navigation menus
Mobile application filters
Content management systems
Analytics dashboards
Search and discovery features

Next Step

To retrieve detailed information for one or more specific themes, continue to the Get Themes endpoint documentation.