Skip to main content
POST
/
asset
/
search
Search asset
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
}
'
{
  "asset": {
    "id": 123,
    "content": "<string>",
    "type": "URL",
    "status": "UNKNOWN",
    "watchStatus": "ENABLED",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "reports": [
    {
      "id": 123,
      "title": "<string>",
      "status": "TODO",
      "createdAt": "<string>"
    }
  ],
  "takedown": {
    "id": 123,
    "status": "TODO",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "tasks": [
      {
        "id": 123,
        "type": "HOSTING_PROVIDER",
        "status": "TODO",
        "retractionStatus": "NOT_RETRACTED",
        "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 support@chainpatrol.io to get an API key for your use.

Body

application/json
content
string
assetId
integer

Response

Successful response

asset
object
required
reports
object[]
required
takedown
object
required
blockedBy
object[]
required