---
title: "List VPC Endpoint connections for an AWS Privatelink Endpoint Service"
method: GET
path: "/project/{project}/service/{service_name}/privatelink/aws/connections"
tags: ["Service"]
---

# List VPC Endpoint connections for an AWS Privatelink Endpoint Service

`GET /project/{project}/service/{service_name}/privatelink/aws/connections`

## Request

- Base URL: `https://api.aiven.io/v1`
- URL: `https://api.aiven.io/v1/project/{project}/service/{service_name}/privatelink/aws/connections`
- Auth: HTTP bearer and OAuth 2
  - Authorization code: `https://console.aiven.io/oauth/authorize`
  - Token URL: `https://api.aiven.io/v1/oauth2/token` scopes: `privatelink:read`

## Path parameters

- `project` string, required
- `service_name` string, required

## Response `200`

Response

- ServicePrivatelinkAWSConnectionListResponse: ServicePrivatelinkAWSConnectionListResponse
  - `connections` object[], required: AWS Privatelink VPC Endpoint connection list
    - `dns_name` string, required: The VPC Endpoint DNS name that the Aiven privatelink access route DNS name is using as the value for itsCNAME record. This DNS name resolves to the private IP addresses of the VPC Endpoint's NICs in all configured subnets
    - `privatelink_connection_id` string: Privatelink connection ID
    - `state` 'pending-user-approval' | 'user-approved' | 'connected' | 'active', required: The Aiven connection state. The AWS VPC endpoint state is always available for listed connections
    - `vpc_endpoint_id` string, required: AWS VPC Endpoint ID
  - `errors` object[]: List of errors occurred during request processing
    - `message` string, required: Printable error message
    - `more_info` string: URL to the documentation of the error
    - `status` integer, required: HTTP error status code
  - `message` string: Printable result of the request

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) - [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/562453405db0?raw)