pub.chive.admin.searchUsers

chive.pub View official

Documentation

Search users by handle or DID

main query

Search users by handle or DID

Parameters

limit integer Optional

Maximum number of results

query string Required

Search term (handle or DID prefix)

Output

Encodingapplication/json
users array Required

Matching users

Errors

AuthenticationRequired
AdminRequired
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Maximum number of results
Search term (handle or DID prefix)
View raw schema 
{
  "description": "Search users by handle or DID",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "users": {
          "description": "Matching users",
          "items": {
            "ref": "#userDetail",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "users"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "limit": {
        "default": 20,
        "description": "Maximum number of results",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "query": {
        "description": "Search term (handle or DID prefix)",
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "params"
  },
  "type": "query"
}
userDetail object

User detail with stats and roles

Properties

createdAt string datetime Optional

Account indexed timestamp

did string did Required

User DID

displayName string Optional

Display name

endorsementCount integer Required

Number of endorsements given

eprintCount integer Required

Number of eprints submitted

handle string Optional

User handle

reviewCount integer Required

Number of reviews written

roles array of string Required

Assigned role identifiers

View raw schema 
{
  "description": "User detail with stats and roles",
  "properties": {
    "createdAt": {
      "description": "Account indexed timestamp",
      "format": "datetime",
      "type": "string"
    },
    "did": {
      "description": "User DID",
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "description": "Display name",
      "type": "string"
    },
    "endorsementCount": {
      "description": "Number of endorsements given",
      "type": "integer"
    },
    "eprintCount": {
      "description": "Number of eprints submitted",
      "type": "integer"
    },
    "handle": {
      "description": "User handle",
      "type": "string"
    },
    "reviewCount": {
      "description": "Number of reviews written",
      "type": "integer"
    },
    "roles": {
      "description": "Assigned role identifiers",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "did",
    "eprintCount",
    "reviewCount",
    "endorsementCount",
    "roles"
  ],
  "type": "object"
}

Lexicon Garden

@