# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/fazilettakvimi/`
**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 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/credits/fazilettakvimi/get-calendar-date-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/get-daily-prayer-times \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/get-monthly-prayer-times \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/get-religious-and-official-days \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/list-cities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/list-countries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fazilettakvimi/list-districts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city_id":"<integer>"}'
```

## Next steps

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