---
title: "Get a relative identity definition from the mdm"
method: GET
path: "/mdm/v1/relative-identity-collections/{relativeIdentityCollectionKey}"
tags: ["RelativeIdentity"]
---

# Get a relative identity definition from the mdm

`GET /mdm/v1/relative-identity-collections/{relativeIdentityCollectionKey}`

Get a relative identity definition from the mdm.

## Path parameters

- `relativeIdentityCollectionKey` string, required

## Response `200`

The relative identity definition.

- V1RelativeIdentityDefinition
  - `key` string, required — Key of the relative identity definition it must follow pattern: `^[a-zA-Z0-9-][\w-]{0,61}$`.
  - `status` 'ACTIVE' | 'ARCHIVED'
  - `config` V1RelativeIdentityDefinitionConfig, required
    - `type` 'SEQUENCE', required
    - `offset` integer, required
  - `differentiators` object, required — This is used to configure one or many differentiators properties for a unified collection. The key is the unified collection key and value is the differentiator properties.

## Other responses

- `404` — Returned when the relative identity definition does not exist.

---

[API](https://skmtc.dev/clinia/apis/mdm-api.md) · [All operations](https://skmtc.dev/clinia/apis/mdm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clinia/mdm-api/revisions/0ea93fa84bac/schema)