# Prayertimes (prayertimes.date) — 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 Islamic prayer times for any city or country, view monthly prayer schedules, and explore prayer times across popular regions worldwide. Plan your daily prayers with up-to-date timing data organized by location and calendar month.

**Category:** Other | **Website:** [prayertimes.date/](https://prayertimes.date/) | **Docs:** [parse.bot/marketplace/04f0ede8-5d16-430e-bff5-33757474b35f/prayertimes-date-api](https://parse.bot/marketplace/04f0ede8-5d16-430e-bff5-33757474b35f/prayertimes-date-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-date-api-04f0ede8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_monthly_prayer_times

Retrieve the prayer times schedule for the current month for a given city. Returns an array of daily entries each containing date and all prayer times. Useful for planning ahead or displaying a calendar view.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name used to look up the monthly schedule (e.g. 'London', 'Mecca'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-date-api-04f0ede8/get_monthly_prayer_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_prayer_times_by_city

Retrieve today's Islamic prayer times for a specific city. Returns the eight standard prayer/transition times (Imsak, Fajr, Sunrise, Dhuhr, Asr, Sunset, Maghrib, Isha), geographic coordinates, and the current date. Some high-latitude cities may show '-' for prayers that do not occur on a given day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name used to look up prayer times (e.g. 'London', 'Mecca', 'Istanbul'). Converted to a URL slug internally. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prayertimes-date-api-04f0ede8/get_prayer_times_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_prayer_times_by_country

Retrieve today's prayer times for major cities within a specific country. Returns a list of cities with their respective prayer times for the current day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country name (e.g. 'United Kingdom', 'United States', 'Saudi Arabia'). Converted to a URL slug internally. |

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

### list_popular_cities

Retrieve the list of popular cities featured on the prayertimes.date homepage. No parameters required. Returns cities with their name, URL slug, and full URL.

**Estimated cost:** Metered

_No parameters required._

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

### list_popular_countries

Retrieve the list of popular countries featured on the prayertimes.date homepage. No parameters required. Returns countries with their name, URL slug, and full URL.

**Estimated cost:** Metered

_No parameters required._

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