List Qira'at readers
Get the Qira'at readers (the reciters whose readings are compared), ordered by position. Optionally embed each reader's transmitters with include=transmitters. The reader biography is included in the bio object whenever one exists for the requested language. Requires the qiraat.read scope (or the parent qiraat scope); a token with only the content scope receives 403 with type: insufficient_scope. Qira'at endpoints are available in production only; they are not available in the prelive environment.
Query Parameters
Comma-separated list of optional sections. Use transmitters to embed each reader's transmitters. Biographies (bio) are always returned when available.
Default value: en
Language ISO code for translated names, translations, and explanations. Defaults to en. An unknown code resolves to en. Content that is missing in a language other than en or ar falls back to English; ar does not fall back.
- 200
- 401
- 403
- 429
- 500
- 502
- 503
- 504
Successful response
Schema
- Array [
- Array [
- ]
- ]
readers object[] required
Reader name in the requested language, when available.
transmitters object[]
Present when include=transmitters is requested, and always on the single-reader endpoint.
bio object
Reader biography in the requested language, when available.
Only present on the single-reader endpoint.
meta object required
{
"readers": [
{
"id": 0,
"name": "string",
"abbreviation": "string",
"death_year_hijri": 0,
"death_year_gregorian": 0,
"position": 0,
"translated_name": "string",
"transmitters": [
{
"id": 0,
"name": "string",
"abbreviation": "string",
"is_primary": true
}
],
"bio": {
"text": "string",
"short_text": "string"
}
}
],
"meta": {
"total": 0
}
}
Successful response
{
"readers": [
{
"id": 1,
"name": "Nafi",
"abbreviation": "N",
"death_year_hijri": 169,
"death_year_gregorian": 785,
"position": 1,
"translated_name": "Nafi",
"transmitters": [
{
"id": 1,
"name": "Qalun",
"abbreviation": "Q",
"is_primary": true
}
]
}
],
"meta": {
"total": 1
}
}
Will be returned when the request is unauthorized.
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The request requires user authentication",
"type": "unauthorized",
"success": false
}
The request is forbidden, for example because a valid access token lacks the required scope or the client lacks permission.
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The server understood the request, but refuses to authorize it",
"type": "forbidden",
"success": false
}
Rate-limit exceeded
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "Too many requests, please try again later",
"type": "rate_limit_exceeded",
"success": false
}
Server Error. Something went wrong, try again later.
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The server encountered an internal error and was unable to complete your request",
"type": "internal_server_error",
"success": false
}
Bad Gateway
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The server was acting as a gateway or proxy and received an invalid response from the upstream server",
"type": "bad_gateway",
"success": false
}
Service Unavailable
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The server is currently unable to handle the request due to a temporary overload or scheduled maintenance",
"type": "service_unavailable",
"success": false
}
Gateway Timeout
Schema
Possible values: [gateway_timeout, service_unavailable, bad_gateway, internal_server_error, unprocessable_entity, not_found, forbidden, unauthorized, invalid_request, invalid_token, insufficient_scope, service_error, invalid_path, rate_limit_exceeded]
{
"message": "string",
"type": "gateway_timeout",
"success": true
}
{
"message": "The server was acting as a gateway or proxy and did not receive a timely response from the upstream server",
"type": "gateway_timeout",
"success": false
}