---
title: "Lookup Profiles"
method: POST
path: "/v1/Stores/{storeId}/Profiles/Lookup"
tags: ["Retrieval"]
---

# Lookup Profiles

`POST /v1/Stores/{storeId}/Profiles/Lookup`

Find profiles that contain a specific identifier value (for example a phone number or email address). Submit an identifier object specifying the `idType` and `value`. The value is normalized using the configured identity resolution settings (such as phone number formatting) prior to matching. Multiple matches are returned if more than one profile is associated with the identifier. Returns canonical profile IDs (the earliest ID if profiles have been merged) along with the normalized value actually searched.

## Request body

- Identifier — Represents a single identifier value paired with its `idType`. Write operations obey limits, uniqueness, and normalization rules configured via identifier settings.
  - `idType` string, required — Identifier type as configured in the service's Identity Resolution Settings.
  - `value` string, required — Raw value captured for the identifier. The service may normalize this value according to the `normalization` rule defined in the identifier settings before storage or matching (for example E.164 formatting for phone numbers).

## Response `200`

A list of profiles found.

- object
  - `normalizedValue` string — Identifier value after normalization that was used for the lookup.
  - `profiles` IdentityProfileID[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/twilio/apis/memory-v1.md) · [All operations](https://skmtc.net/twilio/apis/memory-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/memory-v1/versions/1cfcc8fb9f19/schema)