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

# Parse SIP Destination

> Parse and validate a raw SIP destination string into its host, port, user, and transport before attaching it to a trunk.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body

**input** `string` *required*

The SIP destination to parse. Accepts flexible formats — a hostname or IP (`sip.provider.com`, `203.0.113.10`), a full SIP URI (`sip:user@host:5061;transport=tls`), or shorthand (`tls://host`, `host:5061`).

### Response

**valid** `boolean`

Whether the input could be parsed into a usable SIP destination.

**parsed** `object`

The parsed destination when `valid` is `true`, otherwise `null`.

**parsed**

**host** `string`

The resolved host or IP address.

**port** `number`

The port, when present in the input.

**user** `string`

The user part of the SIP URI, when present.

**transport** `string`

The transport: `"udp"`, `"tcp"`, or `"tls"`, when present.

**is\_private\_ip** `boolean`

`true` if the host is a private/non-routable IP address.

**normalized** `string`

The normalized SIP destination string.

Use the parsed `host`, `port`, and `transport` to populate the `sip_endpoint` and `options` of a trunk or a [`POST /v1/sip/attach`](https://docs.bland.ai/api-v1/post/sip-attach) request.

```json Example Request theme={null}
curl -X POST https://api.bland.ai/v1/sip/parse-destination \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "sip:your.provider.com:5061;transport=tls"
  }'
```

```json Response theme={null}
{
  "data": {
    "valid": true,
    "parsed": {
      "host": "your.provider.com",
      "port": 5061,
      "transport": "tls",
      "is_private_ip": false,
      "normalized": "sip:your.provider.com:5061;transport=tls"
    }
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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