# Get SIP outbound trunk

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

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

Retrieves a single outbound SIP trunk by its id from the project tied to your API key. Returns the full configuration: display name, caller number(s), the provider SIP address, the maximum concurrent channel limit, and the stored SIP digest credentials. Use this to inspect one outbound trunk's settings rather than listing all of them. Authenticate with the `X-API-Key` header.

## Scope

Only trunks belonging to the project that owns your API key are accessible.

## Authorization

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

## Path parameters

- `sip_id` (string, required): The unique identifier of the outbound SIP trunk to retrieve. Obtain it from the `id` field of GET /api/ext/sip-outbound (list).

## Response

### 200 Successful Response

Content type: `application/json`

```json
{
  "name": "string",
  "numbers": "string",
  "address": "string",
  "max_channels": 0,
  "id": "00000000-0000-4000-8000-000000000000",
  "created_by": "00000000-0000-4000-8000-000000000000",
  "project_id": "00000000-0000-4000-8000-000000000000",
  "auth_username": "string",
  "auth_password": "string",
  "created_by_email": "string"
}
```

### 422 Validation Error

Content type: `application/json`

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```

## Request examples

### cURL

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

### Python

```python
import requests

url = "https://api.nabrah.ai/api/ext/sip-outbound/<sip_id>"
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/<sip_id>", {
  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/<sip_id>", 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))
}
```