---
title: "Get IntegrationRun for the UUID"
method: GET
path: "/organizations/{orgId}/integrationruns/{id}"
tags: ["Integrations"]
---

# Get IntegrationRun for the UUID

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

Retrieve the integration run for the id

## Path parameters

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

## Response `200`

Return the IntegrationRun

- 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

---

[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)