Get tafsirs for specific Ayah​
Get list of tafsirs for a specific Ayah.
Path Parameters
Tafsir resource ID
Ayah key is combination of surah number and ayah number. e.g 1:1 will be first Ayah of first Surah
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
- 502
- 503
- 504
Successful response
Schema
tafsir object
verses object required
Hash map of ayah_key → tafsir-record
property name* object
translated_name object required
HTML-formatted tafsir body
{
"tafsir": {
"verses": {},
"resource_id": 0,
"resource_name": "string",
"language_id": 0,
"slug": "string",
"translated_name": {
"name": "string",
"language_name": "string"
},
"text": "string"
}
}
{
"tafsir": {
"verses": {
"2:111": {
"id": 118
},
"2:112": {
"id": 119
},
"2:113": {
"id": 120
}
},
"resource_id": 168,
"resource_name": "Ma'arif al-Qur'an",
"language_id": 38,
"slug": "en-tafsir-maarif-ul-quran",
"translated_name": {
"name": "Ma'arif al-Qur'an",
"language_name": "english"
},
"text": "<p>…HTML tafsīr…</p>"
}
}
Will be returned when the request is invalid e.g. request is missing required headers or with invalid query parameters.
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 is missing required headers or is invalid",
"type": "invalid_request",
"success": false
}
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
}
Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions.
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. The resource being accessed does not exist.
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 requested resource could not be found",
"type": "not_found",
"success": false
}
Validation Error. The request includes one or more invalid params. Please check the request params and try again.
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 was well-formed but was unable to be followed due to semantic errors",
"type": "unprocessable_entity",
"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
}