Block Search

Prepare Search Block by Block Id.

Returns a request ID for executing a block search on the requested DLT. Block searches can be prepared based on the Block ID, Block Number or for the latest block at the time

SecurityOAuth2_Security_Scheme
Request
path Parameters
blockId
required
string
Examples:
Search latest block
latest
Search block by Block ID
54678
Search block by Block Hash
0x1032d0f10fad4a5ada02960f552063e862e952d7d808ecf43b25a4f26d640a56
header Parameters
Authorization
required
string [ 0 .. 5010 ] characters ^Bearer [A-Za-z0-9\-_. ]{1,5010}$
Request Body schema: application/json
object (Location)

Unique reference to the ledger on a particular ledger network (optionally accessed from a particular node)

Responses
200

All good!

401

Unauthorised

500

Something went wrong on our side

post/v2/preparation/search/block/{blockId}
Request samples
application/json

Block Search

{
  • "location": {
    }
}
Response samples
application/json

Prepare Response

{
  • "gatewayFee": {
    },
  • "requestId": "13765b06-eaf3-4f02-acb4-b7e9da8b0380"
}

Execute a search for a block on a DLT

Takes a request ID and searches for the block on the requested DLT based on the parameters specified in the prepare request

SecurityOAuth2_Security_Scheme
Request
query Parameters
requestId
required
string [ 0 .. 36 ] characters ^[A-Za-z0-9-]{1,36}$
header Parameters
Authorization
required
string [ 0 .. 5010 ] characters ^Bearer [A-Za-z0-9\-_. ]{1,5010}$
Responses
200

All good!

401

Unauthorised

404

Not Found

500

Something went wrong on our side

post/v2/execution/search/block
Request samples
Response samples
application/json

Execute Response

{
  • "location": {
    },
  • "block": {
    },
  • "status": {
    }
}

Prepare and automatically execute a search for a block on a DLT.

Generates a request ID and automatically executes the block search on the requested DLT.

SecurityOAuth2_Security_Scheme
Request
path Parameters
blockId
required
string
Examples:
Search latest block
latest
Search block by Block ID
54678
Search block by Block Hash
0x1032d0f10fad4a5ada02960f552063e862e952d7d808ecf43b25a4f26d640a56
header Parameters
Authorization
required
string [ 0 .. 5010 ] characters ^Bearer [A-Za-z0-9\-_. ]{1,5010}$
Request Body schema: application/json
object (Location)

Unique reference to the ledger on a particular ledger network (optionally accessed from a particular node)

Responses
200

All good!

400

Bad Request

401

Unauthorised

500

Something went wrong on our side

post/v2/autoexecution/search/block/{blockId}
Request samples
application/json

Block Search

{
  • "location": {
    }
}
Response samples
application/json

Successful Prepare and Failed Execute Response

{
  • "prepareAndExecuteOverledgerErrorResponse": {
    },
  • "preparationBlockSearchResponse": {
    }
}