Telnyx Account Go

---
name: telnyx-account-go
description: >-
  Manage account balance, payments, invoices, webhooks, and view audit logs and
  detail records. This skill provides Go SDK examples.
metadata:
  author: telnyx
  product: account
  language: go
---

# Telnyx Account - Go

## Installation

```bash
go get github.com/team-telnyx/telnyx-go
```

## Setup

```go
import (
  "context"
  "fmt"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)
```

All examples below assume `client` is already initialized as shown above.

## List Audit Logs

Retrieve a list of audit log entries.

`GET /audit_events`

```go
page, err := client.AuditEvents.List(context.TODO(), telnyx.AuditEventListParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", page)
```

## Get user balance details

`GET /balance`

```go
balance, err := client.Balance.Get(context.TODO())
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", balance.Data)
```

## Search detail records

Search for any detail record across the Telnyx Platform

`GET /detail_records`

```go
page, err := client.DetailRecords.List(context.TODO(), telnyx.DetailRecordListParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", page)
```

## List invoices

Retrieve a paginated list of invoices.

`GET /invoices`

```go
page, err := client.Invoices.List(context.TODO(), telnyx.InvoiceListParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", page)
```

## Get invoice by ID

Retrieve a single invoice by its unique identifier.

`GET /invoices/{id}`

```go
invoice, err := client.Invoices.Get(
  context.TODO(),
  "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  telnyx.InvoiceGetParams{

  },
)
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", invoice.Data)
```

## List auto recharge preferences

Returns the payment auto recharge preferences.

`GET /payments/auto_recharge_prefs`

```go
autoRechargePrefs, err := client.Payment.AutoRechargePrefs.List(context.TODO())
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", autoRechargePrefs.Data)
```

## Update auto recharge preferences

Update payment auto recharge preferences.

`PATCH /payments/auto_recharge_prefs`

```go
autoRechargePref, err := client.Payment.AutoRechargePrefs.Update(context.TODO(), telnyx.PaymentAutoRechargePrefUpdateParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", autoRechargePref.Data)
```

## List User Tags

List all user tags.

`GET /user_tags`

```go
userTags, err := client.UserTags.List(context.TODO(), telnyx.UserTagListParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", userTags.Data)
```

## List webhook deliveries

Lists webhook_deliveries for the authenticated user

`GET /webhook_deliveries`

```go
page, err := client.WebhookDeliveries.List(context.TODO(), telnyx.WebhookDeliveryListParams{

})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", page)
```

## Find webhook_delivery details by ID

Provides webhook_delivery debug data, such as timestamps, delivery status and attempts.

`GET /webhook_deliveries/{id}`

```go
webhookDelivery, err := client.WebhookDeliveries.Get(context.TODO(), "C9C0797E-901D-4349-A33C-C2C8F31A92C2")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", webhookDelivery.Data)
```