> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Phone Connection By Name

> Retrieve a specific phone connection by its name within a product.

> [!WARNING]
>
> You are reading the docs of Galtea 5.16. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/phone-connection/get-by-name.md).

## Returns

Returns a [Phone Connection](https://docs.galtea.ai/v5.16/concepts/product/phone-connection.md) object for the given product and name.

## Example

```python theme={"system"}
phone_connection = galtea.phone_connections.get_by_name(
    name="production-voice-agent-" + run_identifier,
    product_id=product_id,
)
```

## Parameters

**name** `string` *required*

Name of the phone connection to retrieve.

**product\_id** `string` *required*

ID of the product the connection belongs to.

## Errors

| Error | Cause |
| - | - |
| `EntityNotFoundException` | The platform holds nothing under the id or name you passed. Import it with `from galtea import EntityNotFoundException`. Read the status from `e.status_code`. When the API answered 404 the SDK raises the subclass `EntityNotFoundHTTPError`, which also derives from `requests.HTTPError` and carries `e.response`, so code catching `requests.HTTPError` keeps working. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.