---
title: "Validate user registered"
method: POST
path: "/api/v1/user/retail/validate"
tags: ["Onboarding/OffChain"]
---

# Validate user registered

`POST /api/v1/user/retail/validate`

## Request

- Base URL: `https://api-baas.wirexapp.com`
- URL: `https://api-baas.wirexapp.com/api/v1/user/retail/validate`
- Auth: API key in header `X-Chain-Id` and API key in header `Authorization` and API key in header `Identity`

Validates if the user identified by provided credentials exists in the system and returns basic information about the user if it exists. This endpoint is used in the onboarding process to determine if the user should be redirected to the login or registration page.

## Request body `*/*`

- RequestEmptyRequest

## Response `200`

OK

- ResponseUserValidateResponse
  - `users` ResponseUserDescriptor[]
    - `email` string, required
    - `id` string, required: Deprecated: still populated for backward compatibility, but consumers should read user_id — this field carries the user's UUID, which is now exposed as user_id.
    - `user_address` string: EOA of the user. Preferred field; wallet_address mirrors the same value for backward compatibility.
    - `user_id` string, required: UserId is the UUID identifier of the user. Preferred field; id mirrors the same value for backward compatibility.
    - `wallet_address` string: Deprecated: still populated for backward compatibility, but consumers should read user_address — this field carries the user's EOA, which is now exposed as user_address.

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

## Changes

- **2026-11-03** `760446c7ebd2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wirexapp/apis/wirex-baas-api/changes/api/v1/user/retail/validate/post.md)

---

[API](https://skmtc.dev/wirexapp/apis/wirex-baas-api.md) - [All operations](https://skmtc.dev/wirexapp/apis/wirex-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wirexapp/apis/wirex-baas-api/revisions/760446c7ebd2?raw)