Telnyx Porting Out Go

---
name: telnyx-porting-out-go
description: >-
  Manage port-out requests when numbers are being ported away from Telnyx. List,
  view, and update port-out status. This skill provides Go SDK examples.
metadata:
  author: telnyx
  product: porting-out
  language: go
---

# Telnyx Porting Out - 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 portout requests

Returns the portout requests according to filters

`GET /portouts`

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

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

## Get a portout request

Returns the portout request based on the ID provided

`GET /portouts/{id}`

```go
portout, err := client.Portouts.Get(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", portout.Data)
```

## List all comments for a portout request

Returns a list of comments for a portout request.

`GET /portouts/{id}/comments`

```go
comments, err := client.Portouts.Comments.List(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", comments.Data)
```

## Create a comment on a portout request

Creates a comment on a portout request.

`POST /portouts/{id}/comments`

```go
comment, err := client.Portouts.Comments.New(
  context.TODO(),
  "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  telnyx.PortoutCommentNewParams{

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

## List supporting documents on a portout request

List every supporting documents for a portout request.

`GET /portouts/{id}/supporting_documents`

```go
supportingDocuments, err := client.Portouts.SupportingDocuments.List(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", supportingDocuments.Data)
```

## Create a list of supporting documents on a portout request

Creates a list of supporting documents on a portout request.

`POST /portouts/{id}/supporting_documents`

```go
supportingDocument, err := client.Portouts.SupportingDocuments.New(
  context.TODO(),
  "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  telnyx.PortoutSupportingDocumentNewParams{

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

## Update Status

Authorize or reject portout request

`PATCH /portouts/{id}/{status}` — Required: `reason`

```go
response, err := client.Portouts.UpdateStatus(
  context.TODO(),
  telnyx.PortoutUpdateStatusParamsStatusAuthorized,
  telnyx.PortoutUpdateStatusParams{
    ID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    Reason: "I do not recognize this transaction",
  },
)
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", response.Data)
```

## List all port-out events

Returns a list of all port-out events.

`GET /portouts/events`

```go
page, err := client.Portouts.Events.List(context.TODO(), telnyx.PortoutEventListParams{

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

## Show a port-out event

Show a specific port-out event.

`GET /portouts/events/{id}`

```go
event, err := client.Portouts.Events.Get(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", event.Data)
```

## Republish a port-out event

Republish a specific port-out event.

`POST /portouts/events/{id}/republish`

```go
err := client.Portouts.Events.Republish(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
```

## List eligible port-out rejection codes for a specific order

Given a port-out ID, list rejection codes that are eligible for that port-out

`GET /portouts/rejections/{portout_id}`

```go
response, err := client.Portouts.ListRejectionCodes(
  context.TODO(),
  "329d6658-8f93-405d-862f-648776e8afd7",
  telnyx.PortoutListRejectionCodesParams{

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

## List port-out related reports

List the reports generated about port-out operations.

`GET /portouts/reports`

```go
page, err := client.Portouts.Reports.List(context.TODO(), telnyx.PortoutReportListParams{

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

## Create a port-out related report

Generate reports about port-out operations.

`POST /portouts/reports`

```go
report, err := client.Portouts.Reports.New(context.TODO(), telnyx.PortoutReportNewParams{
  Params: telnyx.ExportPortoutsCsvReportParam{
    Filters: telnyx.ExportPortoutsCsvReportFiltersParam{

    },
  },
  ReportType: telnyx.PortoutReportNewParamsReportTypeExportPortoutsCsv,
})
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", report.Data)
```

## Retrieve a report

Retrieve a specific report generated.

`GET /portouts/reports/{id}`

```go
report, err := client.Portouts.Reports.Get(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
if err != nil {
  panic(err.Error())
}
fmt.Printf("%+v\n", report.Data)
```