Skip to content
All APIs

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

GET/v1/zakat

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