# Suverse Quran Surah Lookup

> Suverse Quran Surah Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the full text of any Quran surah (chapter) with all ayahs in any edition or translation, including metadata like English name, revelation type, and ayah count.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-rel-quran-surah
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-quran-surah-lookup-62dd1af5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0uj8kS8Ap-57G2gE5IwWl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suverse-quran-surah-lookup-62dd1af5 -d '<json body>'
```

Example prompt: Fetch the full text of Surah Al-Baqarah (surah 2) in the Muhammad Asad English translation (en.asad) along with its ayah count and revelation type.

## When to prefer this

Choose this endpoint when you need the complete text of an entire Quran chapter (surah) with all its verses in a specific translation or edition, especially when you also need metadata like English name, revelation type, and ayah count. It is keyless, making it ideal for agents that need scripture access without managing API credentials. Prefer it over verse-level lookups when processing or analyzing a full chapter at once.

## Known failure modes

- Invalid surah number (Quran has 114 surahs) — returns error or empty result
- Unrecognized edition/translation identifier — may return error or null data
- Network timeout to upstream Al Quran Cloud service
- Malformed request body — returns validation error

## How this service works

Full Quran surah (chapter) with every ayah in any edition/translation (en.asad, quran-uthmani, etc). Includes English name, revelation type, ayah count. Keyless Al Quran Cloud. For agents reading or analyzing scripture.

## Output

Returns a structured JSON object containing the full surah with every ayah's text in the requested edition or translation, along with the surah's English name, Arabic name, revelation type (Meccan or Medinan), and total ayah count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-quran-surah-lookup-62dd1af5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)