Register a search on the blockchain

POST

/v1/searches/{searchId}/blockchain

Registers the current state of a search on the blockchain, so that its
existence and key attributes can be independently verified.

Calling this endpoint multiple times for the same searchId is idempotent:
if a blockchain record already exists, it will be returned instead of
creating a new one.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Blockchain processing started or an existing record was returned.

Body

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.sherlockeye.io/v1/searches//blockchain' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "searchId": "string",
        "alreadyExists": true,
        "blockchainData": {
            "signature": "string",
            "confirmed": true,
            "timestamp": 0,
            "explorerUrl": "http://example.com"
        }
    }
}

Modified at 2026-03-04 16:42:25

Delete a search

Create a new webhook