---
title: "Retrieve External Mapping"
method: GET
path: "/organizations/{orgId}/externalmappings/{id}"
tags: ["External Mapping"]
---

# Retrieve External Mapping

`GET /organizations/{orgId}/externalmappings/{id}`

Retrieve an External Mapping with the given UUID.

This endpoint enables you to retrieve the External Mapping with the specified UUID for a specific Organization.

## Path parameters

- `orgId` string, required
- `id` string, required

## Response `200`

Returns the External Mapping

- ExternalMappingResponse — Response containing an ExternalMapping entity
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `dtCreated` string, date-time — The DateTime when this item was created *(in ISO-8601 format)*.
  - `dtLastModified` string, date-time — The DateTime when this item was last modified *(in ISO-8601 format)*.
  - `createdBy` string — The ID of the user who created this item.
  - `lastModifiedBy` string — The ID of the user who last modified this item.
  - `m3terEntity` string, required — The name of the m3ter entity that is part of the External Mapping. For example, this could be "Account".
  - `m3terId` string, required — The unique identifier (UUID) of the m3ter entity.
  - `externalSystem` string, required — The name of the external system where the entity you are mapping resides.
  - `externalTable` string, required — The name of the table in the external system where the entity resides.
  - `externalId` string, required — The unique identifier (UUID) of the entity in the external system.
  - `integrationConfigId` string — UUID of the configuration this mapping is for

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)