> For the complete documentation index, see [llms.txt](https://developer.1moneynetwork.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.1moneynetwork.com/integrations/rest-apis/checkpoints/get-checkpoint-by-hash.md). # Get checkpoint by hash ## GET /v1/checkpoints/by\_hash > ```json {"openapi":"3.1.0","info":{"title":"om-api-rest","version":"0.1.0"},"tags":[{"name":"checkpoints","description":"Checkpoints API"}],"servers":[{"url":"https://api.testnet.1money.network","description":"Testnet API server"},{"url":"https://api.1money.network","description":"Mainnet API server"},{"url":"http://localhost:18555","description":"Local API server"}],"paths":{"/v1/checkpoints/by_hash":{"get":{"tags":["checkpoints"],"operationId":"get_by_hash","parameters":[{"name":"hash","in":"query","description":"hash of the checkpoint to lookup","required":true,"schema":{"type":"string"}},{"name":"full","in":"query","description":"Full transaction details","required":true,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Checkpoint"}}}},"400":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"408":{"description":"Request timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"422":{"description":"Business logic error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}}}}}},"components":{"schemas":{"Checkpoint":{"allOf":[{"$ref":"#/components/schemas/Header","description":"Header of the checkpoint."},{"type":"object","required":["transactions"],"properties":{"size":{"type":"integer","format":"int64","description":"Integer the size of this checkpoint in bytes.","minimum":0},"transactions":{"$ref":"#/components/schemas/CheckpointTransactions","description":"Checkpoint Transactions."}}}]},"Header":{"type":"object","description":"checkpoint header representation.","required":["hash","parent_hash","state_root","transactions_root","receipts_root","number","timestamp","extra_data"],"properties":{"extra_data":{"type":"string","description":"Extra data"},"hash":{"$ref":"#/components/schemas/B256Schema","description":"Hash of the checkpoint"},"number":{"type":"integer","format":"int64","description":"Checkpoint number","minimum":0},"parent_hash":{"$ref":"#/components/schemas/B256Schema","description":"Hash of the parent"},"receipts_root":{"$ref":"#/components/schemas/B256Schema","description":"Transactions receipts root hash"},"state_root":{"$ref":"#/components/schemas/B256Schema","description":"State root hash"},"timestamp":{"type":"integer","format":"int64","description":"Timestamp","minimum":0},"transactions_root":{"$ref":"#/components/schemas/B256Schema","description":"Transactions root hash"}}},"B256Schema":{"type":"string","title":"string"},"CheckpointTransactions":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Transaction"},"description":"Full transactions"},{"$ref":"#/components/schemas/B256Schema","description":"Only hashes"}],"description":"Checkpoint Transactions depending on the boolean attribute of\n`getCheckpointBy*`."},"Transaction":{"allOf":[{"$ref":"#/components/schemas/TxPayload"},{"type":"object","required":["hash","chain_id","from","nonce","signature"],"properties":{"chain_id":{"$ref":"#/components/schemas/u64","description":"The chain id of the transaction, if any."},"checkpoint_hash":{"$ref":"#/components/schemas/B256Schema","description":"Checkpoint hash"},"checkpoint_number":{"type":"integer","format":"int64","description":"Checkpoint number","minimum":0},"from":{"$ref":"#/components/schemas/AddressSchema","description":"Sender"},"hash":{"$ref":"#/components/schemas/B256Schema","description":"Transaction hash"},"nonce":{"$ref":"#/components/schemas/u64","description":"Nonce"},"signature":{"$ref":"#/components/schemas/RestSignature","description":"All _flattened_ fields of the transaction signature.\nNote: this is an option so special transaction types without a signature (e.g. ) can be supported."},"transaction_index":{"type":"integer","format":"int64","description":"Transaction index","minimum":0}}}]},"TxPayload":{"oneOf":[{"type":"object","description":"Create a new mint token. After the token is created, the\n`master_authority` of the token is initialized with the provided\n`master_authority` parameter.\n\nRefer to `TokenInstruction::CreateNewToken`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Create a new mint token. After the token is created, the\n`master_authority` of the token is initialized with the provided\n`master_authority` parameter.\n\nRefer to `TokenInstruction::CreateNewToken`.","required":["symbol","decimals","master_authority","is_private","name"],"properties":{"decimals":{"type":"integer","format":"int32","description":"Number of base 10 digits to the right of the decimal place.","minimum":0},"is_private":{"type":"boolean","description":"`true` if this token is private and only whitelisted addresses can\noperate with the tokens"},"master_authority":{"$ref":"#/components/schemas/AddressSchema","description":"The master authority of the token."},"name":{"type":"string","description":"The name of the token to create."},"symbol":{"type":"string","description":"The symbol of the token to create."}}},"transaction_type":{"type":"string","enum":["TokenCreate"]}}},{"type":"object","description":"Transfer tokens from one account to another. The signer of message must\nbe the owner of the source account. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::Transfer`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Transfer tokens from one account to another. The signer of message must\nbe the owner of the source account. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::Transfer`.","required":["value","recipient","token"],"properties":{"recipient":{"$ref":"#/components/schemas/AddressSchema","description":"The real recipient address."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address, if it's native token, token address is `None`."},"value":{"$ref":"#/components/schemas/U256Schema","description":"The amount of tokens to transfer."}}},"transaction_type":{"type":"string","enum":["TokenTransfer"]}}},{"type":"object","description":"Grant authority to another account. The signer of message must be the\nMint's `master_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::GrantAuthority`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Grant authority to another account. The signer of message must be the\nMint's `master_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::GrantAuthority`.","required":["authority_type","authority_address","token"],"properties":{"authority_address":{"$ref":"#/components/schemas/AddressSchema","description":"The new authority address to grant or revoke."},"authority_type":{"type":"string","description":"The type of authority to update."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The allowance value of tokens to grant, only works for\n`MintBurnTokens` type."}}},"transaction_type":{"type":"string","enum":["TokenGrantAuthority"]}}},{"type":"object","description":"Revoke authority to another account. The signer of message must be the\nMint's `master_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::RevokeAuthority`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Revoke authority to another account. The signer of message must be the\nMint's `master_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::RevokeAuthority`.","required":["authority_type","authority_address","token"],"properties":{"authority_address":{"$ref":"#/components/schemas/AddressSchema","description":"The new authority"},"authority_type":{"type":"string","description":"The type of authority to update."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The allowance value of tokens to revoke, only works for\n`MintBurnTokens` type."}}},"transaction_type":{"type":"string","enum":["TokenRevokeAuthority"]}}},{"type":"object","description":"Add the account to the blacklisted accounts. The signer of message must\nbe the Mint's `blacklist_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::BlacklistAccount`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Add the account to the blacklisted accounts. The signer of message must\nbe the Mint's `blacklist_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::BlacklistAccount`.","required":["address","token"],"properties":{"address":{"$ref":"#/components/schemas/AddressSchema","description":"The account to blacklist"},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenBlacklistAccount"]}}},{"type":"object","description":"Whitelist the a previously blacklisted account. The signer of message\nmust be the Mint's `blacklist_authority`. Otherwise the transaction may\nfail.\n\nRefer to `TokenInstruction::WhitelistAccount`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Whitelist the a previously blacklisted account. The signer of message\nmust be the Mint's `blacklist_authority`. Otherwise the transaction may\nfail.\n\nRefer to `TokenInstruction::WhitelistAccount`.","required":["address","token"],"properties":{"address":{"$ref":"#/components/schemas/AddressSchema","description":"The account to whitelist"},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenWhitelistAccount"]}}},{"type":"object","description":"Mints new tokens to an account. The signer of the message must be Mint's\n`mint_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::MintTo`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Mints new tokens to an account. The signer of the message must be Mint's\n`mint_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::MintTo`.","required":["value","recipient","token"],"properties":{"recipient":{"$ref":"#/components/schemas/AddressSchema","description":"The recipient address of the token mint to."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The amount of new tokens to mint."}}},"transaction_type":{"type":"string","enum":["TokenMint"]}}},{"type":"object","description":"Bridge tokens from another chain and mint them to an account. This\ninstruction creates new tokens representing bridged assets. The\nsigner must have bridge authority.\n\nRefer to `TokenInstruction::BridgeAndMint`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Bridge tokens from another chain and mint them to an account. This\ninstruction creates new tokens representing bridged assets. The\nsigner must have bridge authority.\n\nRefer to `TokenInstruction::BridgeAndMint`.","required":["recipient","value","source_chain_id","source_tx_hash","token"],"properties":{"bridge_metadata":{"type":["string","null"],"description":"Optional bridge metadata for additional verification."},"recipient":{"$ref":"#/components/schemas/AddressSchema","description":"The recipient address to mint tokens to."},"source_chain_id":{"type":"integer","format":"int64","description":"The chain ID from which tokens are being bridged.","minimum":0},"source_tx_hash":{"type":"string","description":"The transaction hash on the source chain proving the lock/burn."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The amount of tokens to mint from the bridge."}}},"transaction_type":{"type":"string","enum":["TokenBridgeAndMint"]}}},{"type":"object","description":"Burns tokens by removing them from an account. The signer of the message\nmust be Mint's `mint_burn` authority. Otherwise the transaction may\nfail.\n\nRefer to `TokenInstruction::BurnFromAccount`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Burns tokens by removing them from an account. The signer of the message\nmust be Mint's `mint_burn` authority. Otherwise the transaction may\nfail.\n\nRefer to `TokenInstruction::BurnFromAccount`.","required":["value","recipient","token"],"properties":{"recipient":{"$ref":"#/components/schemas/AddressSchema","description":"This field is obsolete and will be ignored. The tokens will be burnt\nfrom the signer's wallet."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The amount of tokens to burn."}}},"transaction_type":{"type":"string","enum":["TokenBurn"]}}},{"type":"object","description":"Burn tokens and initiate bridge to another chain. This instruction burns\ntokens and records bridge information for the destination chain. The\nsigner must be the account owner or have appropriate authority.\n\nRefer to `TokenInstruction::BurnAndBridge`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Burn tokens and initiate bridge to another chain. This instruction burns\ntokens and records bridge information for the destination chain. The\nsigner must be the account owner or have appropriate authority.\n\nRefer to `TokenInstruction::BurnAndBridge`.","required":["value","sender","destination_chain_id","destination_address","escrow_fee","token"],"properties":{"bridge_metadata":{"type":["string","null"],"description":"Optional bridge metadata for additional information"},"bridge_param":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BytesSchema","description":"Optional bridge parameters as arbitrary bytes"}]},"destination_address":{"type":"string","description":"The destination address on the target chain"},"destination_chain_id":{"type":"integer","format":"int64","description":"The destination chain ID to bridge tokens to","minimum":0},"escrow_fee":{"$ref":"#/components/schemas/U256Schema","description":"The bridging fee necessary to escrow for transferring tokens to the\ndestination chain"},"sender":{"$ref":"#/components/schemas/AddressSchema","description":"This field is obsolete and will be ignored. The tokens will be burnt\nfrom the signer's wallet."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"},"value":{"$ref":"#/components/schemas/U256Schema","description":"The amount of tokens to burn for bridging"}}},"transaction_type":{"type":"string","enum":["TokenBurnAndBridge"]}}},{"type":"object","description":"Close an account. Note that an account can be closed only if the token\nbalance is zero.\n\nRefer to `TokenInstruction::CloseAccount`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Close an account. Note that an account can be closed only if the token\nbalance is zero.\n\nRefer to `TokenInstruction::CloseAccount`.","required":["token"],"properties":{"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenCloseAccount"]}}},{"type":"object","description":"Pause all transactions associated with the Mint. The signer of the\nmessage must be the Mint's `pause_authority`. Otherwise the\ntransaction may fail.\n\nRefer to `TokenInstruction::Pause`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Pause all transactions associated with the Mint. The signer of the\nmessage must be the Mint's `pause_authority`. Otherwise the\ntransaction may fail.\n\nRefer to `TokenInstruction::Pause`.","required":["token"],"properties":{"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenPause"]}}},{"type":"object","description":"Unpause transactions for the Mint. The signer of the message must be the\nMint's `pause_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::Unpause`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Unpause transactions for the Mint. The signer of the message must be the\nMint's `pause_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::Unpause`.","required":["token"],"properties":{"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenUnpause"]}}},{"type":"object","description":"Update token metadata. The signer of the message must be the Mint's\n`metadata_update_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::UpdateMetadata`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Update token metadata. The signer of the message must be the Mint's\n`metadata_update_authority`. Otherwise the transaction may fail.\n\nRefer to `TokenInstruction::UpdateMetadata`.","required":["metadata","token"],"properties":{"metadata":{"$ref":"#/components/schemas/TokenMetadata","description":"The metadata to update"},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["TokenUpdateMetadata"]}}},{"type":"object","description":"Add a pricing plan that defines custom fee behavior.\n\nRefer to the `AddPricingPlanPayload`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Add a pricing plan that defines custom fee behavior.\n\nRefer to the `AddPricingPlanPayload`.","required":["plan"],"properties":{"plan":{"description":"Complete plan definition that will be stored on chain."}}},"transaction_type":{"type":"string","enum":["AddPricingPlan"]}}},{"type":"object","description":"Remove an existing pricing plan from the network.\n\nRefer to the `RemovePricingPlanPayload`.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Remove an existing pricing plan from the network.\n\nRefer to the `RemovePricingPlanPayload`.","required":["address"],"properties":{"address":{"$ref":"#/components/schemas/AddressSchema","description":"Identifier of the plan to remove."}}},"transaction_type":{"type":"string","enum":["RemovePricingPlan"]}}},{"type":"object","description":"Raw transaction data, all unsupported instructions are encoded as raw\ndata.\n\nThis variant is used for all instructions that are not supported by the\ncurrent version of the API. Just for compatibility.","required":["data","transaction_type"],"properties":{"data":{"type":"object","description":"Raw transaction data, all unsupported instructions are encoded as raw\ndata.\n\nThis variant is used for all instructions that are not supported by the\ncurrent version of the API. Just for compatibility.","required":["input","token"],"properties":{"input":{"$ref":"#/components/schemas/BytesSchema","description":"The input data of the transaction."},"token":{"$ref":"#/components/schemas/AddressSchema","description":"The token address"}}},"transaction_type":{"type":"string","enum":["Raw"]}}}],"description":"Instructions supported by mint token"},"AddressSchema":{"type":"string","title":"string"},"U256Schema":{"type":"string","title":"string"},"BytesSchema":{"type":"string","title":"hex string"},"TokenMetadata":{"type":"object","description":"Token metadata for one token.","required":["name","uri","additional_metadata"],"properties":{"additional_metadata":{"type":"array","items":{"$ref":"#/components/schemas/MetadataKVPair"},"description":"must avoid storing the same key twice"},"name":{"type":"string","description":"The longer name of the token"},"uri":{"type":"string","description":"The URI pointing to richer metadata"}}},"MetadataKVPair":{"type":"object","description":"The additional key-value properties for one token.","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}},"u64":{"type":"integer","format":"int64","minimum":0},"RestSignature":{"type":"object","description":"Signature type for REST requests.\n\nWe use this type to avoid the ambiguity of the signature type in the core\nprimitives.\n\nThis type is referred to `https://github.com/alloy-rs/alloy/blob/b2278c40b2693908e4e5108d65ade26e8d716765/crates/rpc-types-eth/src/transaction/signature.rs#L9`.","required":["r","s","v"],"properties":{"r":{"$ref":"#/components/schemas/SignatureRSchema","description":"The R field of the signature; the point on the curve."},"s":{"$ref":"#/components/schemas/SignatureSSchema","description":"The S field of the signature; the point on the curve."},"v":{"type":"integer","format":"int64","description":"For EIP-155, EIP-2930 and Blob transactions this is set to the parity (0\nfor even, 1 for odd) of the y-value of the secp256k1 signature.\n\nFor legacy transactions, this is the recovery id\n\nSee also and ","minimum":0}}},"SignatureRSchema":{"type":"string","title":"string","description":"Signature R schema"},"SignatureSSchema":{"type":"string","title":"string","description":"Signature S schema"},"RESTErrorData":{"type":"object","required":["error_code","message"],"properties":{"error_code":{"type":"string","description":"Structured error code for programmatic handling"},"message":{"type":"string","description":"Human-readable error message"}}}}}} ```