# Suverse Quran Ayah Lookup

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

Fetches a single Quran ayah (verse) by its global verse number in any specified edition or translation via Al Quran Cloud, with no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-rel-quran-ayah
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-quran-ayah-lookup-2108f664
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hQUCa-GLsHFO2Ink1CwDT

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-ayah-lookup-2108f664 -d '<json body>'
```

Example prompt: Can you fetch Quran verse number 255 (Ayat al-Kursi) in the en.asad English translation for me?

## When to prefer this

Use this endpoint when you need to retrieve a specific Quran ayah by its global sequential verse number (1–6236) and want a keyless, pay-per-call approach without setting up an Al Quran Cloud account. It is ideal for agents quoting, studying, or displaying Quranic scripture in any supported edition or translation (Arabic, English, Urdu, etc.). Prefer this over direct Al Quran Cloud API calls when you want a proxied, no-key-required solution with micropayment billing.

## Known failure modes

- Invalid global verse number (out of range 1–6236) returns an error or empty result
- Unsupported or misspelled edition identifier (e.g. typo in 'en.asad') returns an edition-not-found error
- Malformed request body (missing required fields) returns a validation error
- Upstream Al Quran Cloud API unavailability causes a timeout or 502 error
- Payment failure or insufficient USDC balance prevents the call from completing

## How this service works

Single Quran ayah by global verse number in any edition/translation (en.asad, quran-uthmani, etc). Keyless Al Quran Cloud. For agents quoting or studying scripture.

## Output

Returns the full text of the requested Quran ayah in the specified edition or translation, along with metadata such as the verse number, surah name, edition identifier, and any relevant numbering details from Al Quran Cloud.

## 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-ayah-lookup-2108f664/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)