Get answers for specific Ayah

Get the published questions and answers shown under a specific ayah. Non-Arabic languages resolve to English upstream. This upstream endpoint uses the query parameter name pageSize instead of the API-wide per_page convention. If page is omitted, pagination is not applied even when pageSize is provided.

Path Parameters

ayah_key string required

Ayah key in chapter:verse format, for example 2:255.

Query Parameters

page integer

Possible values: >= 1

1-based page number. When omitted, pagination is not applied.

pageSize integer

Possible values: >= 1 and <= 10

Page size when page is provided. This upstream endpoint uses pageSize instead of the API-wide per_page convention. Maximum 10.

language string

Default value: en

Requested language. ar returns Arabic; every other language resolves to English upstream.

Responses

Successful response

application/json

Schema

Example (from schema)

default_success

questions_found

no_questions

Schema

questions object[] required

Array [

id string required

Question identifier.

body string required

Question text.

type string required

Possible values: [CLARIFICATION, TAFSIR, COMMUNITY]

ranges string[] required

Verse ranges returned by the internal DTO, e.g. 2:255-2:257.

surah integer required

Surah number associated with the question.

theme string[]

summary string

references string[]

language string

Question language ISO code when present.

status string required

Possible values: [New, Draft, Published, Answered]

answers object[] required

Array [

id string required

Answer identifier.

body string required

Published answer body.

answeredBy string

Display name of the responder.

status string required

Possible values: [Draft, Published]

language string

Answer language ISO code when present.

]

totalCount integer required

Total number of matching questions before pagination.

{
  "questions": [
    {
      "id": "string",
      "body": "string",
      "type": "CLARIFICATION",
      "ranges": [
        "string"
      ],
      "surah": 0,
      "theme": [
        "string"
      ],
      "summary": "string",
      "references": [
        "string"
      ],
      "language": "string",
      "status": "New",
      "answers": [
        {
          "id": "string",
          "body": "string",
          "answeredBy": "string",
          "status": "Draft",
          "language": "string"
        }
      ]
    }
  ],
  "totalCount": 0
}

Successful response

{
  "questions": [
    {
      "id": "question-1",
      "body": "What is the context of this ayah?",
      "type": "CLARIFICATION",
      "ranges": [
        "2:255"
      ],
      "surah": 2,
      "theme": [
        "Faith"
      ],
      "references": [
        "Tafsir al-Tabari"
      ],
      "language": "en",
      "status": "Published",
      "answers": [
        {
          "id": "answer-1",
          "body": "This ayah is known as Ayat al-Kursi.",
          "answeredBy": "Scholar",
          "status": "Published",
          "language": "en"
        }
      ]
    }
  ],
  "totalCount": 1
}

Ayah with published answers

{
  "questions": [
    {
      "id": "question-1",
      "body": "What is the context of this ayah?",
      "type": "CLARIFICATION",
      "ranges": [
        "2:255"
      ],
      "surah": 2,
      "theme": [
        "Faith"
      ],
      "references": [
        "Tafsir al-Tabari"
      ],
      "language": "en",
      "status": "Published",
      "answers": [
        {
          "id": "answer-1",
          "body": "This ayah is known as Ayat al-Kursi.",
          "answeredBy": "Scholar",
          "status": "Published",
          "language": "en"
        }
      ]
    }
  ],
  "totalCount": 1
}

Ayah with no answers

{
  "questions": [],
  "totalCount": 0
}

Invalid parameter. Returned for malformed ayah keys, invalid ranges, or invalid pagination values.

application/json

Schema

Example (from schema)

Example

Schema

status integer required

error object required

code string required

Possible values: [INVALID_PARAMETER, NOT_FOUND]

message string required

details object

property name* any

{
  "status": 0,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "string",
    "details": {}
  }
}

{
  "status": 400,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid ayah_key format. Expected format: chapter:verse (e.g., 12:12)",
    "details": {
      "parameter": "ayah_key",
      "provided": "2-255",
      "expected": "12:12"
    }
  }
}

Will be returned when the request is unauthorized.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

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]

success boolean

{
  "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.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "message": "string",
  "type": "gateway_timeout",
  "success": true
}

{
  "message": "The server understood the request, but refuses to authorize it",
  "type": "forbidden",
  "success": false
}

Validation Error. The request includes one or more invalid params. Please check the request params and try again.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

{
  "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
}

Get answers for specific Ayah​

Get answers for specific Ayah