---
title: "Retrieve a User"
method: GET
path: "/users/"
---

# Retrieve a User

`GET /users/`

Retrieve the profile of a user by searching with a single identifier. Each response returns a `users` array containing all matching profiles across platforms.

### Note: Individual use only

This endpoint is intended for retrieving individual user profiles only. Don't use it for bulk data retrieval, as it may interfere with normal data logging in AIQUA.

Use exactly one identifier parameter per request. Identifiers are case-sensitive; use lowercase for email addresses. To retrieve only specific profile fields, specify them using the `fields` parameter.

## Query parameters

- `user_id` string
- `userId` string
- `email` string
- `phoneNo` string
- `IDFA` string
- `AAID` string
- `fields` string

## Headers

- `appid` string, required
- `authorization` string, required

## Response `200`

Success

- object
  - `users` object[] — An array of matching user profiles. Empty if no users were found.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/appier/apis/retrieve-a-user.md) · [All operations](https://skmtc.net/appier/apis/retrieve-a-user/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appier/retrieve-a-user/versions/2885365fa9c9/schema)