# Cloud provider integration endpoints

## List integrations

**Endpoint:** `get/beta/v1/org/{org_id}/integrations`

Returns all active cloud provider integrations for the organization.

### Path parameters
- `org_id`: string · uuid **Required**

### Responses

- **200 OK**
  - **Content-Type:** application/json  
  - **Response body:**  
    - `id`: string **Optional** — Integration identifier  
    - `provider`: string · enum **Optional** — Cloud provider (aws, azure, gcp)  
        - Possible values: `aws`, `azure`, `gcp`  
    - `name`: string · nullable **Optional** — Integration name  
    - `provider_organization_id`: string · nullable **Optional** — Cloud-provider organization/tenant identifier (AWS Organizations ID, Azure tenant ID, GCP organization ID).  
    - `active`: boolean **Optional** — Whether this integration has active credentials  
    - `currency`: string · nullable **Optional** — Billing currency (e.g. 'USD')  
    - `data_available_since`: string · date-time · nullable **Optional** — Earliest date cost data is available from this integration  
    - `data_available_until`: string · date-time · nullable **Optional** — Latest date cost data is available from this integration

- **400 Bad request**
- **401 Unauthorized**
- **403 Forbidden**
- **404 Not found**
- **405 Method not allowed**
- **409 Conflict**
- **500 Internal server error**
- **default** Default error response

### Example request

```
GET /beta/v1/org/{org_id}/integrations HTTP/1.1
Accept: */*
```

### Example response

```
[
  {
    "id": "text",
    "provider": "aws",
    "name": "text",
    "provider_organization_id": "text",
    "active": true,
    "currency": "text",
    "data_available_since": "2026-07-27T19:48:09.546Z",
    "data_available_until": "2026-07-27T19:48:09.546Z"
  }
]
```

## Get integration details

**Endpoint:** `get/beta/v1/org/{org_id}/integrations/{integration_id}`

Returns details for a single integration including its cloud accounts.

### Path parameters
- `org_id`: string · uuid **Required**  
- `integration_id`: string · uuid **Required**

### Responses

### Example request

```
GET /beta/v1/org/{org_id}/integrations/{integration_id} HTTP/1.1
Accept: */*
```

### Example response

```
{
  "id": "text",
  "provider": "aws",
  "name": "text",
  "provider_organization_id": "text",
  "active": true,
  "currency": "text",
  "data_available_since": "2026-07-27T19:48:09.546Z",
  "data_available_until": "2026-07-27T19:48:09.546Z",
  "accounts": null
}
```