Wasilah

Get the five daily prayer times plus sunrise for a city or coordinates, computed with the same engine as the Wasilah app. On Fridays, Dhuhr is marked as Jumu’ah.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name to resolve, e.g. \"Dhaka\" or \"Madinah\". Ignored when latitude and longitude are given."
    },
    "latitude": {
      "type": "number",
      "description": "Latitude in degrees, north positive."
    },
    "longitude": {
      "type": "number",
      "description": "Longitude in degrees, east positive."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone, e.g. \"Asia/Dhaka\". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer."
    },
    "date": {
      "type": "string",
      "description": "Date as YYYY-MM-DD. Defaults to today in the location’s timezone."
    },
    "method": {
      "type": "string",
      "enum": [
        "karachi",
        "isna",
        "mwl",
        "makkah",
        "egypt",
        "tehran",
        "gulf",
        "kuwait",
        "qatar",
        "singapore",
        "france",
        "turkey",
        "russia"
      ],
      "description": "Calculation method. Defaults to \"karachi\" (the app default)."
    },
    "asr": {
      "type": "string",
      "enum": [
        "auto",
        "shafii",
        "hanafi"
      ],
      "description": "Asr juristic method. \"auto\" follows the calculation method’s regional default."
    },
    "offset_minutes": {
      "type": "object",
      "description": "Optional per-prayer adjustment in whole minutes, matching the offset settings in the Wasilah app, e.g. {\"maghrib\": 3}. Applies to the five obligatory prayers only; Sunrise is never offset. These are the user's own adjustments, not a calculation method.",
      "properties": {
        "fajr": {
          "type": "integer"
        },
        "dhuhr": {
          "type": "integer"
        },
        "asr": {
          "type": "integer"
        },
        "maghrib": {
          "type": "integer"
        },
        "isha": {
          "type": "integer"
        }
      },
      "additionalProperties": false
    }
  }
}

Get the next upcoming prayer and how long until it begins, for a city or coordinates.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name to resolve, e.g. \"Dhaka\" or \"Madinah\". Ignored when latitude and longitude are given."
    },
    "latitude": {
      "type": "number",
      "description": "Latitude in degrees, north positive."
    },
    "longitude": {
      "type": "number",
      "description": "Longitude in degrees, east positive."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone, e.g. \"Asia/Dhaka\". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer."
    },
    "method": {
      "type": "string",
      "enum": [
        "karachi",
        "isna",
        "mwl",
        "makkah",
        "egypt",
        "tehran",
        "gulf",
        "kuwait",
        "qatar",
        "singapore",
        "france",
        "turkey",
        "russia"
      ]
    },
    "asr": {
      "type": "string",
      "enum": [
        "auto",
        "shafii",
        "hanafi"
      ]
    },
    "offset_minutes": {
      "type": "object",
      "description": "Optional per-prayer adjustment in whole minutes, matching the offset settings in the Wasilah app, e.g. {\"maghrib\": 3}. Applies to the five obligatory prayers only; Sunrise is never offset. These are the user's own adjustments, not a calculation method.",
      "properties": {
        "fajr": {
          "type": "integer"
        },
        "dhuhr": {
          "type": "integer"
        },
        "asr": {
          "type": "integer"
        },
        "maghrib": {
          "type": "integer"
        },
        "isha": {
          "type": "integer"
        }
      },
      "additionalProperties": false
    }
  }
}

Get the Qibla direction (compass bearing to the Kaaba) for a city or coordinates.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name to resolve, e.g. \"Dhaka\" or \"Madinah\". Ignored when latitude and longitude are given."
    },
    "latitude": {
      "type": "number",
      "description": "Latitude in degrees, north positive."
    },
    "longitude": {
      "type": "number",
      "description": "Longitude in degrees, east positive."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone, e.g. \"Asia/Dhaka\". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer."
    }
  }
}

Get the Islamic (Hijri) date for a given Gregorian date, or today.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Gregorian date as YYYY-MM-DD. Defaults to today (UTC)."
    }
  }
}

Get the Islamic Foundation Bangladesh published time offset from Dhaka for a Bangladeshi district, for sehri end and iftar. Omit the district to list all 64. These are IFB's own published values, not a computation.

{
  "type": "object",
  "properties": {
    "district": {
      "type": "string",
      "description": "District name in English or Bengali, e.g. Sylhet or সিলেট."
    }
  }
}

Get a full Hijri month mapped to Gregorian dates, with the significant days that fall in it. Give a Hijri year and month, or a Gregorian date to get the month containing it. Dates are calendar positions, not sighting announcements.

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "description": "Hijri year, e.g. 1448."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Hijri month number, 1 = Muharram."
    },
    "date": {
      "type": "string",
      "description": "Gregorian date YYYY-MM-DD; returns the Hijri month containing it. Defaults to today."
    },
    "method": {
      "type": "string",
      "enum": [
        "umm_al_qura",
        "tabular"
      ],
      "description": "umm_al_qura (default, the Saudi civil calendar) or tabular (Kuwaiti arithmetic)."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "bn"
      ],
      "description": "Language for significant-day notes. Defaults to en."
    }
  }
}

Look up the 99 Names of Allah (Asma ul Husna). Returns Arabic, transliteration, English and Bengali. Give a number for one name, a search term to match by meaning or transliteration, or neither to get all 99.

{
  "type": "object",
  "properties": {
    "number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99,
      "description": "Name number, 1 to 99."
    },
    "search": {
      "type": "string",
      "description": "Match against transliteration, English meaning, Bengali or Arabic."
    }
  }
}

Look up the dhikr phrases in the Wasilah tasbeeh counter: Arabic, transliteration, English and Bengali meaning, and the customary count. Give a phrase to look one up, or omit it for all six.

{
  "type": "object",
  "properties": {
    "dhikr": {
      "type": "string",
      "description": "Phrase to look up, by transliteration, meaning or Arabic, e.g. \"SubhanAllah\", \"forgiveness\" or \"أستغفر\"."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "bn"
      ],
      "description": "Language for meanings and notes. Defaults to en."
    }
  }
}

Get streaming audio for a surah, plus the surah name and ayah count. Most reciters return a single full-surah URL; the rest return per-ayah numbering to build a playlist from.

{
  "type": "object",
  "properties": {
    "surah": {
      "type": "integer",
      "minimum": 1,
      "maximum": 114,
      "description": "Surah number, 1 to 114."
    },
    "reciter": {
      "type": "string",
      "enum": [
        "ar.alafasy",
        "ar.abdulbasitmurattal",
        "ar.abdullahbasfar",
        "ar.husary",
        "ar.husarymujawwad",
        "ar.minshawi",
        "ar.muhammadayyoub",
        "ar.muhammadjibreel",
        "ar.hudhaify",
        "ar.mahermuaiqly",
        "ar.shaatree",
        "ar.ahmedajamy"
      ],
      "description": "Reciter edition. Defaults to \"ar.alafasy\" (Mishary Rashid Alafasy). Only ar.alafasy, ar.abdulbasitmurattal and ar.abdullahbasfar have single-file surah audio; the others are per-ayah."
    }
  },
  "required": [
    "surah"
  ]
}