Skip to main content
GET
/
users
/
{identifier}
Get a public user profile
curl --request GET \
  --url https://teambattles.gg/api/v1/users/{identifier} \
  --header 'Authorization: Bearer <token>'
{
  "user": {
    "id": "<string>",
    "username": "<string>",
    "name": "<string>",
    "avatarUrl": "<string>",
    "createdAt": "<string>",
    "bannerUrl": "<string>",
    "isVerified": true,
    "bio": "<string>"
  },
  "timestamp": "<string>"
}

​
Permission Required

This endpoint and its child resources require the users.profile permission on your API key.
  • GET /users/{identifier}/stats
  • GET /users/{identifier}/trophies
  • GET /users/{identifier}/connections
  • GET /users/{identifier}/teams
  • GET /users/{identifier}/organizations
Private profiles return the base profile envelope only. Child resources return error_forbidden unless the API key owner is reading their own profile.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
identifier
string
required

Username or Convex user ID.

Response

User profile.

Envelope containing user plus a response timestamp.

​
user
object
required

API-safe public user profile.

​
timestamp
string
required

ISO 8601 timestamp.