# Get checkpoint by number

## GET /v1/checkpoints/by\_number

>

```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_number":{"get":{"tags":["checkpoints"],"operationId":"get_by_number","parameters":[{"name":"number","in":"query","description":"Number 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. <https://github.com/ethereum-optimism/optimism/blob/0bf643c4147b43cd6f25a759d331ef3a2a61a2a3/specs/deposits.md#the-deposited-transaction-type>) 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 <https://ethereum.github.io/execution-apis/api-documentation/> and <https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyhash>","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"}}}}}}
```


---

# 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://developer.1moneynetwork.com/integrations/rest-apis/checkpoints/get-checkpoint-by-number.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.