---
title: "List storage integrations for an organization"
method: GET
path: "/v2/organizations/settings/storageIntegrations"
tags: ["Organizations"]
---

# List storage integrations for an organization

`GET /v2/organizations/settings/storageIntegrations`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/organizations/settings/storageIntegrations`
- Auth: HTTP bearer

Get the external storage integrations configured for an organization. 
### Usage notes
- To perform this operation, you must use API credentials owned by a user assigned the Admin account type.
- To read or update storage integrations for a tenant organization, use [impersonation](/docs/impersonate-users) to obtain a token for that tenant, then call this endpoint with that token.
- The response includes at most one storage integration: the one configured for the organization.

## Response `200`

The response body.

- OrganizationsListStorageIntegrationsResponse200
  - `entries` V2OrganizationsSettingsStorageIntegrationsGetResponsesContentApplicationJsonSchemaEntriesItems[], required: Storage integrations configured for the organization.
    - `provider` 's3' | 'gcs' | 'azure', required: Cloud storage provider for the storage integration.
    - `storageIntegrationId` string, required: Unique identifier of the storage integration.
    - `allowedLocation` string, required: Cloud storage URI Sigma writes to for the storage integration.
    - `name` string: Display name of the storage integration.
    - `kmsKeyName` string: KMS key Sigma uses to encrypt objects written to the bucket. Relevant only when `provider` is `s3`.
    - `storageAwsRoleArn` string: AWS IAM role ARN Sigma assumes to access the bucket. Relevant only when `provider` is `s3`.
    - `externalId` string: External ID Sigma includes in the AWS role trust policy request. Relevant only when `provider` is `s3`.
    - `tenantId` string: Azure AD tenant ID that owns the storage account. Relevant only when `provider` is `azure`.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)