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

# Retrieve External Mapping Configuration

`GET /organizations/{orgId}/externalmappingconfiguration`

Retrieve the global External Mapping configuration.

This endpoint retrieves the global External Mapping configuration for the specified Organization.

## Path parameters

- `orgId` string, required

## Response `200`

Returns External Mapping configuration

- ExternalMappingConfigurationResponse — Response containing permitted External Mapping configuration.
  - `m3terEntities` string[], required — An array of m3ter entity names. For example, this could include "Account".
  - `externalSystems` ExternalSystemResponse[], required — An array with the list of external systems.
    - `name` string, required — The name of the external system.
    - `tables` string[] — An array containing the list of external system tables permitted in mappings.
    - `allowCustomExternalTables` boolean

## 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/versions/ac93d1a9e6d9/schema)