Worship · 1 endpoint
Zakat Calculator
Zakat on wealth, with the nisab priced against today's gold rather than a figure copied into a config file last year.
- Status
- Operational
- Price
- 1 credit / request
- Rate limit
- 300 / 60s
- Cache
- 5m
- Requests
- 0
Endpoint
How to call it
Code
Request — cURL
v1
curl https://api.diraz.co.id/v1/zakat \
-H "Authorization: Bearer drz_live_…"For AI agents
Callable through the MCP server with the same key:
call_api {"endpoint":"zakat","params":{"cash":"50000000","gold_grams":"50","trade_goods":"0"}}Parameters
- cashnumber · optional
- Cash, current accounts, savings.Default: 0
- gold_gramsnumber · optional
- Gold held, in grams. Valued at today's price.Default: 0
- trade_goodsnumber · optional
- Trade goods and inventory, in rupiah.Default: 0
- receivablesnumber · optional
- Money owed to you.Default: 0
- liabilitiesnumber · optional
- Debts due now.Default: 0
- nisabstring · optional
- `gold` (85g) or `silver` (595g).Default: gold
Example response
200 OK
JSON
{
"data": {
"currency": "IDR",
"nisab": {
"basis": "gold",
"grams": 85,
"gold_price_per_gram_idr": 2721000,
"threshold_idr": 231285000
},
"assets": {
"cash": 300000000,
"gold_value": 0,
"trade_goods": 0,
"receivables": 0,
"total": 300000000
},
"liabilities": 0,
"net_wealth": 300000000,
"due": true,
"zakat_idr": 7500000,
"shortfall_idr": 0,
"assumptions": ["This is a calculation, not a fatwa. Where scholars differ, consult one."]
},
"meta": {
"request_id": "req_7Q2fK4mZ",
"as_of": "2026-08-18T16:32:00.000Z",
"age_seconds": 42,
"next_update_at": "2026-08-18T17:10:15.000Z"
}
}- nisab.threshold_idr
- 85g of gold at today's price. Moves daily, which is the point.
- due
- Whether net wealth reaches the threshold.
- zakat_idr
- 2.5% of net wealth, or zero below the threshold.
- shortfall_idr
- How far below the threshold, so a caller can show progress.
- assumptions
- What the calculation took as given. Zakat has real differences of opinion, so this states its position rather than presenting one school's answer as the answer.
Errors
When something goes wrong
Every failure carries a stable machine-readable code and the same meta.request_id a success carries — quote it and we can find your request. Errors are never billed.
401 Unauthorized
JSON
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is invalid, expired, or revoked."
},
"meta": {
"request_id": "req_7Q2fK4mZ"
}
}- UNAUTHORIZEDHTTP 401
- Missing, malformed, expired, or revoked API key.
- FORBIDDENHTTP 403
- The key is valid but lacks the scope this product needs.
- VALIDATION_ERRORHTTP 422
- A query parameter is the wrong type or out of range.
- RATE_LIMITEDHTTP 429
- Rate limit exhausted. `Retry-After` says how long to wait.
- SERVICE_UNAVAILABLEHTTP 503
- No data recent enough to serve. Carries `Retry-After`, and is never billed.
Data freshness
Every response is timestamped
as_of is when the data was published, age_seconds how old it is now, and next_update_at when newer data is expected.
Up to date
200
Inside its published window. Almost every request.
Delayed
delayed: true
Newer data is late; you get the latest there is, flagged.
Unavailable
503
Nothing recent enough. Carries Retry-After, never billed.
Health
Is it up?
- Zakat Calculator
1/1 passing