---
title: "Get user by wallet address"
method: GET
path: "/v1/users/wallet/{walletAddress}"
tags: ["users"]
---

# Get user by wallet address

`GET /v1/users/wallet/{walletAddress}`

Retrieve user details using their Ethereum wallet address

## Path parameters

- `walletAddress` string, required

## Response `200`

User details retrieved successfully

- object
  - `id` string, required — Unique identifier for the user
  - `walletAddress` string — Wallet address of the user
  - `avatarUrl` string, uri — URL to the user's avatar image
  - `publicationId` string, required — ID of the publication this user belongs to
  - `name` string — Display name of the user
  - `bio` string — Brief biography of the user (max 500 characters)

## Other responses

- `404` — User not found
- `500` — Internal server error

## Changes

- **2026-08-18** `36c72d74820a` — 1 warning
  - removed the optional property `farcaster` from the response with the `200` status
- **2026-05-07** `90de04b87133` — 2 warning
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `error` from the response with the `500` status
- **2025-09-09** `ad15e6a18644` — 1 info
  - added the optional property `farcaster` to the response with the `200` status

[Change history](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/users/wallet/:walletAddress/get.md)

---

[API](https://skmtc.dev/paragraph-xyz/apis/paragraph-api.md) · [All operations](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paragraph-xyz/paragraph-api/revisions/8108f2a53d2e/schema)