---
title: "List private services [READ]"
method: GET
path: "/v2/network/private-service/{namespace}"
tags: ["Private Services"]
---

# List private services [READ]

`GET /v2/network/private-service/{namespace}`

## Path parameters

- `namespace` string, required

## Query parameters

- `account-id` string
- `shared` boolean

## Response `200`

Private Services listed successfully

- PrivateServiceWithStatusList — Collection of AWS PrivateLink services
  - `items` PrivateServiceWithStatus[], required
    - `createdAt` string, date-time, required — When the service was created
    - `endpointName` string, nullable — Associated endpoint name (if linked to an endpoint)
    - `id` string, required
    - `privateService` EndpointPrivateService, required — AWS PrivateLink configuration for VPC-connected endpoints
      - `accountId` string, required — AWS account ID allowed to connect via PrivateLink
      - `shared` boolean — Share the PrivateLink service across all endpoints for this owner (reduces costs)
    - `status` EndpointPrivateServiceStatus, required — AWS PrivateLink service status
      - `lb_ips` string[], required — Load balancer IP addresses for VPC endpoint connection
      - `region` string, required
      - `service_name` string, nullable — AWS VPC endpoint service name (available when ready)
      - `stage` 'LbNotCreated' | 'LbNotReady' | 'ServiceNotConfigured' | 'WaitingForClientConnection' | 'Created' | 'Deleting' | 'Deleted', required

---

[API](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api.md) · [All operations](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hf-inference-endpoints-api/versions/52e3f4cdbf86/schema)