# Fazilettakvimi — 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 Islamic prayer times, fasting schedules, and religious holidays for any location by searching through countries, cities, and districts. View daily or monthly prayer schedules and access detailed calendar information for planning your religious observances.

**Category:** Other | **Website:** [fazilettakvimi.com/](https://fazilettakvimi.com/) | **Docs:** [parse.bot/marketplace/055a610f-c9da-4cf5-88c3-4a5b8529c940/fazilettakvimi-com-api](https://parse.bot/marketplace/055a610f-c9da-4cf5-88c3-4a5b8529c940/fazilettakvimi-com-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-fazilettakvimi-com-api-055a610f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_calendar_date_info

Get Hijri, Rumi, and other calendar data for a district. Returns the same data as get_daily_prayer_times, including Islamic and Rumi dates, chronological events, moon phases, and prayer times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `district_id` | integer | Yes | District ID from list_districts, or City ID from list_cities for city-level results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/get_calendar_date_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_id":"<integer>"}'
```

### get_daily_prayer_times

Get prayer times and Islamic calendar information for a district or city. Returns data for today and the next few days, including Hijri and Rumi dates, historical chronology entries, moon phase image URL, and all seven prayer times (imsak, sabah, gunes, ogle, ikindi, aksam, yatsi) as ISO 8601 UTC timestamps. Pass a district ID for precise locality or a city ID for city-level approximation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `district_id` | integer | Yes | District ID from list_districts, or city ID from list_cities for city-level results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/get_daily_prayer_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_id":"<integer>"}'
```

### get_monthly_prayer_times

Get the monthly prayer timetable (imsakiye) for a district or city. Returns the full Ramadan schedule with all seven prayer times for each day of the month in HH:MM local time format, plus the current Ramadan day number and Eid prayer time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `district_id` | integer | Yes | District ID from list_districts, or city ID from list_cities for city-level results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/get_monthly_prayer_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_id":"<integer>"}'
```

### get_religious_and_official_days

Retrieve official public holidays and Islamic religious observances for Turkey in a given year. Official holidays include national days and religious Bayram breaks; religious entries include Kandil nights, Ramadan start, Kadir Gecesi, Hicri new year, and Ashura. Defaults to the current year when year is omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | integer | No | Year to fetch holidays for. Defaults to the current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/get_religious_and_official_days \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<integer>"}'
```

### list_cities

List all cities for a given country. Each city carries its integer ID, Turkish name, and a flag indicating whether it has sub-districts. Use the city ID to drill into districts via list_districts, or pass it directly to prayer-time endpoints for city-level results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_id` | integer | Yes | Country ID obtained from list_countries. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/list_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_id":"<integer>"}'
```

### list_countries

List all supported countries for prayer times. Returns every country available in the Fazilet Takvimi system with its integer ID and Turkish name. Use the country ID to drill into cities via list_cities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/list_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_districts

List all districts for a given city. Each district has an integer ID and Turkish name. Use the district ID for prayer-time and calendar endpoints to get location-specific results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_id` | integer | Yes | City ID obtained from list_cities. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fazilettakvimi-com-api-055a610f/list_districts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_id":"<integer>"}'
```