Get Chapter Info

Get Chapter Info in specific language. Default to English. Supports selecting a specific resource via resource_id and listing available resources via include_resources=true. Use include_resources=true to discover the resource ids or slugs that actually have chapter-info content for the resolved chapter and language. The /resources/chapter_infos endpoint is a global catalog of chapter-info resources and may include resources that return chapter_info: null for a specific chapter.

Path Parameters

id integer required

Possible values: >= 1 and <= 114

Chapter number (1-114)

Query Parameters

language string

Default value: en

Language ISO code for translated metadata. Defaults to English.

locale string

Locale fallback if a language code is not provided.

resource_id string

Resource id or slug of the chapter info resource to fetch. Prefer identifiers returned by include_resources=true for the current chapter. The /resources/chapter_infos endpoint is a global catalog and may include resources that do not have chapter-info content for this specific chapter, which would return chapter_info: null.

include_resources string

Possible values: [true, false]

Default value: false

Include the ordered list of available chapter info resources that actually have content for the resolved chapter and language. This is the safest discovery path for the id or slug to pass as resource_id for a specific author such as Ibn Ashur.

Responses

Successful response

application/json

Schema

Example (from schema)

Example

Schema

chapter_info object nullable

chapter_id integer required

text string required

Long chapter info text; may include HTML markup for formatting.

short_text string required

language_name string required

source string required

Name of the source, such as a book or site title.

id integer required

resource_id integer required

resources object[]

Only returned when include_resources=true. Contains approved chapter info resources that have chapter-info content for the resolved chapter and language, ordered by the API's preferred resource order for selection.

Array [

id integer

name string

author_name string

slug string

language_name string

translated_name object

name string

language_name string

]

{
  "chapter_info": {
    "chapter_id": 1,
    "text": "<h2>Name</h2>\n<p>This Surah is named Al-Fatihah because of its subject-matter. Fatihah opens the book and the subject.</p>",
    "short_text": "This Surah is named Al-Fatihah because of its subject-matter. Fatihah opens the book and the subject.",
    "language_name": "english",
    "source": "Sayyid Abul Ala Maududi - Tafhim al-Qur'an - The Meaning of the Quran",
    "id": 1,
    "resource_id": 58
  },
  "resources": [
    {
      "id": 169,
      "name": "Tafsir Ibn Kathir",
      "author_name": "Hafiz Ibn Kathir",
      "slug": "en-tafsir-ibn-kathir",
      "language_name": "english",
      "translated_name": {
        "name": "Tafsir Ibn Kathir",
        "language_name": "english"
      }
    }
  ]
}

{
  "chapter_info": {
    "id": 1,
    "chapter_id": 1,
    "language_name": "english",
    "short_text": "This Surah is named Al-Fatihah because of its subject-matter. Fatihah is that which opens a subject or a book or any other thing. In other words, Al-Fatihah is a sort of preface.",
    "source": "Sayyid Abul Ala Maududi - Tafhim al-Qur'an - The Meaning of the Quran",
    "text": "<h2>Name</h2>\r\n<p>This Surah is named Al-Fatihah because of its subject-matter. Fatihah is that which opens a subject or a book or any other thing. In other words, Al-Fatihah is a sort of preface.</p>\r\n<h2>Period of Revelation</h2>...",
    "resource_id": 58
  },
  "resources": [
    {
      "id": 58,
      "name": "Chapter Info",
      "author_name": "Sayyid Abul Ala Maududi",
      "slug": "",
      "language_name": "english",
      "translated_name": {
        "name": "Chapter Info",
        "language_name": "english"
      }
    }
  ]
}

Will be returned when the request is invalid e.g. request is missing required headers or with invalid query parameters.

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 is missing required headers or is invalid",
  "type": "invalid_request",
  "success": false
}

Will be returned when the request is unauthorized.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

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
}

Not Found. The resource being accessed does not exist.

application/json

Schema

Example (from schema)

Example

Schema

message string

type string

success boolean

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

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 Chapter Info​

Get Chapter Info