---
title: "Retrieve a page of project connections, optionally filtered by parameters."
method: GET
path: "/v1/projects/{projectId}/connections"
tags: ["Connections"]
---

# Retrieve a page of project connections, optionally filtered by parameters.

`GET /v1/projects/{projectId}/connections`

## Path parameters

- `projectId` string, required

## Query parameters

- `authProvider` string[]
- `connectionNames` string[]
- `page` unknown
- `size` unknown

## Response `200`

Successfully retrieved connection

- ProjectConnectionResponse
  - `authProvider` string — The authentication provider
  - `authType` 'GENERIC_SECRET' | 'CLOUD_PROVIDER_SECRET' | 'OAUTH_USER_TOKENS' | 'OAUTH_AUTHORIZATION_CODE' | 'OAUTH_CLIENT_CRED' | 'COMPOSITE_TOKEN' | 'OAUTH_1_0_X_ADS' — The authentication type
  - `connectionDetails` ConnectionDetailsResponse
    - `connectionProperties` union — Connection properties as determined by the combination of platformConnectionType, authProvider and authType.
      - CloudPlatformCredentialsConnectionProperties — Connection properties for cloud platform credentials connections
        - `credentialSecretName` string — The name of the secret containing the cloud platform credentials
      - ComponentBasicConnectionProperties — Connection properties for component basic connections
        - `secretKey` string — Optional key within the secret
        - `secretName` string, required — The name of the secret
    - `description` string — Optional description of the connection
    - `secretsLocation` union — Vault location for secrets. Allows you to specify the type of vault such as AWS, Azure, GCP, or Snowflake, and any supplementary properties such as region (AWS), vaultName (Azure, Snowflake), or gcpProjectId (GCP). Optional for empty project connections that rely solely on environment overrides.
      - AwsVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `region` string
      - AzureVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `vaultName` string
      - DefaultVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
      - GcpVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `gcpProjectId` string
      - MatillionHostedVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
  - `createdBy` string — The user who created the connection
  - `createdDate` string, date-time — The date and time when the connection was created
  - `name` string — The name of the connection
  - `platformConnectionType` 'COMPONENT_BASIC' | 'CLOUD_PLATFORM_CREDENTIALS' — The different types of connection that can be created: - `COMPONENT_BASIC` — connect a component to a data source, API, or SaaS application using a secret stored in your secrets manager. - `CLOUD_PLATFORM_CREDENTIALS` — give a project access to a cloud provider (AWS, Azure, GCP) using cloud credentials stored in your secrets manager.
  - `projectId` string, uuid — The project ID this connection belongs to

## Other responses

- `400` — Invalid request parameters. This can occur when specifying too many connection names or when the total URL length exceeds server limits. Consider reducing the number of connections in a single request or splitting into multiple requests.
- `403` — Forbidden
- `404` — Connection not found

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)