99 Names of Allah

Asma ul Husna with Arabic, transliteration, English meanings, search, random selection, and daily recitation by day number.

Endpoints

GET/api/v1/asma-ul-husna

Retrieve all available Asma ul Husna records.

---

Query Parameters

Parameter	Type	Description
api_key *	string	Your API key, or use the X-API-Key header.

Notes

• Each record may include an audio field when audio is available.
• Local audio is delivered through a signed /audio/... URL with expires and signature query parameters.
• The audio route validates the signature and expiration before serving the file.

---

Try 99 Names API

Try 99 Names of Allah API

Use your API key to request the full Asma ul Husna list live from the docs.

API Key *Your API key to authenticate the request.

GET /api/v1/asma-ul-husna?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/asma-ul-husna?api_key=YOUR_KEY"

Example Response

{
  "success": true,
  "count": 99,
  "data": [
    {
      "number": 1,
      "name": "Ar-Rahman",
      "audio": "https://your-domain.com/audio/asma-ul-husna/01.mp3?expires=1710000000&signature=0123456789abcdef...",
      "languages": {
        "en": {
          "arabic": "الرَّحْمَـٰنُ",
          "transliteration": "Ar-Rahman",
          "translation": "The Most Merciful",
          "meaning": "The one who is most merciful"
        },
        "bn": {
          "transliteration": "অর-রাহমান",
          "translation": "সর্বাধিক করুণাময়",
          "meaning": "যিনি সবচেয়ে করুণাময়"
        }
      }
    }
  ],
  "timestamp": "2026-05-11T12:00:00.000Z",
  "api_info": {
    "usage": "GET /api/v1/asma-ul-husna?api_key=YOUR_KEY"
  }
}

---

Get Name by Number

GET/api/v1/asma-ul-husna/{number}

Return a specific name from the list by number. The returned record includes a signed audio URL when audio is available, plus nested languages.en and languages.bn payloads.

URL Parameters

Parameter	Type	Description
number *	integer	Name number between 1 and 99.

---

Try Get Name by Number

Try Asma ul Husna by Number

Enter a name number and your API key to request a specific record.

Number *Name number between 1 and 99.

API Key *Used as the api_key query parameter.

GET /api/v1/asma-ul-husna/{number}?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/asma-ul-husna/1?api_key=YOUR_KEY"

Example Response

{
  "success": true,
  "data": {
    "number": 1,
    "name": "Ar-Rahman",
    "audio": "https://your-domain.com/audio/asma-ul-husna/01.mp3?expires=1710000000&signature=0123456789abcdef...",
    "languages": {
      "en": {
        "arabic": "الرَّحْمَـٰنُ",
        "transliteration": "Ar-Rahman",
        "translation": "The Most Merciful",
        "meaning": "The one who is most merciful"
      },
      "bn": {
        "transliteration": "অর-রাহমান",
        "translation": "সর্বাধিক করুণাময়",
        "meaning": "যিনি সবচেয়ে করুণাময়"
      }
    }
  },
  "timestamp": "2026-05-11T12:00:00.000Z",
  "api_info": {
    "usage": "GET /api/v1/asma-ul-husna/1?api_key=YOUR_KEY"
  }
}

---

Random Name

GET/api/v1/asma-ul-husna/random

Return a random name from the database.

Try Random Name

Try Random Asma ul Husna

Request a random name from the database using your API key.

API Key *Your API key to authenticate the request.

GET /api/v1/asma-ul-husna/random?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/asma-ul-husna/random?api_key=YOUR_KEY"

---

Search Names

GET/api/v1/asma-ul-husna/search?q=merciful

Search names by Arabic, transliteration, English, or meaning.

Try Search Names

Try Asma ul Husna Search

Search the 99 names list by Arabic, transliteration, English, or meaning.

Search Query *Search text to match Arabic, transliteration, English, or meaning.

API Key *Used as the api_key query parameter.

GET /api/v1/asma-ul-husna/search?q=merciful&api_key=YOUR_KEY

Query Parameters

Parameter	Type	Description
q *	string	Search query text.

Example Request

curl "https://your-domain.com/api/v1/asma-ul-husna/search?q=merciful&api_key=YOUR_KEY"

---

Daily Name

GET/api/v1/asma-ul-husna/daily/{day}

Returns the name for a given day number. If the day is omitted, the API returns today’s daily name based on the current date.

Try Daily Name

Try Daily Asma ul Husna

Get the daily name by day number or leave it blank to use today’s cycle.

Day Optional day number between 1 and 99.

API Key *Used as the api_key query parameter.

GET /api/v1/asma-ul-husna/daily/5?api_key=YOUR_KEY

URL Parameters

Parameter	Type	Description
day	integer	Day number between 1 and 99. Defaults to today’s day-of-month cycle.

Example Request

curl "https://your-domain.com/api/v1/asma-ul-husna/daily/5?api_key=YOUR_KEY"

---

Error Responses

Missing search query — 400 Bad Request

{
  "error": "q query parameter is required"
}

Invalid number — 400 Bad Request

{
  "error": "number must be a valid integer"
}

Name not found — 404 Not Found

{
  "error": "Name number 150 not found"
}