Find Languages API
The Find Languages endpoint returns a paginated list of languages supported by the Koniat platform. It supports searching languages by name, allowing applications to build language selectors, search functionality, autocomplete suggestions, and filtering interfaces.
This endpoint returns language information only and does not include the quotes available in each language.
Purpose
The Find Languages endpoint enables developers to retrieve and search supported languages efficiently. It allows applications to present language options to users and filter quote content based on their preferred language.
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/Language/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 | Yes | Search languages by name. |
| 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. |
API Request
Expected Output
{
"status": 200,
"type": "RFC reference URL",
"title": "Success",
"dateTime": "UTC Datetime string",
"detail": "Reason?"
}Data Credibility
Language information is maintained by Koniat to ensure:
- Accurate language names
- Standard language codes
- Consistent metadata
- Reliable language support information
- Regular database maintenance
- Production-ready data quality
Key Features
- Search supported languages by name
- Fast paginated results
- Lightweight JSON responses
- Secure Bearer Token authentication
- Consistent response structure
- RESTful API design
- Optimized for search and filtering
- Easy integration with multilingual applications
Error Handling
The endpoint returns standard HTTP status codes.
| HTTP Status | Description |
|---|---|
| 200 | Languages retrieved successfully. |
| 400 | Invalid request parameters. |
| 401 | Unauthorized or invalid access token. |
| 403 | Access forbidden. |
| 404 | No languages found. |
| 429 | Too many requests. |
| 500 | Internal server error. |
Best Practices
- Use the search parameter to quickly locate specific languages.
- Cache language data, as supported languages typically change infrequently.
- Implement pagination when displaying large language collections.
- Always include a valid Bearer Access Token.
- Handle empty search results gracefully.
Common Use Cases
The Find Languages endpoint is ideal for:
- Language selection dropdowns
- Multilingual applications
- Quote language filters
- Search and autocomplete functionality
- Content management systems
- Mobile applications
- Web applications
- Internationalization (i18n) interfaces
Next Step
To retrieve detailed information for one or more specific languages, continue to the Get Languages endpoint documentation.