Get answer thread by question ID

Get a single published question with its published answers. This endpoint does not accept a language filter and preserves the internal answers payload without extra language filtering.

Path Parameters

question_id string required

Question identifier from the answers payload.

Responses

• 200
• 401
• 403
• 404
• 422
• 429
• 500
• 502
• 503
• 504

---

Successful response

application/json

Schema

Example (from schema)

default_success

---

Schema

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.
]

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

Successful response

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

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

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 server understood the request, but refuses to authorize it",
  "type": "forbidden",
  "success": false
}

Not Found. Returned when the requested published question does not exist.

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": 404,
  "error": {
    "code": "NOT_FOUND",
    "message": "Question not found"
  }
}

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

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

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

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

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

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

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 server was acting as a gateway or proxy and did not receive a timely response from the upstream server",
  "type": "gateway_timeout",
  "success": false
}

Loading...