Get search details and results

GET

/v1/searches/{searchId}

Returns metadata and results for a specific search job.

Depending on the processing state, the status field can be:

processing: the search is still running and results may be incomplete.

complete: the search finished (successfully or after timeout; results are preserved either way).

The expiresAt field indicates when the stored results become inaccessible (retention limit).

The results array contains individual OSINT hits, and blockchainData, if present,
provides a verifiable record of the search on the blockchain.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Responses

🟢200

application/json

Search found; status and results returned.

Body

🟠400

🟠401

🟠404

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Completed search with results (API v1 format)

{
    "success": true,
    "data": {
        "searchId": "f6f3b720-4f3a-4dcf-9d0e-6e5efc46f8c9",
        "query": "email:\"someone@example.com\"",
        "status": "complete",
        "createdAt": "2025-01-01T12:00:05.000Z",
        "expiresAt": "2025-12-31T23:59:59.000Z",
        "results": [
            {
                "id": "result-1",
                "source": "google",
                "attributes": {
                    "link": "https://profiles.google.com/someone"
                }
            },
            {
                "id": "result-2",
                "source": "microsoft",
                "attributes": {
                    "name": "john doe"
                }
            }
        ],
        "blockchainData": null
    }
}

Modified at 2026-03-24 12:06:30

Create a new asynchronous OSINT search

Run a synchronous OSINT search with timeout