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

> Search for mosques near you and instantly access prayer times, detailed mosque information, calendars, and local weather conditions. Plan your visits with accurate scheduling data all from one convenient service.

**Category:** Maps & Geospatial | **Website:** [mawaqit.net/](https://mawaqit.net/) | **Docs:** [parse.bot/marketplace/b07141bf-b259-4db5-aad7-209288c631fd/mawaqit-net-api](https://parse.bot/marketplace/b07141bf-b259-4db5-aad7-209288c631fd/mawaqit-net-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/mawaqit/`
**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 mosque calendar

Retrieve the prayer calendar for a mosque. Returns daily prayer times (fajr, shuruq, dhuhr, asr, maghrib, isha) for each day of each month. Can be filtered to a specific month (1-12); if omitted, returns all 12 months.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | integer | No | Month number (1-12). If omitted, returns the full year calendar. |
| `slug` | string | Yes | The unique slug of the mosque, obtainable from search_mosques results (e.g. 'grande-mosquee-de-paris'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mawaqit/get-mosque-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"month":"<integer>","slug":"<string>"}'
```

### Get mosque info

Get detailed information about a mosque including address, coordinates, timezone, association, website, announcements, and available features (women space, janaza prayer, courses, accessibility, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique slug of the mosque, obtainable from search_mosques results (e.g. 'grande-mosquee-de-paris'). |

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

### Get mosque prayer times

Retrieve today's full prayer times for a specific mosque. Returns fajr, shuruq, dhuhr, asr, maghrib, isha, and jumu'ah times. The slug is obtained from search_mosques results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique slug of the mosque, obtainable from search_mosques results (e.g. 'grande-mosquee-de-paris'). |

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

### Get mosque weather

Get current weather conditions for a mosque location. Returns temperature, unit, subjective feeling description, and weather icon identifier. The uuid is obtained from search_mosques results or get_mosque_info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `uuid` | string | Yes | The unique UUID of the mosque, obtainable from search_mosques results or get_mosque_info (e.g. '05b4d393-fb76-4d9b-b2a4-f98ab4c4b64f'). |

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

### Search mosques

Full-text and geographic search over mosques. Either a text query or both lat/lon coordinates must be provided. Returns mosque objects with basic info including today's partial prayer times, location coordinates, contact details, and feature flags. Each result carries a slug (for detail/calendar lookups) and a uuid (for weather lookups).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | number | No | Latitude for geographic search. Must be provided together with lon if query is not given. |
| `lon` | number | No | Longitude for geographic search. Must be provided together with lat if query is not given. |
| `query` | string | No | Search keyword such as mosque name or city. Either query or both lat and lon must be provided. |
| `radius` | integer | No | Search radius in meters for geographic search. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mawaqit/search-mosques \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","lon":"<number>","query":"<string>","radius":"<integer>"}'
```

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