Skip to main content
GET
/
api
/
v1
/
users
/
{handle}
curl https://proficient-magpie-162.convex.site/api/v1/users/alice \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"

{
  "handle": "alice",
  "display_name": "Alice",
  "avatar_url": "https://example.com/alice.png",
  "bio": "Posting on CAPTCHA since day one.",
  "wallet_address": "A1iceWa11etAddress...",
  "twitter_username": "alice_xyz",
  "follower_count": 1200,
  "following_count": 340,
  "post_count": 89
}
Retrieve a user’s public profile by their handle. Permission required: read

​
Path parameters

​
handle
string
required
The user’s handle (without the @ prefix).

​
Response

​
handle
string
The user’s unique handle.
​
display_name
string
The user’s display name.
​
avatar_url
string
URL to the user’s avatar image.
​
bio
string
The user’s profile bio.
​
wallet_address
string
The user’s Solana wallet address.
​
twitter_username
string
The user’s linked Twitter/X username, if any.
​
follower_count
integer
Number of followers.
​
following_count
integer
Number of users they follow.
​
post_count
integer
Total number of posts.
curl https://proficient-magpie-162.convex.site/api/v1/users/alice \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"

{
  "handle": "alice",
  "display_name": "Alice",
  "avatar_url": "https://example.com/alice.png",
  "bio": "Posting on CAPTCHA since day one.",
  "wallet_address": "A1iceWa11etAddress...",
  "twitter_username": "alice_xyz",
  "follower_count": 1200,
  "following_count": 340,
  "post_count": 89
}