# Sync

## Sync the account to update transactions with list status

> This will synchronize the account's transactions status with the one on the blockchain

```json
{"openapi":"3.0.2","info":{"title":"Vault API","version":"1.35.0"},"tags":[{"description":"When fetching or creating transactions, the `amount`, `fees` and `max_fees` values are always expressed\nin the lowest available unit, also known as the **base unit**: satoshi for Bitcoin, wei for Ethereum,\nmutez for Tezos, etc.\nYou can inspect the units available via a call to `GET /accounts/<id>/currency`.\n\n> ℹ️ Token transfer transactions on Ethereum, Polygon, or other EVM networks: the `amount`\nvalue is expressed in the ERC-20 base unit, but the `fees` and `max_fees` values are expressed\nin the network currency used to pay for the transaction fee (ETH for Ethereum, MATIC for Polygon, etc,).","name":"Transactions"}],"security":[{"Ledger_API_User":[]},{"Ledger_API_User":[],"Ledger_API_Key":[]},{"Ledger_API_User":[],"Ledger_Store_Auth_Token":[]},{"Ledger_API_User":[],"Ledger_API_Key":[],"Ledger_Store_Auth_Token":[]}],"components":{"securitySchemes":{"Ledger_API_User":{"description":"(**required**) Username of a registered API User","in":"header","name":"X-Ledger-API-User","type":"apiKey"}},"schemas":{"Account":{"properties":{"address":{"default":null,"description":"The public address of the account (if any). Note that you should use the /accounts/:id/addresses endpoint to retrieve a trusted public address.","nullable":true,"type":"string"},"available_balance":{"pattern":"^[0-9]*(\\.[0-9]+)?$","type":"string"},"balance":{"pattern":"^[0-9]*(\\.[0-9]+)?$","type":"string"},"coin_fields":{"default":null,"nullable":true,"oneOf":[{"$ref":"#/components/schemas/TezosFields"},{"$ref":"#/components/schemas/PolkadotFields"},{"$ref":"#/components/schemas/SolanaAccountFields"},{"$ref":"#/components/schemas/EthereumAndEvmFields"},{"$ref":"#/components/schemas/PolygonFields"}]},"contract_address":{"default":null,"nullable":true,"type":"string"},"created_by":{"type":"integer"},"created_on":{"format":"date-time","type":"string"},"currency":{"enum":["Dollar","Euro","arbitrum","arbitrum_goerli","arbitrum_sepolia","avalanche_c_chain","avalanche_c_chain_fuji","base","base_goerli","base_sepolia","bitcoin","bitcoin_cash","bitcoin_gold","bitcoin_testnet","blast","blast_sepolia","bsc","cardano","celo","celo_alfajores","cosmos","cronos","cronos_testnet","dash","digibyte","dogecoin","ethereum","ethereum_classic","ethereum_goerli","ethereum_holesky","ethereum_hoodi","ethereum_pow","ethereum_ropsten","ethereum_sepolia","etherlink","fantom","fantom_testnet","filecoin","filecoin_calibration","flare","flare_coston","kava_evm","kava_evm_testnet","klaytn","klaytn_baobab","komodo","linea","litecoin","mantle","mantle_sepolia","near","neon_evm","optimism","optimism_goerli","optimism_sepolia","pivx","polkadot","polygon","polygon_amoy","polygon_mumbai","polygon_zk_evm","polygon_zk_evm_testnet","pulsechain","pulsechain_testnet","ripple","scroll","scroll_sepolia","solana","solana_devnet","solana_testnet","sonic","stellar","tezos","tomo","tomo_testnet","tron","vertcoin","viacoin","westend"],"type":"string"},"derivation_path":{"default":null,"nullable":true,"type":"string"},"governance_rules":{"items":{"$ref":"#/components/schemas/AccountRuleSet"},"type":"array"},"id":{"type":"integer"},"index":{"type":"integer"},"labels":{"description":"labels for this account","items":{"$ref":"#/components/schemas/LiteLabel"},"type":"array"},"last_request":{"default":null,"nullable":true,"type":"integer"},"name":{"type":"string"},"parent":{"default":null,"nullable":true,"type":"integer"},"pending_balance":{"pattern":"^[0-9]*(\\.[0-9]+)?$","type":"string"},"status":{"enum":["ACTIVATION_ABORTED","ACTIVE","APPROVED","HSM_COIN_UPDATED","PENDING","PENDING_ACTIVATION","PENDING_CREATE_IN_HSM","PENDING_VIEW_ONLY","REJECTED","VIEW_ONLY"],"type":"string"},"token_accounts":{"description":"Light token accounts for this account","items":{"$ref":"#/components/schemas/LightTokenAccount"},"type":"array"},"tradelink_data":{"allOf":[{"$ref":"#/components/schemas/TradelinkState"}],"default":null,"description":"Tradelink state for this account","nullable":true},"type":{"enum":["Bep20","Bitcoin","Cardano","Cosmos","Erc20","Ethereum","Generic","Near","Polkadot","Polygon","Ripple","Solana","Stellar","Tezos","Trc20","Tron"],"type":"string"},"xpub":{"default":null,"description":"The Extended Public Key of the account (if any). Note that you should use the /accounts/:id/addresses endpoint to retrieve and share a trusted public address. Only API Operators with view-all rights can retrieve the XPUB.","nullable":true,"type":"string"}},"required":["available_balance","balance","created_by","created_on","currency","governance_rules","id","index","name","pending_balance","status","type"],"type":"object"},"TezosFields":{"properties":{"staking":{"allOf":[{"$ref":"#/components/schemas/TezosStakeBlockchainState"}],"default":null,"description":"A valid tezos delegate","nullable":true},"type":{"default":"Tezos"}},"type":"object"},"TezosStakeBlockchainState":{"properties":{"activated_at":{"default":null,"description":"date on wich the stake was activated","format":"date-time","nullable":true,"type":"string"},"activated_cycle":{"default":null,"description":"cycle in which the stake was activated","nullable":true,"type":"integer"},"active_balance":{"default":null,"description":"amount of assets generating rewards in base unit of the network","nullable":true,"type":"string"},"baker_address":{"description":"baker address to which the stake was delegated","type":"string"},"delegated_at":{"description":"date at wich the stake was delegated","format":"date-time","type":"string"},"delegated_block":{"default":null,"description":"tezos block on which the stake was delegated","nullable":true,"type":"string"},"delegated_cycle":{"default":null,"description":"cycle in which the stake was delegated","nullable":true,"type":"integer"},"gross_apy":{"default":null,"description":"total APY generated by the stake","nullable":true,"pattern":"^[0-9]*(\\.[0-9]+)?$","type":"string"},"rewards":{"default":null,"description":"the total rewards generated by the stake","nullable":true,"type":"string"},"state":{"description":"status of the stake on chain","enum":["activating","active","inactive","syncing"],"type":"string"},"updated_at":{"default":null,"description":"date on wich the stake was last updated","format":"date-time","nullable":true,"type":"string"}},"required":["baker_address","delegated_at","state"],"type":"object"},"PolkadotFields":{"properties":{"anonymous_proxy":{"allOf":[{"$ref":"#/components/schemas/PolkadotAnonymousProxyInfo"}],"default":null,"nullable":true},"balances":{"$ref":"#/components/schemas/PolkadotBalancesWithUnbondingInfo"},"staking":{"$ref":"#/components/schemas/PolkadotStakingInfo"},"type":{"default":"Polkadot"}},"required":["balances","staking"],"type":"object"},"PolkadotAnonymousProxyInfo":{"properties":{"address":{"type":"string"},"balances":{"$ref":"#/components/schemas/PolkadotBalances"},"block_height":{"type":"integer"},"created_at":{"type":"string"},"ext_index":{"type":"integer"},"index":{"type":"integer"},"is_controller":{"type":"boolean"},"is_main":{"type":"boolean"},"kind":{"type":"string"}},"required":["address","balances","block_height","created_at","ext_index","index","is_controller","is_main","kind"],"type":"object"},"PolkadotBalances":{"properties":{"available":{"type":"string"},"bonded":{"type":"string"},"free":{"type":"string"},"frozen":{"type":"string"},"reserved":{"type":"string"},"total":{"type":"string"}},"required":["available","bonded","free","frozen","reserved","total"],"type":"object"},"PolkadotBalancesWithUnbondingInfo":{"properties":{"available":{"type":"string"},"bonded":{"type":"string"},"free":{"type":"string"},"frozen":{"type":"string"},"reserved":{"type":"string"},"total":{"type":"string"},"total_unbonded":{"type":"string"},"total_unbonding":{"type":"string"},"unbonded":{"items":{"$ref":"#/components/schemas/PolkadotUnbondingInfo"},"type":"array"},"unbonding":{"items":{"$ref":"#/components/schemas/PolkadotUnbondingInfo"},"type":"array"}},"required":["available","bonded","free","frozen","reserved","total","total_unbonded","total_unbonding","unbonded","unbonding"],"type":"object"},"PolkadotUnbondingInfo":{"properties":{"amount":{"type":"string"},"waiting_time":{"type":"integer"},"withdrawable_date":{"type":"string"}},"required":["amount","waiting_time","withdrawable_date"],"type":"object"},"PolkadotStakingInfo":{"properties":{"controller_address":{"default":null,"description":"Address of the anonymous proxy","nullable":true,"type":"string"},"is_nominator":{"description":"True if the account is an active nominator, false if it is \"chilled\"","type":"boolean"},"legacy_staking":{"description":"If true, this account uses the legacy staking flow with a PureProxy account","type":"boolean"},"proxies":{"description":"Addresses of proxies of the controller account","items":{"type":"string"},"type":"array"},"rewards_destination":{"default":null,"description":"Rewards destination","nullable":true,"type":"string"}},"required":["is_nominator","legacy_staking","proxies"],"type":"object"},"SolanaAccountFields":{"properties":{"staking":{"allOf":[{"$ref":"#/components/schemas/SolanaStakingInfo"}],"description":"Solana Staking balances and rewards"},"type":{"default":"Solana"}},"required":["staking"],"type":"object"},"SolanaStakingInfo":{"properties":{"balances":{"allOf":[{"$ref":"#/components/schemas/SolanaBalances"}],"description":"Balances of open stakes"},"rewards":{"allOf":[{"$ref":"#/components/schemas/PeriodicRewards"}],"description":"Rewards generated by active stakes"}},"required":["balances","rewards"],"type":"object"},"SolanaBalances":{"properties":{"activating":{"description":"Sum of balances of open stakes in status activating","type":"string"},"deactivating":{"description":"Sum of balances of open stakes in status deactivating","type":"string"},"delegated":{"description":"Sum of balances of open stakes in status delegated","type":"string"},"token_accounts":{"default":null,"description":"The light token accounts associated to this account","items":{"$ref":"#/components/schemas/LightTokenAccount"},"nullable":true,"type":"array"},"total_staked":{"description":"Total SOL locked into staking on this solana account","type":"string"},"undelegated":{"description":"Sum of balances of open stakes in status undelegated","type":"string"}},"required":["activating","deactivating","delegated","total_staked","undelegated"],"type":"object"},"LightTokenAccount":{"properties":{"account_name":{"type":"string"},"associated_token_account":{"type":"string"},"available":{"type":"integer"},"contract_address":{"type":"string"},"creation_transaction_hash":{"type":"string"},"parent_id":{"type":"integer"},"pending":{"type":"integer"},"status":{"type":"string"},"ticker":{"type":"string"}},"required":["account_name","associated_token_account","available","contract_address","creation_transaction_hash","parent_id","pending","status","ticker"],"type":"object"},"PeriodicRewards":{"properties":{"last30":{"description":"Rewards generated over the last 30 days by all active stakes","type":"string"},"last7":{"description":"Rewards generated over the last 7 days by all active stakes","type":"string"},"total":{"description":"Total rewards generated by all active stakes","type":"string"}},"required":["last30","last7","total"],"type":"object"},"EthereumAndEvmFields":{"properties":{"staking":{"allOf":[{"$ref":"#/components/schemas/EthereumStakingInfo"}],"default":null,"description":"Ethereum Staking data","nullable":true},"type":{"default":"EthereumAndEvm"}},"type":"object"},"EthereumStakingInfo":{"properties":{"available_rewards":{"default":null,"description":"Available rewards","nullable":true,"type":"string"},"network_apy":{"default":null,"description":"APY","nullable":true,"type":"number"},"total_rewards":{"default":null,"description":"Total rewards","nullable":true,"type":"string"},"total_staking":{"default":null,"description":"Total staking","nullable":true,"type":"string"}},"type":"object"},"PolygonFields":{"properties":{"staking":{"allOf":[{"$ref":"#/components/schemas/MaticStakingInfo"}],"default":null,"description":"Polygon Staking data","nullable":true},"type":{"default":"Polygon"}},"type":"object"},"MaticStakingInfo":{"properties":{"total_rewards":{"description":"Total rewards","type":"string"},"total_staking":{"description":"Total staking","type":"string"},"total_unbonded":{"description":"Total unbonded","type":"string"},"total_unbonding":{"description":"Total unbonding","type":"string"}},"required":["total_rewards","total_staking","total_unbonded","total_unbonding"],"type":"object"},"AccountRuleSet":{"properties":{"id":{"type":"integer"},"index":{"type":"integer"},"name":{"type":"string"},"rules":{"items":{"oneOf":[{"$ref":"#/components/schemas/AccountWhitelistRule"},{"$ref":"#/components/schemas/AccountThresholdRule"},{"$ref":"#/components/schemas/AccountMultiauthRule"},{"$ref":"#/components/schemas/AccountTransactionFilterRule"},{"$ref":"#/components/schemas/AccountSmartContractInteractionRule"}]},"type":"array"}},"required":["id","index","name","rules"],"type":"object"},"AccountWhitelistRule":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AccountWhitelistRuleEntry"},"type":"array"},"id":{"type":"integer"},"type":{"enum":["MULTI_AUTHORIZATIONS","SMART_CONTRACT_INTERACTION","THRESHOLD","TRANSACTION_FILTER","WHITELIST"],"type":"string"}},"required":["data","id","type"],"type":"object"},"AccountWhitelistRuleEntry":{"properties":{"whitelist":{"type":"integer"}},"required":["whitelist"],"type":"object"},"AccountThresholdRule":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AccountThresholdRuleEntry"},"type":"array"},"id":{"type":"integer"},"type":{"enum":["MULTI_AUTHORIZATIONS","SMART_CONTRACT_INTERACTION","THRESHOLD","TRANSACTION_FILTER","WHITELIST"],"type":"string"}},"required":["data","id","type"],"type":"object"},"AccountThresholdRuleEntry":{"properties":{"currency_type":{"type":"string"},"max":{"default":null,"nullable":true,"type":"integer"},"min":{"type":"integer"}},"required":["currency_type","min"],"type":"object"},"AccountMultiauthRule":{"properties":{"data":{"items":{"default":null,"nullable":true,"oneOf":[{"$ref":"#/components/schemas/AccountMultiauthRuleExternalGroupEntry"},{"$ref":"#/components/schemas/AccountMultiauthRuleInternalGroupEntry"}]},"type":"array"},"id":{"type":"integer"},"type":{"enum":["MULTI_AUTHORIZATIONS","SMART_CONTRACT_INTERACTION","THRESHOLD","TRANSACTION_FILTER","WHITELIST"],"type":"string"}},"required":["data","id","type"],"type":"object"},"AccountMultiauthRuleExternalGroupEntry":{"properties":{"group":{"type":"integer"},"quorum":{"type":"integer"}},"required":["group","quorum"],"type":"object"},"AccountMultiauthRuleInternalGroupEntry":{"properties":{"quorum":{"type":"integer"},"users":{"items":{"default":null,"nullable":true,"type":"integer"},"type":"array"}},"required":["quorum","users"],"type":"object"},"AccountTransactionFilterRule":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AccountTransactionFilterRuleEntry"},"type":"array"},"id":{"type":"integer"},"type":{"enum":["MULTI_AUTHORIZATIONS","SMART_CONTRACT_INTERACTION","THRESHOLD","TRANSACTION_FILTER","WHITELIST"],"type":"string"}},"required":["data","id","type"],"type":"object"},"AccountTransactionFilterRuleEntry":{"properties":{"condition":{"default":null,"enum":[null,"ALL","ANY"],"nullable":true,"type":"string"},"filters":{"additionalProperties":{"oneOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}]},"default":null,"nullable":true,"type":"object"},"preset":{"default":null,"nullable":true,"type":"string"}},"type":"object"},"AccountSmartContractInteractionRule":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AccountSmartContractInteractionRuleEntry"},"type":"array"},"id":{"type":"integer"},"type":{"enum":["MULTI_AUTHORIZATIONS","SMART_CONTRACT_INTERACTION","THRESHOLD","TRANSACTION_FILTER","WHITELIST"],"type":"string"}},"required":["data","id","type"],"type":"object"},"AccountSmartContractInteractionRuleEntry":{"properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"type":"object"},"LiteLabel":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"info":{"$ref":"#/components/schemas/LabelInfo"},"name":{"description":"name of the tag","type":"string"}},"required":["id","info","name"],"type":"object"},"LabelInfo":{"properties":{"color":{"description":"color of the tag","type":"string"},"description":{"description":"description of this tag","type":"string"}},"required":["color","description"],"type":"object"},"TradelinkState":{"properties":{"total_repledge":{"description":"Total pending repledge balance over all account pledges","type":"string"}},"required":["total_repledge"],"type":"object"},"Error":{"properties":{"message":{"type":"string"},"name":{"type":"string"},"status_code":{"type":"integer"}},"required":["message","name","status_code"],"type":"object"}}},"paths":{"/accounts/{account_id}/sync":{"get":{"summary":"Sync the account to update transactions with list status","tags":["Accounts","Transactions"],"description":"This will synchronize the account's transactions status with the one on the blockchain","parameters":[{"name":"account_id","in":"path","description":"The account's ID","required":true,"schema":{"type":"integer"}},{"name":"synchronous","in":"query","description":"If true, the synchronization will be performed synchronously. Otherwise, it will run a a background task","required":false,"schema":{"default":false,"nullable":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}},"description":"Account object"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Account not found"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.enterprise.ledger.com/api-documentation/reference/api-reference/accounts/sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.