---
title: "Retrieve Identity Resolution Settings."
method: GET
path: "/v1/ControlPlane/Stores/{storeId}/IdentityResolutionSettings"
tags: ["IdentityResolutionSettings"]
---

# Retrieve Identity Resolution Settings.

`GET /v1/ControlPlane/Stores/{storeId}/IdentityResolutionSettings`

These settings determine how Customer Memory will use identifiers for searching, merging, and resolving profiles. 
> Some settings can only take on their default values and are not yet available to change, but coming soon.

## Response `200`

Identity resolution settings retrieved successfully

- IdentityResolutionSettings
  - `identifierConfigs` IdentifierConfig[], required — List of identifier types and their resolution settings.
    - `idType` string, required — Name of the identifier type. Usual values are email, phone, external_id etc.
    - `matchingAlgo` 'exact' | 'fuzzy' — The algorithm to use for matching identifier values. - `exact`, exact string match. - `fuzzy`, low precision match allowing for some variations.
    - `matchingThreshold` integer — The `fuzzy` matching threshold percentage.
    - `limit` integer — Maximum number of historical values to retain.
    - `limitPolicy` 'fifo' | 'lifo' — Removal policy to apply when the number of values exceeds the limit and is based on the timestamp of the request when the identifier was added. - `fifo`: First In First Out, removes the oldest values first. - `lifo`: Last In First Out, removes the most recent values first.
    - `enforceUnique` boolean — When enabled, more than one profile may not share the same identifier value. Adding a shared identifier to a second profile may trigger a merge. Disabling creates a compound identifier where merges are only triggered if two or more identifiers satisfy a matching rule.
    - `normalization` 'phone' | 'email' | 'trim' | 'none' — Normalization to apply to the identifier value before storing and matching. - `phone`: Normalize phone numbers to E.164 format. - `email`: Normalize email addresses by coverting to lowercase and removing spaces. - `trim`: Removes spaces from both ends of the string. - `none`: No normalization. **Important Note for Phone Number Normalization:** When using the `phone` normalization option, please adhere to the following guidelines to ensure proper formatting: - All US numbers must be at least valid 10 digit phone numbers with area code. They may also include or omit the "+1" prefix. - Non-US numbers must include a 1-3 digit country code (a "+" prefix is optional). Non-US national formats are not supported and will be interpreted as US numbers.
  - `matchingRules` string[], required — Priority list of identifiers to locate profiles to apply new data to, or for determining if two existing profiles should merge. Individual rules are evaluated with `OR` logic between them, meaning that satisfying any single rule will trigger a match. Each rule is a single identifier type; compound rules are not supported. Rules are evaluated in order. - If no rule matches against existing profiles, a new profile will be created. - If a rule matches to a single existing profile, the profile will be updated. - If a rule matches to multiple existing profiles, those existing profiles will be merged.
  - `version` integer, required — The current version number of the Identity Resolution Settings. Incremented on each successful update.

## Other responses

- `400` — Bad Request
- `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

## Changes

> 8 revisions in range; 1 not diffed.

- **2026-08-11** (v1) `b0ed05460bbf` — 5 breaking, 2 info
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `400`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `404`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `429`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `500`
  - …3 more

[Change history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/ControlPlane/Stores/:storeId/IdentityResolutionSettings/get.md)

---

[API](https://skmtc.dev/twilio/apis/memory-v1.md) · [All operations](https://skmtc.dev/twilio/apis/memory-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/memory-v1/revisions/14b76936cfa3/schema)