{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["not-enabled","tabs","tab"]},"type":"markdown"},"seo":{"title":"Updated APIs","siteUrl":"https://opensource.ripple.com/","meta":[{"name":"google-site-verification","content":"bLwyBi1imklcIuQxZ7JeI_kRF5Mg7yfr6arpEQV2nsE"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"updated-apis","__idx":0},"children":["Updated APIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page describes updates to existing RPC methods introduced by XLS-68: Sponsored Fees and Reserves."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Requires the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xls.xrpl.org/xls/XLS-0068-sponsored-fees-and-reserves.html"},"children":["Sponsor amendment"]}," ",{"$$mdtype":"Tag","name":"NotEnabled","attributes":{},"children":[]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account_objects","__idx":1},"children":["account_objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/account-methods/account_objects"},"children":["account_objects method"]}," adds a new optional filter parameter to query sponsored objects."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sponsored"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", returns only sponsored objects (objects with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HighSponsor"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LowSponsor"]}," field). If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", returns only non-sponsored objects. If omitted, returns all objects (existing behavior)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-format","__idx":2},"children":["Request Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example of the request format:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"WebSocket","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": 1,\n  \"command\": \"account_objects\",\n  \"account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n  \"sponsored\": true,\n  \"ledger_index\": \"validated\",\n  \"type\": \"state\"\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"JSON-RPC","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"account_objects\",\n  \"params\": [\n    {\n      \"account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n      \"sponsored\": true,\n      \"ledger_index\": \"validated\",\n      \"type\": \"state\"\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Commandline","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"rippled account_objects rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf sponsored=true ledger_index=validated type=state\n","lang":"sh"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-format","__idx":3},"children":["Response Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example of a successful response:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"WebSocket","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": 1,\n  \"result\": {\n    \"account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n    \"account_objects\": [\n      {\n        \"Balance\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rrrrrrrrrrrrrrrrrrrrBZbvji\",\n          \"value\": \"100\"\n        },\n        \"Flags\": 65536,\n        \"HighLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n          \"value\": \"1000\"\n        },\n        \"HighNode\": \"0000000000000000\",\n        \"HighSponsor\": \"rSponsor1VktvzBz8JF2oJC6qaww6RZ7Lw\",\n        \"LedgerEntryType\": \"RippleState\",\n        \"LowLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rfkDkFai4jUfCvAJiZ5Vm7XvvWjYvDqeYo\",\n          \"value\": \"0\"\n        },\n        \"LowNode\": \"0000000000000000\",\n        \"PreviousTxnID\": \"1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF\",\n        \"PreviousTxnLgrSeq\": 12345678,\n        \"index\": \"ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890\"\n      }\n    ],\n    \"ledger_hash\": \"FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321\",\n    \"ledger_index\": 56789012,\n    \"validated\": true\n  },\n  \"status\": \"success\",\n  \"type\": \"response\"\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"JSON-RPC","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"result\": {\n    \"account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n    \"account_objects\": [\n      {\n        \"Balance\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rrrrrrrrrrrrrrrrrrrrBZbvji\",\n          \"value\": \"100\"\n        },\n        \"Flags\": 65536,\n        \"HighLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n          \"value\": \"1000\"\n        },\n        \"HighNode\": \"0000000000000000\",\n        \"HighSponsor\": \"rSponsor1VktvzBz8JF2oJC6qaww6RZ7Lw\",\n        \"LedgerEntryType\": \"RippleState\",\n        \"LowLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rfkDkFai4jUfCvAJiZ5Vm7XvvWjYvDqeYo\",\n          \"value\": \"0\"\n        },\n        \"LowNode\": \"0000000000000000\",\n        \"PreviousTxnID\": \"1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF\",\n        \"PreviousTxnLgrSeq\": 12345678,\n        \"index\": \"ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890\"\n      }\n    ],\n    \"ledger_hash\": \"FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321\",\n    \"ledger_index\": 56789012,\n    \"validated\": true,\n    \"status\": \"success\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Commandline","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"result\": {\n    \"account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n    \"account_objects\": [\n      {\n        \"Balance\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rrrrrrrrrrrrrrrrrrrrBZbvji\",\n          \"value\": \"100\"\n        },\n        \"Flags\": 65536,\n        \"HighLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n          \"value\": \"1000\"\n        },\n        \"HighNode\": \"0000000000000000\",\n        \"HighSponsor\": \"rSponsor1VktvzBz8JF2oJC6qaww6RZ7Lw\",\n        \"LedgerEntryType\": \"RippleState\",\n        \"LowLimit\": {\n          \"currency\": \"USD\",\n          \"issuer\": \"rfkDkFai4jUfCvAJiZ5Vm7XvvWjYvDqeYo\",\n          \"value\": \"0\"\n        },\n        \"LowNode\": \"0000000000000000\",\n        \"PreviousTxnID\": \"1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF\",\n        \"PreviousTxnLgrSeq\": 12345678,\n        \"index\": \"ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890\"\n      }\n    ],\n    \"ledger_hash\": \"FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321\",\n    \"ledger_index\": 56789012,\n    \"validated\": true,\n    \"status\": \"success\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]},"headings":[{"value":"Updated APIs","id":"updated-apis","depth":1},{"value":"account_objects","id":"account_objects","depth":2},{"value":"Request Format","id":"request-format","depth":3},{"value":"Response Format","id":"response-format","depth":3}],"frontmatter":{"seo":{"title":"Updated APIs"}},"editPage":{"to":"https://github.com/ripple/opensource.ripple.com/tree/main/docs/xls-68-sponsored-fees-and-reserves/references/apis/updated-apis.md"},"lastModified":"2026-04-10T16:11:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/xls-68-sponsored-fees-and-reserves/references/apis/updated-apis","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}