---
title: "Find a user by social id"
method: GET
path: "/public/communities/{subdomain}/users"
tags: ["communityMember"]
---

# Find a user by social id

`GET /public/communities/{subdomain}/users`

## Request

- Base URL: `https://api-v2.zealy.io`
- URL: `https://api-v2.zealy.io/public/communities/{subdomain}/users`
- Auth: none declared. Required headers: `x-api-key`
- TypeScript: <https://skmtc.dev/zealy/apis/zealy-api/docs/public/communities/:subdomain/users/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `subdomain` string, required

## Query parameters

- `discordId` string
- `discordHandle` string
- `twitterUsername` string
- `twitterId` string
- `ethAddress` string
- `email` string
- `blockchainNetwork` 'eth-mainnet' | 'opt-mainnet' | 'arb-mainnet' | 'polygon-mainnet' | 'base-mainnet' | 'sol-mainnet' | 'bnb-mainnet' | 'linea-mainnet' | 'avalanche-mainnet' | 'fantom-mainnet' | 'cronos-mainnet' | 'palm-mainnet' | 'gnosis-mainnet' | 'chiliz-mainnet' | 'moonbeam-mainnet' | 'polygonzkevm-mainnet' | 'zksync-mainnet' | 'ton-mainnet'
- `blockchainAddress` string

## Headers

- `x-api-key` string, required

## Response `200`

200

- object
  - `discordHandle` string, nullable, required
  - `tiktokUsername` string, nullable, required
  - `twitterUsername` string, nullable, required
  - `verifiedBlockchainAddresses` object, nullable
  - `unVerifiedBlockchainAddresses` object, nullable
  - `connectedWallet` string, nullable, required
  - `email` string, nullable, required
  - `discordId` string, nullable, required
  - `twitterId` string, nullable, required
  - `id` string, required
  - `xp` number, required
  - `name` string, nullable, required
  - `createdAt` string, date-time, required
  - `rank` number, required
  - `invites` object[], required
    - `userId` string, required
    - `status` 'active' | 'pending' | 'consumed', required
    - `joinedAt` string, date-time, nullable, required
    - `xp` number, required
  - `role` 'admin' | 'editor' | 'banned' | 'guest' | 'reviewer', required
  - `level` number, required
  - `isBanned` boolean, required
  - `karma` number, required
  - `referrerUrl` string, nullable, required
  - `referrerId` string, nullable, required
  - `banReason` string, nullable, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/zealy/apis/zealy-api.md) - [All operations](https://skmtc.dev/zealy/apis/zealy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zealy/apis/zealy-api/revisions/1c24cb9f818b?raw)