List Followed Assets

List followed assets

curl --request GET \
  --url https://app.chainpatrol.io/api/v2/asset/follows \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.chainpatrol.io/api/v2/asset/follows', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.chainpatrol.io/api/v2/asset/follows",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.chainpatrol.io/api/v2/asset/follows"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.chainpatrol.io/api/v2/asset/follows")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "follows": [
    {
      "assetId": 123,
      "content": "<string>",
      "type": "URL",
      "status": "UNKNOWN",
      "deleted": true,
      "followedAt": "<string>",
      "takedown": {
        "id": 123,
        "status": "TODO"
      }
    }
  ],
  "followCount": 123,
  "limit": 123,
  "warnThreshold": 123,
  "canFollowMore": true,
  "warning": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

GET

asset

follows

List followed assets

curl --request GET \
  --url https://app.chainpatrol.io/api/v2/asset/follows \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.chainpatrol.io/api/v2/asset/follows', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.chainpatrol.io/api/v2/asset/follows",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.chainpatrol.io/api/v2/asset/follows"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.chainpatrol.io/api/v2/asset/follows")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "follows": [
    {
      "assetId": 123,
      "content": "<string>",
      "type": "URL",
      "status": "UNKNOWN",
      "deleted": true,
      "followedAt": "<string>",
      "takedown": {
        "id": 123,
        "status": "TODO"
      }
    }
  ],
  "followCount": 123,
  "limit": 123,
  "warnThreshold": 123,
  "canFollowMore": true,
  "warning": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Overview

List every asset you follow in an organization, newest first, with each asset’s current status and your organization’s takedown for it. Use it to see status changes without waiting for email: poll it and compare status and takedown.status with what you saw last time. Each person can follow at most 100 assets per organization, so the list is never paginated. It needs a user-scoped API key or a signed-in session, and shows only your follows — not those of other people in your organization.

Quick Start

Authentication

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

X-API-KEY: <api-key>

Example Request

curl -X GET 'https://app.chainpatrol.io/api/v2/asset/follows' \
  -H 'X-API-KEY: <api-key>'

const response = await fetch("https://app.chainpatrol.io/api/v2/asset/follows", {
  headers: { "X-API-KEY": "<api-key>" },
});

const { follows, followCount, limit } = await response.json();

import requests

response = requests.get(
    "https://app.chainpatrol.io/api/v2/asset/follows",
    headers={"X-API-KEY": "<api-key>"},
)
data = response.json()

Query Parameters

Parameter	Type	Required	Description
`slug`	`string`	No	Organization slug. Required only when your credentials can reach more than one organization.

Response

{
  "follows": [
    {
      "assetId": 4175269,
      "content": "your-brand-login.example",
      "type": "URL",
      "status": "BLOCKED",
      "deleted": false,
      "followedAt": "2026-10-06T22:34:47.912Z",
      "takedown": { "id": 8812, "status": "IN_PROGRESS" }
    }
  ],
  "followCount": 1,
  "limit": 100,
  "warnThreshold": 90,
  "canFollowMore": true,
  "warning": null
}

Field	Type	Description
`follows[].assetId`	`number`	Asset ID.
`follows[].content`	`string`	Asset content (URL, handle, address, …).
`follows[].type`	`string`	Asset type.
`follows[].status`	`string`	Current asset status: `UNKNOWN`, `ALLOWED` or `BLOCKED`.
`follows[].deleted`	`boolean`	The asset was deleted. It sends no more emails but still counts toward `limit` until you unfollow.
`follows[].followedAt`	`string`	When you started following the asset.
`follows[].takedown`	`object \| null`	Your organization’s takedown for the asset — its `id` and `status` — or `null` if there is none.
`followCount`	`number`	How many assets you follow in this organization.
`limit`, `warnThreshold`, `canFollowMore`, `warning`		Your follow limit, as in Follow Asset.

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.

Query Parameters

slug

string

Response

Successful response

follows

object[]

required

Show child attributes

followCount

integer

required

How many assets this person follows in this organization

limit

integer

required

The most assets one person may follow

warnThreshold

integer

required

The count from which warning is set

canFollowMore

boolean

required

False once followCount reaches limit; following more is refused

warning

string | null

required

Set from warnThreshold upward, asking the caller to unfollow assets

Getting Started

Assets

Reports

Disputes

Webhooks

Organization Brands

Organization Assets

Organization Asset Groups

Organization Reports

Detections

Dark Web

Takedowns

Metrics

Account & Access

Operations

Healthchecks

Overview

Quick Start

Authentication

Example Request

Query Parameters

Response

Authorizations

Query Parameters

Response

​Overview

​Quick Start

​Authentication

​Example Request

​Query Parameters

​Response

​Related

Authorizations

Query Parameters

Response

Overview

Quick Start

Authentication

Example Request

Query Parameters

Response

Related