Get a Qira'at transmitter
Get a single Qira'at transmitter with its parent reader and biography (bio.text) when available. 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.
Path Parameters
Transmitter identifier, as returned by the transmitters endpoint.
Query Parameters
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
- 404
- 429
- 500
- 502
- 503
- 504
Successful response
Schema
transmitter object required
reader object
bio object
Transmitter biography in the requested language, when available (single-transmitter endpoint).
{
"transmitter": {
"id": 0,
"name": "string",
"abbreviation": "string",
"is_primary": true,
"death_year_hijri": 0,
"death_year_gregorian": 0,
"position": 0,
"translated_name": "string",
"reader": {
"id": 0,
"name": "string",
"abbreviation": "string"
},
"bio": {
"text": "string"
}
}
}
Successful response
{
"transmitter": {
"id": 1,
"name": "Qalun",
"abbreviation": "Q",
"is_primary": true,
"death_year_hijri": 220,
"death_year_gregorian": 835,
"position": 1,
"translated_name": "Qalun",
"reader": {
"id": 1,
"name": "Nafi",
"abbreviation": "N"
},
"bio": {
"text": "..."
}
}
}
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
}
Not Found. Returned when the transmitter does not exist.
Schema
details object required
The error body returned by the Qira'at service.
error object required
Possible values: [INVALID_PARAMETER, NOT_FOUND]
details object
Optional structured details, for example the offending parameter.
Optional structured details, for example the offending parameter.
Human-readable error message (the same text as details.error.message).
Possible values: [invalid_request, not_found]
{
"details": {
"status": 404,
"error": {
"code": "INVALID_PARAMETER",
"message": "string",
"details": {}
}
},
"message": "string",
"type": "invalid_request",
"success": false
}
{
"details": {
"status": 404,
"error": {
"code": "NOT_FOUND",
"message": "Transmitter with id 999 not found"
}
},
"message": "Transmitter with id 999 not found",
"type": "not_found",
"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
}