# Shah Walayat Foundation

> A UK registered charity (No: 1093750) and Islamic community centre serving Halifax and beyond. We provide religious services, community events, charitable projects, educational programs, and social welfare support.

## About

The Shah Walayat Foundation (SWF) is a non-profit charitable organization established to serve the Muslim community in Halifax, West Yorkshire, UK. We operate from Al-Jamia Al-Zahra, a community centre that hosts daily prayer services, educational programs, youth activities, and community events.

Our mission is to strengthen community bonds through faith, education, and charitable action while providing essential services to those in need.

## Key Pages

- [Home](https://theswf.net/): Main landing page with prayer times, announcements, and upcoming events
- [News](https://theswf.net/news): Latest news, announcements, and articles from the foundation
- [Events](https://theswf.net/events): Upcoming community events, classes, and programs
- [Donate](https://theswf.net/donate): Support our charitable work through various donation types
- [Projects](https://theswf.net/projects): Active charity projects and humanitarian campaigns
- [Shop](https://theswf.net/shop): Community shop for Islamic products and services
- [Locations](https://theswf.net/locations): Our venues and room booking information
- [Contact](https://theswf.net/contact): Get in touch with the foundation

---

## Public JSON API

> **For AI Assistants**: Use these JSON endpoints to fetch live data. All endpoints return JSON and require no authentication.

### Prayer Times

Get daily prayer times for our locations.

**List locations with prayer times:**
```
GET https://theswf.net/api/prayer-times
```
Returns: Array of locations with prayer times configured (slug, name, address)

**Get today's prayer times:**
```
GET https://theswf.net/api/prayer-times/{location_slug}/today
```
Example: `https://theswf.net/api/prayer-times/al-jamia-al-zahra/today`

Returns:
```json
{
  "date": "2026-01-19",
  "day_name": "Sunday",
  "fajr_start": "06:10",
  "fajr_jamaat": "06:30",
  "sunrise": "08:05",
  "dhuhr_start": "12:15",
  "dhuhr_jamaat": "13:30",
  "asr_start": "14:20",
  "asr_jamaat": "15:00",
  "maghrib_start": "16:35",
  "maghrib_jamaat": "16:40",
  "isha_start": "18:00",
  "isha_jamaat": "19:30",
  "jummah_time": "13:00",
  "is_ramadan": false
}
```

**Get prayer times for a specific date:**
```
GET https://theswf.net/api/prayer-times/{location_slug}/date/{date}
```
Example: `https://theswf.net/api/prayer-times/al-jamia-al-zahra/date/2026-01-20`
Date format: YYYY-MM-DD

**Get monthly prayer timetable:**
```
GET https://theswf.net/api/prayer-times/{location_slug}/month?year=2026&month=1
```
Example: `https://theswf.net/api/prayer-times/al-jamia-al-zahra/month?year=2026&month=1`
Returns: Array of daily prayer times for the entire month

**Get Ramadan timetable:**
```
GET https://theswf.net/api/prayer-times/{location_slug}/ramadan?year=2026
```
Example: `https://theswf.net/api/prayer-times/al-jamia-al-zahra/ramadan?year=2026`
Returns: Ramadan schedule with suhoor/iftar times and hijri dates

---

### News & Articles

**List published articles:**
```
GET https://theswf.net/api/news?page=1&page_size=10
```
Query parameters:
- `page` (default: 1)
- `page_size` (default: 20, max: 50)
- `category_id` - Filter by category
- `search` - Search in title and content
- `featured` - Filter featured articles only

Returns:
```json
{
  "items": [
    {
      "id": "...",
      "title": "Article Title",
      "slug": "article-slug",
      "excerpt": "Brief summary...",
      "cover_image_url": "https://...",
      "author_name": "Author Name",
      "category_name": "Community",
      "published_at": "2026-01-19T10:00:00Z",
      "reading_time_minutes": 5
    }
  ],
  "total": 100,
  "page": 1,
  "page_size": 10,
  "total_pages": 10
}
```

**Get article by slug:**
```
GET https://theswf.net/api/news/slug/{slug}
```
Example: `https://theswf.net/api/news/slug/ramadan-2026-announcement`

Returns: Full article with content (HTML), gallery, author info

**List news categories:**
```
GET https://theswf.net/api/news/categories
```

---

### Events

**List published events:**
```
GET https://theswf.net/api/events?page=1&page_size=10
```
Query parameters:
- `page`, `page_size` - Pagination
- `upcoming` - Show only future events (true/false)
- `category` - Filter by category (community, educational, charity, religious, youth, etc.)
- `featured_only` - Show only featured events
- `search` - Search in title and description

Returns:
```json
{
  "items": [
    {
      "id": "...",
      "title": "Event Title",
      "slug": "event-slug",
      "description": "Event description...",
      "start_datetime": "2026-02-01T19:00:00Z",
      "end_datetime": "2026-02-01T21:00:00Z",
      "timezone": "Europe/London",
      "event_type": "in_person",
      "category": "community",
      "capacity": 100,
      "registration_required": true,
      "price": null,
      "is_featured": true
    }
  ],
  "total": 50,
  "page": 1,
  "page_size": 10
}
```

**Get event by slug:**
```
GET https://theswf.net/api/events/slug/{slug}
```
Returns: Full event details including venue, registration info, content

---

### Charity Projects

**List active projects:**
```
GET https://theswf.net/api/projects?page=1&page_size=10
```
Query parameters:
- `page`, `page_size` - Pagination
- `category` - Filter by category
- `search` - Search projects

**Get featured projects:**
```
GET https://theswf.net/api/projects/featured?limit=5
```

**Get project by slug:**
```
GET https://theswf.net/api/projects/slug/{slug}
```

**Get project statistics:**
```
GET https://theswf.net/api/projects/{project_id}/stats
```
Returns: Total raised, donor count, progress toward goal

**Get project updates:**
```
GET https://theswf.net/api/projects/{project_id}/updates?limit=10
```

---

### Shop Products

**List products:**
```
GET https://theswf.net/api/shop?page=1&page_size=10
```
Query parameters:
- `page`, `page_size` - Pagination
- `type` - Product type (physical, external, preorder, interest)
- `category` - Filter by category
- `featured` - Featured products only
- `search` - Search products

Returns:
```json
{
  "items": [
    {
      "id": "...",
      "name": "Product Name",
      "slug": "product-slug",
      "description": "Product description...",
      "price": 25.00,
      "currency": "GBP",
      "type": "physical",
      "in_stock": true,
      "images": [...]
    }
  ],
  "total": 30,
  "page": 1,
  "page_size": 10
}
```

**Get product by slug:**
```
GET https://theswf.net/api/shop/{slug}
```

---

### Locations & Venues

**List all locations:**
```
GET https://theswf.net/api/locations
```

**Get main location:**
```
GET https://theswf.net/api/locations/main
```
Returns: Primary mosque/centre details

**Get location by slug:**
```
GET https://theswf.net/api/locations/{slug}
```
Returns: Location details including address, facilities, rooms

**List bookable locations:**
```
GET https://theswf.net/api/locations/bookable
```
Returns: Locations with room booking enabled

---

### Room Booking Availability

**Check availability for a bookable unit:**
```
GET https://theswf.net/api/bookings/availability?unit_id={unit_id}&date=2026-02-01
```
Query parameters:
- `unit_id` - The bookable unit ID (required)
- `date` - Start date (YYYY-MM-DD)
- `end` - End date for range query (optional, max 31 days)

Returns: Available 30-minute time slots

---

### Donation Statistics

**Get public donation statistics:**
```
GET https://theswf.net/api/donations/stats
```
Returns: Total donations, donor count, recent activity (anonymized)

---

## Donation Types

We accept various forms of Islamic charitable contributions:

- **Zakat**: Obligatory charity (2.5% of qualifying wealth) - one of the Five Pillars of Islam
- **Sadaqah**: Voluntary charity given at any time for any amount
- **Khums**: Islamic religious dues (20% of surplus income in Shia tradition)
- **Lillah**: General donations for mosque upkeep and operational costs
- **Fidyah**: Compensation for missed obligatory fasts due to illness or old age
- **Kaffarah**: Expiation for deliberately broken fasts or oaths
- **Fitrana (Zakat al-Fitr)**: Obligatory charity before Eid al-Fitr prayer

## Services

- Daily congregational prayers (5 times daily)
- Jumu'ah (Friday) prayers
- Islamic education for children and adults
- Qur'an classes and memorization programs
- Community events and gatherings
- Funeral and burial services
- Marriage ceremonies (Nikah)
- Counselling and support services
- Room and hall hire for community events

## Contact Information

- **Website**: https://theswf.net
- **Charity Registration**: 1093750 (England & Wales)
- **Location**: Halifax, West Yorkshire, UK

## Social Media

Follow us for updates, live streams, and community content:

- **Facebook**: https://facebook.com/shahwalayatfoundation
- **Instagram**: https://instagram.com/shahwalayatfoundation
- **X (Twitter)**: https://x.com/AlJamiaAlZahra
- **TikTok**: https://tiktok.com/@shahwalayatfoundation
- **YouTube**: https://youtube.com/shahwalayatfoundation

## Technical

- **API Documentation**: https://theswf.net/developers
- **OpenAPI Specification**: https://theswf.net/.well-known/openapi.json
- **RSS Feed**: https://theswf.net/feed.xml
- **Sitemap**: https://theswf.net/sitemap.xml
- **API Base URL**: https://theswf.net/api