# Prayertimes (prayertimes.com) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get accurate daily prayer times (Fajr, Dhuhr, Asr, Maghrib, and Isha) for thousands of cities worldwide, plus Iftar and Imsak timings and Islamic calendar dates. Search by country and city to find prayer schedules wherever you are.

**Category:** Other | **Website:** [prayertimes.com/](https://prayertimes.com/) | **Docs:** [parse.bot/marketplace/9a8ed8f9-0caa-47ae-b610-5c5152964059/prayertimes-com-api](https://parse.bot/marketplace/9a8ed8f9-0caa-47ae-b610-5c5152964059/prayertimes-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-prayertimes-com-api-9a8ed8f9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cities_alphabetical

Retrieve the global list of cities available on prayertimes.com, optionally filtered by the first letter of the city name. Without a letter filter, returns all cities from the index page. With a letter, fetches the corresponding letter page and filters to cities starting with that letter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single uppercase letter A–Z to filter cities by their first character. Omitting returns all cities from the index page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-com-api-9a8ed8f9/get_cities_alphabetical \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_city_prayer_times

Retrieve today's prayer times for a specific city, including Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, and derived Iftar/Imsak timings. Requires both the country slug and city slug. Times are in local time for that city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City slug from get_country_cities endpoint (e.g. 'london', 'istanbul'). |
| `country` | string | Yes | Country slug from list_countries endpoint (e.g. 'uk', 'turkey'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-com-api-9a8ed8f9/get_city_prayer_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","country":"<string>"}'
```

### get_country_cities

Retrieve all cities available for a specific country, along with date information (Gregorian, Hijri, and Rumi calendars). Use the country slug from list_countries as input. City slugs from the response are used as input to get_city_prayer_times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug from list_countries endpoint (e.g. 'uk', 'usa', 'turkey', 'albania'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-com-api-9a8ed8f9/get_country_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>"}'
```

### list_countries

Retrieve the complete list of countries and regions supported by prayertimes.com. Returns an array of country objects with name, slug, and URL. Use country slugs as input to get_country_cities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-com-api-9a8ed8f9/list_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```