🕌 WaqfData API

Quick Start

# Get API schema (great for AI agents)
curl https://api.waqf.dev/_meta

# Search across all datasets
curl "https://api.waqf.dev/_search?q=الصلاة"

# Get paginated benefits
curl "https://api.waqf.dev/44fth?_limit=5&_offset=0"

# Get specific endpoint schema with samples
curl https://api.waqf.dev/44fth/_meta

# Filter by field value
curl "https://api.waqf.dev/44fth?category_ar=الذكر"

# Select specific fields only
curl "https://api.waqf.dev/44fth?_fields=id,title_short_ar"

# Sort results ascending by field
curl "https://api.waqf.dev/44fth?_sort=id"

# Sort results descending (prefix with -)
curl "https://api.waqf.dev/44fth?_sort=-id"

# Partial text matching with _like suffix
curl "https://api.waqf.dev/44fth?title_short_ar_like=الحج"

# Filter by multiple values (OR logic)
curl "https://api.waqf.dev/44fth?id=1,2,3"

# Health check endpoint
curl https://api.waqf.dev/_health

# OpenAPI specification
curl https://api.waqf.dev/_openapi

Query Parameters

Special Endpoints

{ "status": "healthy", "timestamp": "2024-01-01T00:00:00.000Z", "version": "1.0.0" }

Data Endpoints

Response Format

Standard responses return JSON. When pagination is used, the response includes metadata:

{
  "data": { ... },
  "pagination": {
    "total": 44,
    "limit": 5,
    "offset": 0,
    "hasMore": true
  }
}

When a query has invalid fields, you get helpful suggestions:

{
  "data": [],
  "validation_errors": ["Unknown field: categori_ar"],
  "suggestions": { "did_you_mean": "category_ar" }
}

Response Headers