{"openapi":"3.1.0","info":{"title":"Zakat API","version":"0.1.0","description":"Live nisab, zakat calculator, zakat al-fitr, inheritance (faraid), shariah stock screen, Islamic finance glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://zakat.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/zakat/docs"},"termsOfService":"https://connectorbay.com/zakat/terms"},"servers":[{"url":"https://zakat.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/zakat/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/nisab":{"post":{"operationId":"nisab","summary":"Today's nisab thresholds in a currency from live gold and silver prices: gold standard (85 g), silver standard","description":"Today's nisab thresholds in a currency from live gold and silver prices: gold standard (85 g), silver standard\n    (595 g), Hanafi weights, and the metal prices used. Use for \"what is the nisab today\", \"nisab in rupees\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"default":"USD","description":"ISO currency code.","examples":["USD","INR","GBP","PKR","AED","SAR"],"title":"Currency","type":"string"}},"title":"nisabArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/zakat_calculator":{"post":{"operationId":"zakat_calculator","summary":"Compute zakat: totals your zakatable assets, deducts debts due, checks the nisab on today's prices and","description":"Compute zakat: totals your zakatable assets, deducts debts due, checks the nisab on today's prices and\n    returns 2.5 % of the base with a breakdown and the fiqh notes that matter. Use for \"calculate my zakat\", \"do I\n    owe zakat with $8,000 savings and 30 g of gold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"default":"USD","description":"Currency of the amounts.","examples":["USD","INR"],"title":"Currency","type":"string"},"cash":{"default":0,"description":"Cash in hand and bank balances.","minimum":0,"title":"Cash","type":"number"},"gold_grams":{"default":0,"description":"Gold owned, in grams (zakatable per your school).","minimum":0,"title":"Gold Grams","type":"number"},"silver_grams":{"default":0,"minimum":0,"title":"Silver Grams","type":"number"},"gold_value":{"default":0,"description":"Or the money value of gold, if grams unknown.","minimum":0,"title":"Gold Value","type":"number"},"silver_value":{"default":0,"minimum":0,"title":"Silver Value","type":"number"},"investments":{"default":0,"description":"Shares, funds, bonds' zakatable value.","minimum":0,"title":"Investments","type":"number"},"retirement":{"default":0,"description":"Accessible retirement/pension balances (some scholars: only the withdrawable portion).","minimum":0,"title":"Retirement","type":"number"},"business_inventory":{"default":0,"description":"Trade stock and business cash at market value.","minimum":0,"title":"Business Inventory","type":"number"},"receivables":{"default":0,"description":"Money owed to you that you expect to receive.","minimum":0,"title":"Receivables","type":"number"},"crypto":{"default":0,"minimum":0,"title":"Crypto","type":"number"},"other":{"default":0,"minimum":0,"title":"Other","type":"number"},"debts_due":{"default":0,"description":"Debts falling due within the year (deductible).","minimum":0,"title":"Debts Due","type":"number"},"nisab_standard":{"default":"silver","description":"silver (lower threshold, default) | gold","title":"Nisab Standard","type":"string"}},"title":"zakat_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/zakat_al_fitr":{"post":{"operationId":"zakat_al_fitr","summary":"Zakat al-fitr for a household: the staple-food quantity per person (one sa', about 2–2.5 kg by staple) and,","description":"Zakat al-fitr for a household: the staple-food quantity per person (one sa', about 2–2.5 kg by staple) and,\n    with a local price, the money equivalent; when it must be paid. Use for \"fitrana for a family of five\",\n    \"how much is zakat al-fitr this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"people":{"default":1,"description":"Number of people in the household (including dependants).","maximum":100,"minimum":1,"title":"People","type":"integer"},"staple":{"default":"rice","description":"wheat | flour | rice | dates | raisins | barley | other","title":"Staple","type":"string"},"price_per_kg":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Local price of the staple per kg, to get a money amount.","title":"Price Per Kg"},"currency":{"default":"USD","title":"Currency","type":"string"}},"title":"zakat_al_fitrArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/inheritance":{"post":{"operationId":"inheritance","summary":"Divide an estate under Islamic inheritance law (faraid) for the common heirs: spouse, parents (or grandparents),","description":"Divide an estate under Islamic inheritance law (faraid) for the common heirs: spouse, parents (or grandparents),\n    sons and daughters (or a son's children), full siblings — after debts, funeral costs and a bequest capped at a\n    third — with 'awl and radd applied and each heir's fraction and amount. Use for \"how is the estate split between\n    a wife, two sons and a daughter\", \"my mother died leaving husband, father, mother\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"estate":{"description":"Gross estate value.","examples":[100000],"exclusiveMinimum":0,"title":"Estate","type":"number"},"husband":{"default":false,"description":"Deceased left a husband.","title":"Husband","type":"boolean"},"wives":{"default":0,"description":"Number of surviving wives (0–4).","maximum":4,"minimum":0,"title":"Wives","type":"integer"},"sons":{"default":0,"maximum":30,"minimum":0,"title":"Sons","type":"integer"},"daughters":{"default":0,"maximum":30,"minimum":0,"title":"Daughters","type":"integer"},"father":{"default":false,"title":"Father","type":"boolean"},"mother":{"default":false,"title":"Mother","type":"boolean"},"grandfather":{"default":false,"description":"Paternal grandfather alive (only counts when the father is not).","title":"Grandfather","type":"boolean"},"grandmother":{"default":false,"description":"A grandmother alive (only counts when the mother is not).","title":"Grandmother","type":"boolean"},"full_brothers":{"default":0,"maximum":30,"minimum":0,"title":"Full Brothers","type":"integer"},"full_sisters":{"default":0,"maximum":30,"minimum":0,"title":"Full Sisters","type":"integer"},"sons_sons":{"default":0,"description":"Sons of a predeceased son.","maximum":30,"minimum":0,"title":"Sons Sons","type":"integer"},"sons_daughters":{"default":0,"maximum":30,"minimum":0,"title":"Sons Daughters","type":"integer"},"debts":{"default":0,"description":"Debts of the deceased (including deferred mahr).","minimum":0,"title":"Debts","type":"number"},"funeral":{"default":0,"minimum":0,"title":"Funeral","type":"number"},"bequest":{"default":0,"description":"Bequest (wasiyyah) to non-heirs; capped at one third.","minimum":0,"title":"Bequest","type":"number"}},"required":["estate"],"title":"inheritanceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/shariah_screen":{"post":{"operationId":"shariah_screen","summary":"Shariah-compliance screen for a U.S.-listed company from its SEC filings: business activity by SIC code","description":"Shariah-compliance screen for a U.S.-listed company from its SEC filings: business activity by SIC code\n    (alcohol, tobacco, gambling, conventional finance, pork, adult content flagged), and AAOIFI-style ratios —\n    interest-bearing debt and cash-plus-interest-securities under 33 % of assets, interest income under 5 % of\n    revenue — with a pass / needs review / fails verdict and purification reminder. Use for \"is Apple halal\",\n    \"screen Tesla for shariah compliance\". Indicative only.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"company":{"description":"Ticker or company name (U.S.-listed, SEC filer).","examples":["AAPL","Microsoft","JPM"],"title":"Company","type":"string"}},"required":["company"],"title":"shariah_screenArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/glossary":{"post":{"operationId":"glossary","summary":"Islamic finance terms explained — riba, gharar, maysir, murabaha, ijara, mudarabah, musharakah, sukuk, takaful,","description":"Islamic finance terms explained — riba, gharar, maysir, murabaha, ijara, mudarabah, musharakah, sukuk, takaful,\n    qard hasan, waqf, faraid, 'awl, radd, wasiyyah, mahr, salam, istisna, tawarruq, ushr, kaffarah, fidyah and\n    more — with Arabic and related terms. Use for \"what is tawarruq\", \"difference between mudarabah and musharakah\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A term to look up (default: the whole list).","examples":["riba","murabaha","sukuk"],"title":"Term"}},"title":"glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}