---
title: "Retrieve a Data Mapping"
method: GET
path: "/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}"
tags: ["DataMapping"]
---

# Retrieve a Data Mapping

`GET /v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}`

Retrieve the details of a specific data mapping by its unique ID.

## Response `200`

Data mapping details retrieved successfully.

- DataMapping
  - `displayName` string, required — Name of the data mapping.
  - `description` string — A human readable description of this resource, up to 512 characters.
  - `isEnabled` boolean — Flag indicating whether the data mapping is active. When true, data will be ingested and mapped according to the configuration. When false, the data mapping will be inactive and no data will be ingested into the Memory Store.
  - `mappingTo` DataMappingToTypes, required — Configuration for mapping data to traits in a Memory Store.
    - `type` 'TRAITS', required — The destination data type, which determines where to write the data and the required configuration parameters.
    - `mappings` MappingTraitItem[], required — The list of field to trait mappings.
      - `expression` string, required — The expression identifying the field/column in the source.
      - `traitGroup` string, required — The name of the Trait Group to map to.
      - `traitName` string, required — The name of the trait within the Trait Group to map to.
  - `mappingFrom` union, required — Details of where to map data items from. Each data mapping from type has its own set of configuration parameters and source specific properties.
    - object — Configuration for mapping from ingress column names provided directly in the request.
      - `type` 'INGRESS', required — The source data type, which determines the source of the data and the required configuration parameters.
      - `columns` string[], required — The list of ingress column names that serve as the source fields.
    - object — Configuration for mapping from a TDI dataset backed by a cloud app (CRM) source.
      - `type` 'DATASET_CLOUDAPP', required — The source data type, which determines the source of the data and the required configuration parameters.
      - `datasetId` string, required — The unique identifier of the TDI dataset to connect.
    - object — Configuration for mapping from a TDI dataset backed by a warehouse source.
      - `type` 'DATASET_WAREHOUSE', required — The source data type, which determines the source of the data and the required configuration parameters.
      - `datasetId` string, required — The unique identifier of the TDI dataset to connect.
  - `id` string, required — The unique identifier for the data mapping.
  - `createdAt` string, date-time, required — The ISO 8601 timestamp when the data mapping was created.
  - `updatedAt` string, date-time, required — The ISO 8601 timestamp when the data mapping was last updated.
  - `version` integer, required — The current version number of the DataMapping. 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-25** (v1) `49499262215f` — 2 info
  - removed `CSV, DATASET` discriminator mapping keys from the `mappingFrom` response property for the response status `200`
  - removed `#/components/schemas/DataMappingFromCSV, #/components/schemas/DataMappingFromDataSet` from the `mappingFrom` response property `oneOf` list for the response status `200`
- **2026-08-13** (v1) `5fb6167593e7` — 1 breaking, 1 info
  - added `#/components/schemas/DataMappingFromIngress, #/components/schemas/DataMappingFromCloudAppDataSet, #/components/schemas/DataMappingFromWarehouseDataSet` to the `mappingFrom` response property `oneOf` list for the response status `200`
  - added `INGRESS, DATASET_CLOUDAPP, DATASET_WAREHOUSE` discriminator mapping keys to the `mappingFrom` response property for the response status `200`
- **2026-08-11** (v1) `b0ed05460bbf` — 7 breaking, 3 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`
  - …6 more

[Change history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/ControlPlane/Stores/:storeId/DataMappings/:dataMappingId/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)