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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/get_mosque_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/get_mosque_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/get_mosque_prayer_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/get_mosque_weather \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-mawaqit-net-api-b07141bf/search_mosques \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","lon":"<number>","query":"<string>","radius":"<integer>"}'
```