# List SIP outbound trunks

> GET https://api.nabrah.ai/api/ext/sip-outbound

Group: SIP outbound. Page: https://www.nabrah.ai/en/docs/api-reference/sip-outbound/list-sip-outbound-trunks

Lists every outbound SIP trunk configured for the project that owns your API key. Outbound trunks let Nabrah agents place calls out through your own SIP provider using stored trunk credentials. Each item includes the trunk's id (use it as the path parameter for the single-trunk GET/DELETE endpoints), its display name, and the associated phone number(s) used as caller identity. Authenticate with the `X-API-Key` header; the project is inferred from the key, so no project_id is required.

## What outbound trunks do

Outbound trunks let agents dial out.

- **Direction**: Outbound means Nabrah originates calls. An agent places a call that egresses through your SIP provider over this trunk. This is the inverse of inbound trunks, which receive calls into an agent.
- **Summary listing**: The list response is intentionally compact, returning only `id`, `name`, and `numbers` per trunk. Fetch a single trunk for the full record including the provider address, channel limit, and credentials.

To retrieve one trunk on its own, call GET /api/ext/sip-outbound/{sip_id} with an `id` value taken from this list.

## Authorization

- `X-API-Key` (string, header, required): your workspace API key.

## Response

### 200 Successful Response

Content type: `application/json`

```json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "numbers": "string"
    }
  ]
}
```

## Request examples

### cURL

```bash
curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/sip-outbound' \
  --header 'X-API-Key: <your-api-key>'
```

### Python

```python
import requests

url = "https://api.nabrah.ai/api/ext/sip-outbound"
headers = {"X-API-Key": "<your-api-key>"}

response = requests.get(url, headers=headers)
response.raise_for_status()
print(response.json())
```

### JavaScript

```javascript
const response = await fetch("https://api.nabrah.ai/api/ext/sip-outbound", {
  method: "GET",
  headers: { "X-API-Key": "<your-api-key>" },
});

const data = await response.json();
console.log(data);
```

### Go

```go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.nabrah.ai/api/ext/sip-outbound", nil)
	req.Header.Set("X-API-Key", "<your-api-key>")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}
```