{"openapi":"3.1.0","info":{"title":"Razorpay Reconciliation (BYOK) API","version":"0.1.0","description":"Razorpay Reconciliation (BYOK) lets an AI assistant read your own Razorpay Reconciliation data through the Razorpay Reconciliation API with a key you supply (Key ID (starts with rzp_live_ or rzp_test_)). Read-only: 10 tools (get_settlement, get_settlement_recon, list_disputes, get_dispute, list_payment_downtimes, get_payment_downtime, list_items, get_item, list_subscriptions, get_subscription)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-razorpay-recon-disputes.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-razorpay-recon-disputes/docs"},"termsOfService":"https://connectorbay.com/byok-razorpay-recon-disputes/terms"},"servers":[{"url":"https://byok-razorpay-recon-disputes.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-razorpay-recon-disputes/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_settlement":{"post":{"operationId":"get_settlement","summary":"Get one Razorpay settlement by id with amount (smallest currency unit), status, fees, tax, bank reference (UTR) and crea","description":"Get one Razorpay settlement by id with amount (smallest currency unit), status, fees, tax, bank reference (UTR) and creation time. Use for \"How much was settlement setl_DGlQ1Rj8os78Ec and what is its UTR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"settlement_id":{"description":"Settlement id, for example setl_DGlQ1Rj8os78Ec.","maxLength":200,"title":"Settlement Id","type":"string"}},"required":["settlement_id"],"title":"get_settlementArguments","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/get_settlement_recon":{"post":{"operationId":"get_settlement_recon","summary":"List every payment, refund, transfer and adjustment settled to your account in a month or on one day, with credit, debit","description":"List every payment, refund, transfer and adjustment settled to your account in a month or on one day, with credit, debit, fee, tax, method, card network and settlement id. Amounts are in the smallest currency unit. Use for \"Which transactions were settled to me on 11 June 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"description":"Year the settlement was received, four digits, for example 2026.","maximum":2100,"minimum":2015,"title":"Year","type":"integer"},"month":{"description":"Month the settlement was received, 1 to 12.","maximum":12,"minimum":1,"title":"Month","type":"integer"},"day":{"anyOf":[{"maximum":31,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Optional day of the month, 1 to 31, to narrow the report to one day.","title":"Day"},"count":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000).","title":"Count"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging together with count.","title":"Skip"}},"required":["year","month"],"title":"get_settlement_reconArguments","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/list_disputes":{"post":{"operationId":"list_disputes","summary":"List customer disputes (chargebacks and similar) with payment id, amount, reason code, phase, status and the deadline to","description":"List customer disputes (chargebacks and similar) with payment id, amount, reason code, phase, status and the deadline to respond. Evidence documents are not returned. Use for \"Do I have any open Razorpay disputes and when must I respond\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Count"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging together with count.","title":"Skip"},"date_from":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or after this Unix timestamp (seconds).","title":"Date From"},"date_to":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or before this Unix timestamp (seconds).","title":"Date To"}},"title":"list_disputesArguments","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/get_dispute":{"post":{"operationId":"get_dispute","summary":"Get one Razorpay dispute by id with payment id, amount, reason code, phase, status, amount deducted and response deadlin","description":"Get one Razorpay dispute by id with payment id, amount, reason code, phase, status, amount deducted and response deadline. Evidence documents are not returned. Use for \"What is the status of dispute disp_Esz7KAitoYM7PJ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dispute_id":{"description":"Dispute id, for example disp_Esz7KAitoYM7PJ.","maxLength":200,"title":"Dispute Id","type":"string"}},"required":["dispute_id"],"title":"get_disputeArguments","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/list_payment_downtimes":{"post":{"operationId":"list_payment_downtimes","summary":"List ongoing and scheduled payment downtimes (banks, UPI handles, card networks or issuers having trouble) with method, ","description":"List ongoing and scheduled payment downtimes (banks, UPI handles, card networks or issuers having trouble) with method, start, end, severity and affected instrument. Use for \"Are any banks or UPI apps having downtime on Razorpay right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_payment_downtimesArguments","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/get_payment_downtime":{"post":{"operationId":"get_payment_downtime","summary":"Get one payment downtime by id with method, start, end, status, severity and affected instrument. Use for \"What is the d","description":"Get one payment downtime by id with method, start, end, status, severity and affected instrument. Use for \"What is the downtime down_F1cxDoHWD4fkQt about\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"downtime_id":{"description":"Downtime id, for example down_F1cxDoHWD4fkQt.","maxLength":200,"title":"Downtime Id","type":"string"}},"required":["downtime_id"],"title":"get_payment_downtimeArguments","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/list_items":{"post":{"operationId":"list_items","summary":"List invoice items (name, description, unit amount, currency, tax and HSN or SAC codes) created in your account. Use for","description":"List invoice items (name, description, unit amount, currency, tax and HSN or SAC codes) created in your account. Use for \"Which invoice items have I defined on Razorpay\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"active":{"anyOf":[{"maximum":1,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"1 for active items only, 0 for inactive items only; leave empty for both.","title":"Active"},"count":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Count"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging together with count.","title":"Skip"},"date_from":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or after this Unix timestamp (seconds).","title":"Date From"},"date_to":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or before this Unix timestamp (seconds).","title":"Date To"}},"title":"list_itemsArguments","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/get_item":{"post":{"operationId":"get_item","summary":"Get one invoice item by id with name, description, amount, currency, tax inclusion and HSN or SAC code. Use for \"What do","description":"Get one invoice item by id with name, description, amount, currency, tax inclusion and HSN or SAC code. Use for \"What does invoice item item_JInaSLODeDUQiQ cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item_id":{"description":"Item id, for example item_JInaSLODeDUQiQ.","maxLength":200,"title":"Item Id","type":"string"}},"required":["item_id"],"title":"get_itemArguments","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/list_subscriptions":{"post":{"operationId":"list_subscriptions","summary":"List subscriptions with plan id, status, billing cycle times, quantity and paid and remaining cycle counts. Customer con","description":"List subscriptions with plan id, status, billing cycle times, quantity and paid and remaining cycle counts. Customer contact details are not returned. Use for \"Which Razorpay subscriptions are active on plan plan_00000000000001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"plan_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only subscriptions of this plan id.","title":"Plan Id"},"count":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Count"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging together with count.","title":"Skip"},"date_from":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or after this Unix timestamp (seconds).","title":"Date From"},"date_to":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only records created at or before this Unix timestamp (seconds).","title":"Date To"}},"title":"list_subscriptionsArguments","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/get_subscription":{"post":{"operationId":"get_subscription","summary":"Get one subscription by id with plan id, status, current cycle, quantity and paid and remaining cycle counts. Use for \"W","description":"Get one subscription by id with plan id, status, current cycle, quantity and paid and remaining cycle counts. Use for \"What is the status of subscription sub_00000000000001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subscription_id":{"description":"Subscription id, for example sub_00000000000001.","maxLength":200,"title":"Subscription Id","type":"string"}},"required":["subscription_id"],"title":"get_subscriptionArguments","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}}}}