bmap_readFollows

Read follow relationships from the BMAP API. Shows who a user is following or who follows them.

Result

Matching BMAP follows as JSON text.

Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

Inputs and availability

Full catalog · Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Local Vault + sponsor; Droplit wallet

Field	Type / required	Description
bapId	string Required	BAP identity key to get follow relationships for
type	"followers" \| "following" Optional	Type of relationship to query default: "following"
limit	number Optional	Maximum number of follows to return default: 20; minimum: 1; maximum: 100
page	number Optional	Page number for pagination (1-based) default: 1; minimum: 1

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "bapId": {
      "type": "string",
      "description": "BAP identity key to get follow relationships for"
    },
    "type": {
      "default": "following",
      "description": "Type of relationship to query",
      "type": "string",
      "enum": [
        "followers",
        "following"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of follows to return",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination (1-based)",
      "type": "number",
      "minimum": 1
    }
  },
  "required": [
    "bapId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}