Asset Search

Search for an asset by content or ID and get its status, associated reports, and takedown details

POST /asset/search

Search asset

cURL

curl --request POST \
  --url https://app.chainpatrol.io/api/v2/asset/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "content": "<string>",
  "assetId": 123
}
'

200

{
  "asset": {
    "id": 123,
    "content": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "reports": [
    {
      "id": 123,
      "title": "<string>",
      "createdAt": "<string>"
    }
  ],
  "takedown": {
    "id": 123,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "tasks": [
      {
        "id": 123,
        "externalId": "<string>",
        "submittedAt": "<string>",
        "retractedAt": "<string>",
        "lastResponseAt": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "takedownProvider": {
          "name": "<string>"
        }
      }
    ]
  },
  "blockedBy": [
    {
      "consumer": "<string>",
      "name": "<string>",
      "consumedAt": "<string>"
    }
  ]
}

Overview

The Asset Search endpoint returns a single result with four main parts:

• asset - The matched asset: its id, content, type, status, watchStatus, and timestamps (createdAt, updatedAt).
• reports - List of reports linked to the asset, each with id, title, status, and createdAt.
• takedown - Takedown metadata (id, status, timestamps) plus a tasks array. Each task has type, status, retractionStatus, the associated takedownProvider name, submission/retraction timestamps, and an optional externalId for the provider’s tracking ID. Learn more about takedown tasks.
• blockedBy - List of platforms currently consuming (blocking) the asset. Each entry has a consumer slug (e.g. metamask, google-safe-browsing, quad9), the platform’s display name, and a consumedAt timestamp indicating when the platform started blocking the asset.

Quick Start

Authentication

Include your API key in the X-API-KEY header:

X-API-KEY: <api-key>

Authorizations

X-API-KEY · string · header · required

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at [e-mail] to get an API key for your use.

Body

application/json

content · string

assetId · integer

Response

200

application/json

Successful response

asset · object · required

Show child attributes

reports · object[] · required

Show child attributes

takedown · object · required

Show child attributes

blockedBy · object[] · required

Show child attributes