---
title: "POST /networks/{networkId}/users/uname-lookup"
method: POST
path: "/networks/{networkId}/users/uname-lookup"
---

# POST /networks/{networkId}/users/uname-lookup

`POST /networks/{networkId}/users/uname-lookup`

Looks up multiple user usernames from their unique username hashes (unames). This operation allows you to retrieve the email addresses associated with a list of username hashes.

## Path parameters

- `networkId` string, required

## Headers

- `X-Client-Token` string

## Request body

- object
  - `unames` GenericString[], required — A list of username hashes (unames) to look up. Each uname is a unique identifier for a user's username. Maximum 50 unames per batch request.

## Response `200`

Success

- BatchLookupUserUnameResponse
  - `message` string — A message indicating the overall result of the batch lookup operation.
  - `successful` BatchUnameSuccessResponseItem[] — A list of successfully resolved username hashes with their corresponding email addresses.
    - `uname` string, required — The username hash that was successfully resolved.
    - `username` string, required — The email address or username corresponding to the username hash.
  - `failed` BatchUnameErrorResponseItem[] — A list of username hash lookup attempts that failed, including error details explaining why each lookup failed.
    - `field` string — The field that caused the error.
    - `reason` string — A description of why the username hash lookup failed.
    - `uname` string, required — The username hash that failed to be looked up.

## Other responses

- `480` — ValidationError
- `481` — BadRequestError
- `482` — ResourceNotFoundError
- `483` — ForbiddenError
- `484` — UnauthorizedError
- `485` — InternalServerError
- `486` — RateLimitError

---

[API](https://skmtc.net/aws/apis/wickr.md) · [All operations](https://skmtc.net/aws/apis/wickr/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/wickr/versions/71d396c2af63/schema)