EsakoAPI — API Documentation

1. Introduction

EsakoAPI is a free API that does not require an API key. It is designed to calculate various types of Zakat in accordance with Islamic Shariah.

2. Base URL

https://esakoapi.org/api/

3. Endpoints

01 - Money:

To calculate Zakat on money, use the following format:

https://esakoapi.org/api/money/9899

Response Example

{
  "code": 200,
  "response": 247.475,
  "conditions": [
    "The amount must be in US dollars (USD).",
    "You must have possessed it for one full year.",
    "Zakat calculated using current silver price of 1.6685."
  ],
  "unit": "$",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

02 - Gold:

To calculate Zakat on gold, use the following pattern:

There are many types of gold purity, the most common are:

- Type 1: 24K Gold (Pure gold 100%). Use ?Type=24

- Type 2: 22K Gold. Use ?Type=22

- Type 3: 21K Gold. Use ?Type=21

- Type 4: 20K Gold. Use ?Type=20

- Type 5: 18K Gold. Use ?Type=18

- Type 6: 16K Gold. Use ?Type=16

Default Type is Type=24

https://esakoapi.org/api/gold/150?Type=22

Response Example

{
  "code": 200,
  "response": 3.625,
  "conditions": [
    "It must be 100% pure gold.",
    "You must have possessed it for one full year.",
    "If paying in cash, the amount is 482.5836$."
  ],
  "unit": "Gram",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

03 - Silver (Fido):

To calculate Zakat on silver (white gold), use:

https://esakoapi.org/api/silver/920

Response Example

{
  "code": 200,
  "response": 23,
  "conditions": [
    "It must be 100% pure silver.",
    "You must have possessed it for one full year.",
    "If paying in cash, the amount is 38.3761$."
  ],
  "unit": "Gram",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

04 - Camels:

To calculate Zakat on camels, use:

https://esakoapi.org/api/camels/920

Response Example

{
  "code": 200,
  "response": 19,
  "conditions": [
    "16 camels must be 3 years old.",
    "3 camels must be 2 years old.",
    "They must all be female."
  ],
  "unit": "Head",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

05 - Sheep/Goats:

https://esakoapi.org/api/sheep/920

Response Example

{
  "code": 200,
  "response": 9,
  "conditions": [
    "If sheep, they must be 1 year old.",
    "If goats, they must be 2 years old."
  ],
  "unit": "Head",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

06 - Cows:

https://esakoapi.org/api/cows/56

Response Example

{
  "code": 200,
  "response": 1,
  "conditions": [
    "Must have entered its third year (matured).",
    "Preferably female, but male is acceptable.",
    "Must be of cattle species."
  ],
  "unit": "Head",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

07 - Crops:

To calculate Zakat on crops, use:

There are three crop types based on

- Type 1: Naturally rain-fed crops, without human irrigation costs. Use ?Type=1

- Type 2: Crops irrigated with paid water (e.g., purchased or artificial irrigation). Use ?Type=2

- Type 3: Crops irrigated with both rain and paid water combined. Use ?Type=3

Default Type is Type=1

https://esakoapi.org/api/crops/920?Type=2

Response Example

{
  "code": 200,
  "response": 46,
  "conditions": [
    "Crops irrigated using paid water.",
    "Must be harvestable and storable, such as wheat, rice, or maize."
  ],
  "unit": "Kg",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

08 - Buried Treasure (Rikaas):

https://esakoapi.org/api/rikaas/122

Response Example

{
  "code": 200,
  "response": 24.4,
  "conditions": [
    "It must be classified as Rikaas (buried treasure).",
    "It should be something ancient with visible historical traces.",
    "If paying in cash, the amount is 3248.2867$."
  ],
  "unit": "Gram",
  "date": "Tuesday 14-October-2025",
  "time": "09:22 AM"
}

4. Error Codes

Code	Description
200	OK — Request was successful
467	Invalid URL — when the requested URL is incorrect
464	Value Error — when a string is used instead of a number
404	Not Found — Endpoint or resource not found
500	Server Error — Internal error occurred