# Salah — 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.

> Retrieve accurate Islamic prayer times for any location by entering coordinates or a location name, or browse default times from the site homepage. Access daily prayer schedules including Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, and Qiyam for locations worldwide.

**Category:** Other | **Website:** [salah.com/](https://salah.com/) | **Docs:** [parse.bot/marketplace/09826426-d1a6-4a6e-a228-0256571d0496/salah-com-api](https://parse.bot/marketplace/09826426-d1a6-4a6e-a228-0256571d0496/salah-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/salah/`
**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 all prayer times for location

Accepts a city name or address, geocodes it via Nominatim, and returns the prayer times for that location from salah.com. The geocoding step translates the text query to coordinates, then fetches prayer times using those coordinates. If the location cannot be geocoded, returns input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City name or address to search for (e.g. 'London, UK', 'Tokyo, Japan', 'Dubai, UAE') |
| `method_id` | integer | No | Calculation method ID for prayer time computation. When omitted, the site uses its default method for the region. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/salah/get-all-prayer-times-for-location \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","method_id":"<integer>"}'
```

### Get mosques

Returns mosque information for a given location. Note: mosque directory data may not be available for all regions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/salah/get-mosques \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get prayer times by coordinates

Fetches today's prayer times for a given location using latitude and longitude coordinates. Returns prayer names (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, Qiyam) with their times formatted as 'HH:MM AM/PM'. Uses the salah.com /get endpoint with coordinate parameters. If coordinates resolve to no known location, returns input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | number | Yes | Latitude of the location (e.g. 40.7128) |
| `longitude` | number | Yes | Longitude of the location (e.g. -74.0060) |
| `method_id` | integer | No | Calculation method ID for prayer time computation. When omitted, the site uses its default method for the region. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/salah/get-prayer-times-by-coordinates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<number>","longitude":"<number>","method_id":"<integer>"}'
```

### Get prayer times homepage

Retrieves the default prayer times and calculation method for the auto-detected location from the salah.com homepage. No input parameters required — location is determined by the server based on the requesting IP. Returns the detected location name, the calculation method used, and all prayer times.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/salah/get-prayer-times-homepage \
  -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.