Make Your First Request

Let's test your connection by fetching a random Hadith.

The Endpoint

We'll use the /hadiths/random endpoint, which returns a single random hadith each time.

GET https://api.hadith.mumin.ink/v1/hadiths/random

Code Examples

Choose your preferred language to make the request:

curl -X GET "https://api.hadith.mumin.ink/v1/hadiths/random" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limiting

If you send too many requests quickly, you might receive a 429 Too Many Requests error. Check the Rate Limits guide for more info.