---
title: "Retrieve IntegrationConfig for UUID"
method: GET
path: "/organizations/{orgId}/integrationconfigs/{id}"
tags: ["Integrations"]
---

# Retrieve IntegrationConfig for UUID

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

Retrieve the integration configuration for the given UUID.

This endpoint retrieves the configuration details of a specific integration within an organization. It is useful for obtaining the settings and parameters of an integration.

## Path parameters

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

## Response `200`

Returns the IntegrationConfig

- IntegrationRunResponse — Response containing a IntegrationRun 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.
  - `entityType` string, required — The type of entity the integration run is for. Two options: * Bill * Notification
  - `entityId` string, required — The unique identifier (UUID) of the entity the integration run is for.
  - `dtStarted` string, date-time — The date and time the integration run was started *(in ISO-8601 format)*.
  - `dtCompleted` string, date-time — The date and time the integration was completed. *(in ISO-8601 format)*.
  - `status` 'WAITING' | 'STARTED' | 'COMPLETE' | 'ERROR' | 'AWAITING_RETRY' | 'AUTH_FAILED' | 'ACCOUNTING_PERIOD_CLOSED' | 'INVOICE_ALREADY_PAID' | 'DISABLED' | 'TIMEOUT_LIMIT_EXCEEDED' | 'RATE_LIMIT_RETRY', required — Status of the integration
  - `destination` string, required — The destination system for the integration run.
  - `destinationId` string — Identifier of the destination
  - `error` string — Describes any errors encountered during the integration run.
  - `url` string — The URL of the entity in the destination system if available.
  - `externalId` string — The external ID in the destination system if available.
  - `parentIntegrationRunId` string — ID of the parent integration run, or null if this is a parent integration run

## Other responses

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

## Changes

- **2025-12-03** `ac93d1a9e6d9` — 2 info
  - added the optional property `allOf[subschema #3]/destinationId` to the response with the `200` status
  - added the optional property `allOf[subschema #3]/parentIntegrationRunId` to the response with the `200` status
- **2025-08-29** `0f92c877619f` — 1 warning
  - added the new `TIMEOUT_LIMIT_EXCEEDED` enum value to the `allOf[subschema #3]/status/allOf[#/components/schemas/RunStatus]/` response property for the response status `200`
- **2025-08-01** `9f9e5f3dbde7` — 2 breaking, 1 warning
  - the response property `allOf[#/components/schemas/AbstractResponseWithAuditFields]/allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
  - the response property `allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
  - added the new `RATE_LIMIT_RETRY` enum value to the `allOf[subschema #3]/status/allOf[#/components/schemas/RunStatus]/` response property for the response status `200`

[Change history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/integrationconfigs/:id/get.md)

---

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