---
title: "Get Customer Integration"
method: GET
path: "/v1/integrate/clouds/{integrationId}"
tags: ["IoT Integrator"]
---

# Get Customer Integration

`GET /v1/integrate/clouds/{integrationId}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/clouds/{integrationId}`
- Auth: HTTP bearer

Get Customer Integration details

## Path parameters

- `integrationId` string, required

## Response `200`

Customer Integration Details.

- GetResponseschema12: Get Integration response
  - `id` string, required: Unique ID of the Integration
  - `lastSuccessfulMessageDelivery` string, date-time: Timestamp of the first message successfully delivered to integration, in ISO 8601 format
  - `name` string, required: name
  - `eventTypes` PostResponseschema5EventTypesInner[], required: A list of event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string, required: Version of the event type
  - `state` 'ROLLOUT_STARTED' | 'ROLLOUT_DONE' | 'ROLLOUT_FAILED' | 'INTEGRATION_FAILED' | 'INTEGRATION_ACTIVE', required: Current state of the Integration
  - `type` 'AWS' | 'WEBHOOK', required: Type of the Integration
  - `awsAccountId` string: AWS Account Id where the stack was deployed, only showed when AWS Integration
  - `region` string: AWS Region where the stack was deployed, only showed when AWS Integration
  - `error` string: Last error either during the creation of the Integration or during some attempt to integrate
  - `jwt` string: JWT token with details for integration stack creation
  - `createdTime` string, date-time, required: Created timestamp of Integration
  - `updatedTime` string, date-time, required: Updated timestamp of Integration
  - `url` string, uri: URL of the Webhook Integration
  - `headers` object: Headers of the Webhook Integration
  - `jsonPayloadEnabled` boolean, required: Flag if the payloads of this integration should be bridged in JSON format.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)
