# Prayertimes (prayertimes.com) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/prayertimes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/prayertimes/get-cities-alphabetical \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/prayertimes/get-city-prayer-times \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/prayertimes/get-country-cities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/prayertimes/list-countries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.