List a user's organization affiliations

curl --request GET \
  --url https://teambattles.gg/api/v1/users/{identifier}/organizations \
  --header 'Authorization: Bearer <token>'

{
  "organizations": [
    {
      "id": "<string>",
      "name": "<string>",
      "role": "<string>",
      "joinedAt": "<string>",
      "slug": "<string>",
      "tag": "<string>",
      "avatarUrl": "<string>"
    }
  ],
  "count": 4503599627370495,
  "timestamp": "<string>"
}

Players

List a user's organization affiliations

Returns the target user’s active organization memberships, each as an API-safe organization summary plus the membership role and joinedAt. The identifier is a username or Convex user ID. Requires the users.profile:read scope. Readable only for public or limited profiles (or the API key owner’s own profile); a private profile returns 403, and an unknown or banned user returns 404. For anyone other than the profile owner, non-public organizations are omitted; the owner sees all of their memberships. Not paginated - the full set is returned with a count, in no guaranteed order (not sorted by name or joinedAt).

GET

users

{identifier}

organizations

List a user's organization affiliations

curl --request GET \
  --url https://teambattles.gg/api/v1/users/{identifier}/organizations \
  --header 'Authorization: Bearer <token>'

{
  "organizations": [
    {
      "id": "<string>",
      "name": "<string>",
      "role": "<string>",
      "joinedAt": "<string>",
      "slug": "<string>",
      "tag": "<string>",
      "avatarUrl": "<string>"
    }
  ],
  "count": 4503599627370495,
  "timestamp": "<string>"
}

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 organization affiliations.

Envelope containing organizations, count, and a response timestamp.

organizations

object[]

required

Show child attributes

count

integer

required

Required range: 0 <= x <= 9007199254740991

timestamp

string

required

ISO 8601 timestamp.

List public user connections Get user aggregate stats