Skip to main content
GET
/
v1
/
user
/
lookup
Lookup user
curl --request GET \
  --url https://relay.bayse.markets/v1/user/lookup
{
  "id": "68eea9d8-a0fe-4534-ae88-b71e2f4f5c8f",
  "tag": "mulumba",
  "imageUrl": "https://cdn.bayse.markets/profile-images/mulumba.jpg"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bayse.markets/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Look up a user by their tag (username) or user ID to get their public profile info. Provide either tag or userId, not both.
Requires read authentication. Include your X-Public-Key header.

​
Query parameters

​
tag
string
The user’s tag (username). Case-insensitive.
​
userId
string
The user’s ID (UUID).

​
Example request

curl https://relay.bayse.markets/v1/user/lookup?tag=mulumba \
  -H "X-Public-Key: YOUR_PUBLIC_KEY"

​
Response

​
id
string
The user’s unique ID (UUID).
​
tag
string
The user’s tag (username).
​
imageUrl
string
URL of the user’s profile image. May be empty if no image is set.
{
  "id": "68eea9d8-a0fe-4534-ae88-b71e2f4f5c8f",
  "tag": "mulumba",
  "imageUrl": "https://cdn.bayse.markets/profile-images/mulumba.jpg"
}

​
Errors

StatusDescription
400Neither tag nor userId provided, or both provided.
401Missing or invalid API key.
404No user found with the given tag or ID.