# Telnyx Account Reports Go > >- - **Type:** Skill - **Install:** `agentstack add skill-team-telnyx-ai-telnyx-account-reports-go` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [team-telnyx](https://agentstack.voostack.com/s/team-telnyx) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [team-telnyx](https://github.com/team-telnyx) - **Source:** https://github.com/team-telnyx/ai/tree/main/providers/claude/plugin/skills/telnyx-account-reports-go ## Install ```sh agentstack add skill-team-telnyx-ai-telnyx-account-reports-go ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Telnyx Account Reports - Go ## Installation ```bash go get github.com/team-telnyx/telnyx-go ``` ## Setup ```go import ( "context" "fmt" "os" "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. ## Error Handling All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code: ```go import "errors" result, err := client.Messages.Send(ctx, params) if err != nil { var apiErr *telnyx.Error if errors.As(err, &apiErr) { switch apiErr.StatusCode { case 422: fmt.Println("Validation error — check required fields and formats") case 429: // Rate limited — wait and retry with exponential backoff fmt.Println("Rate limited, retrying...") default: fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error()) } } else { fmt.Println("Network error — check connectivity and retry") } } ``` Common error codes: `401` invalid API key, `403` insufficient permissions, `404` resource not found, `422` validation error (check field formats), `429` rate limited (retry with exponential backoff). ## Important Notes - **Pagination:** Use `ListAutoPaging()` for automatic iteration: `iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }`. ## List call events Filters call events by given filter parameters. Events are ordered by `occurred_at`. If filter for `leg_id` or `application_session_id` is not present, it only filters events from the last 24 hours. `GET /call_events` ```go page, err := client.CallEvents.List(context.Background(), telnyx.CallEventListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page) ``` Returns: `call_leg_id` (string), `call_session_id` (string), `event_timestamp` (string), `metadata` (object), `name` (string), `record_type` (enum: call_event), `type` (enum: command, webhook) ## Create a ledger billing group report `POST /ledger_billing_group_reports` Optional: `month` (integer), `year` (integer) ```go ledgerBillingGroupReport, err := client.LedgerBillingGroupReports.New(context.Background(), telnyx.LedgerBillingGroupReportNewParams{ Month: telnyx.Int(10), Year: telnyx.Int(2019), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", ledgerBillingGroupReport.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `organization_id` (uuid), `record_type` (enum: ledger_billing_group_report), `report_url` (uri), `status` (enum: pending, complete, failed, deleted), `updated_at` (date-time) ## Get a ledger billing group report `GET /ledger_billing_group_reports/{id}` ```go ledgerBillingGroupReport, err := client.LedgerBillingGroupReports.Get(context.Background(), "f5586561-8ff0-4291-a0ac-84fe544797bd") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", ledgerBillingGroupReport.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `organization_id` (uuid), `record_type` (enum: ledger_billing_group_report), `report_url` (uri), `status` (enum: pending, complete, failed, deleted), `updated_at` (date-time) ## Get all MDR detailed report requests Retrieves all MDR detailed report requests for the authenticated user `GET /legacy/reporting/batch_detail_records/messaging` ```go messagings, err := client.Legacy.Reporting.BatchDetailRecords.Messaging.List(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messagings.Data) ``` Returns: `connections` (array[integer]), `created_at` (date-time), `directions` (array[string]), `end_date` (date-time), `filters` (array[object]), `id` (uuid), `profiles` (array[string]), `record_type` (string), `record_types` (array[string]), `report_name` (string), `report_url` (string), `start_date` (date-time), `status` (enum: PENDING, COMPLETE, FAILED, EXPIRED), `updated_at` (date-time) ## Create a new MDR detailed report request Creates a new MDR detailed report request with the specified filters `POST /legacy/reporting/batch_detail_records/messaging` — Required: `start_time`, `end_time` Optional: `connections` (array[integer]), `directions` (array[integer]), `filters` (array[object]), `include_message_body` (boolean), `managed_accounts` (array[string]), `profiles` (array[string]), `record_types` (array[integer]), `report_name` (string), `select_all_managed_accounts` (boolean), `timezone` (string) ```go messaging, err := client.Legacy.Reporting.BatchDetailRecords.Messaging.New(context.Background(), telnyx.LegacyReportingBatchDetailRecordMessagingNewParams{ EndTime: time.Now(), StartTime: time.Now(), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `connections` (array[integer]), `created_at` (date-time), `directions` (array[string]), `end_date` (date-time), `filters` (array[object]), `id` (uuid), `profiles` (array[string]), `record_type` (string), `record_types` (array[string]), `report_name` (string), `report_url` (string), `start_date` (date-time), `status` (enum: PENDING, COMPLETE, FAILED, EXPIRED), `updated_at` (date-time) ## Get a specific MDR detailed report request Retrieves a specific MDR detailed report request by ID `GET /legacy/reporting/batch_detail_records/messaging/{id}` ```go messaging, err := client.Legacy.Reporting.BatchDetailRecords.Messaging.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `connections` (array[integer]), `created_at` (date-time), `directions` (array[string]), `end_date` (date-time), `filters` (array[object]), `id` (uuid), `profiles` (array[string]), `record_type` (string), `record_types` (array[string]), `report_name` (string), `report_url` (string), `start_date` (date-time), `status` (enum: PENDING, COMPLETE, FAILED, EXPIRED), `updated_at` (date-time) ## Delete a MDR detailed report request Deletes a specific MDR detailed report request by ID `DELETE /legacy/reporting/batch_detail_records/messaging/{id}` ```go messaging, err := client.Legacy.Reporting.BatchDetailRecords.Messaging.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `connections` (array[integer]), `created_at` (date-time), `directions` (array[string]), `end_date` (date-time), `filters` (array[object]), `id` (uuid), `profiles` (array[string]), `record_type` (string), `record_types` (array[string]), `report_name` (string), `report_url` (string), `start_date` (date-time), `status` (enum: PENDING, COMPLETE, FAILED, EXPIRED), `updated_at` (date-time) ## Get all CDR report requests Retrieves all CDR report requests for the authenticated user `GET /legacy/reporting/batch_detail_records/voice` ```go voices, err := client.Legacy.Reporting.BatchDetailRecords.Voice.List(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", voices.Data) ``` Returns: `call_types` (array[integer]), `connections` (array[integer]), `created_at` (string), `end_time` (string), `filters` (array[object]), `id` (string), `managed_accounts` (array[string]), `record_type` (string), `record_types` (array[integer]), `report_name` (string), `report_url` (string), `retry` (int32), `source` (string), `start_time` (string), `status` (int32), `timezone` (string), `updated_at` (string) ## Create a new CDR report request Creates a new CDR report request with the specified filters `POST /legacy/reporting/batch_detail_records/voice` — Required: `start_time`, `end_time` Optional: `call_types` (array[integer]), `connections` (array[integer]), `fields` (array[string]), `filters` (array[object]), `include_all_metadata` (boolean), `managed_accounts` (array[string]), `record_types` (array[integer]), `report_name` (string), `select_all_managed_accounts` (boolean), `source` (string), `timezone` (string) ```go voice, err := client.Legacy.Reporting.BatchDetailRecords.Voice.New(context.Background(), telnyx.LegacyReportingBatchDetailRecordVoiceNewParams{ EndTime: time.Now(), StartTime: time.Now(), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", voice.Data) ``` Returns: `call_types` (array[integer]), `connections` (array[integer]), `created_at` (string), `end_time` (string), `filters` (array[object]), `id` (string), `managed_accounts` (array[string]), `record_type` (string), `record_types` (array[integer]), `report_name` (string), `report_url` (string), `retry` (int32), `source` (string), `start_time` (string), `status` (int32), `timezone` (string), `updated_at` (string) ## Get available CDR report fields Retrieves all available fields that can be used in CDR reports `GET /legacy/reporting/batch_detail_records/voice/fields` ```go response, err := client.Legacy.Reporting.BatchDetailRecords.Voice.GetFields(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Billing) ``` Returns: `Billing` (array[string]), `Interaction Data` (array[string]), `Number Information` (array[string]), `Telephony Data` (array[string]) ## Get a specific CDR report request Retrieves a specific CDR report request by ID `GET /legacy/reporting/batch_detail_records/voice/{id}` ```go voice, err := client.Legacy.Reporting.BatchDetailRecords.Voice.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", voice.Data) ``` Returns: `call_types` (array[integer]), `connections` (array[integer]), `created_at` (string), `end_time` (string), `filters` (array[object]), `id` (string), `managed_accounts` (array[string]), `record_type` (string), `record_types` (array[integer]), `report_name` (string), `report_url` (string), `retry` (int32), `source` (string), `start_time` (string), `status` (int32), `timezone` (string), `updated_at` (string) ## Delete a CDR report request Deletes a specific CDR report request by ID `DELETE /legacy/reporting/batch_detail_records/voice/{id}` ```go voice, err := client.Legacy.Reporting.BatchDetailRecords.Voice.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", voice.Data) ``` Returns: `call_types` (array[integer]), `connections` (array[integer]), `created_at` (string), `end_time` (string), `filters` (array[object]), `id` (string), `managed_accounts` (array[string]), `record_type` (string), `record_types` (array[integer]), `report_name` (string), `report_url` (string), `retry` (int32), `source` (string), `start_time` (string), `status` (int32), `timezone` (string), `updated_at` (string) ## List MDR usage reports Fetch all previous requests for MDR usage reports. `GET /legacy/reporting/usage_reports/messaging` ```go page, err := client.Legacy.Reporting.UsageReports.Messaging.List(context.Background(), telnyx.LegacyReportingUsageReportMessagingListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page) ``` Returns: `aggregation_type` (int32), `connections` (array[string]), `created_at` (date-time), `end_time` (date-time), `id` (uuid), `profiles` (array[string]), `record_type` (string), `report_url` (string), `result` (object), `start_time` (date-time), `status` (int32), `updated_at` (date-time) ## Create a new legacy usage V2 MDR report request Creates a new legacy usage V2 MDR report request with the specified filters `POST /legacy/reporting/usage_reports/messaging` ```go messaging, err := client.Legacy.Reporting.UsageReports.Messaging.New(context.Background(), telnyx.LegacyReportingUsageReportMessagingNewParams{ AggregationType: 0, }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `aggregation_type` (int32), `connections` (array[string]), `created_at` (date-time), `end_time` (date-time), `id` (uuid), `profiles` (array[string]), `record_type` (string), `report_url` (string), `result` (object), `start_time` (date-time), `status` (int32), `updated_at` (date-time) ## Get an MDR usage report Fetch single MDR usage report by id. `GET /legacy/reporting/usage_reports/messaging/{id}` ```go messaging, err := client.Legacy.Reporting.UsageReports.Messaging.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `aggregation_type` (int32), `connections` (array[string]), `created_at` (date-time), `end_time` (date-time), `id` (uuid), `profiles` (array[string]), `record_type` (string), `report_url` (string), `result` (object), `start_time` (date-time), `status` (int32), `updated_at` (date-time) ## Delete a V2 legacy usage MDR report request Deletes a specific V2 legacy usage MDR report request by ID `DELETE /legacy/reporting/usage_reports/messaging/{id}` ```go messaging, err := client.Legacy.Reporting.UsageReports.Messaging.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messaging.Data) ``` Returns: `aggregation_type` (int32), `connections` (array[string]), `created_at` (date-time), `end_time` (date-time), `id` (uuid), `profiles` (array[string]), `record_type` (string), `report_url` (string), `result` (object), `start_time` (date-time), `status` (int32), `updated_at` (date-time) ## List telco data usage reports Retrieve a paginated list of telco data usage reports `GET /legacy/reporting/usage_reports/number_lookup` ```go numberLookups, err := client.Legacy.Reporting.UsageReports.NumberLookup.List(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", numberLookups.Data) ``` Returns: `aggregation_type` (string), `created_at` (date-time), `end_date` (date), `id` (uuid), `managed_accounts` (array[string]), `record_type` (string), `report_url` (string), `result` (array[object]), `start_date` (date), `status` (string), `updated_at` (date-time) ## Submit telco data usage report Submit a new telco data usage report `POST /legacy/reporting/usage_reports/number_lookup` ```go numberLookup, err := client.Legacy.Reporting.UsageReports.NumberLookup.New(context.Background(), telnyx.LegacyReportingUsageReportNumberLookupNewParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", numberLookup.Data) ``` Returns: `aggregation_type` (string), `created_at` (date-time), `end_date` (date), `id` (uuid), `managed_accounts` (array[string]), `record_type` (string), `report_url` (string), `result` (array[object]), `start_date` (date), `status` (string), `updated_at` (date-time) ## Get telco data usage report by ID Retrieve a specific telco data usage report by its ID `GET /legacy/reporting/usage_reports/number_lookup/{id}` ```go numberLookup, err := client.Legacy.Reporting.UsageReports.NumberLookup.Get(context.Background(), "id") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", numberLookup.Data) ``` Returns: `aggregation_type` (string), `created_at` (date-time), `end_date` (date), `id` (uuid), `managed_accounts` (array[string]), `record_type` (string), `report_url` (string), `result` (array[object]), `start_date` (date), `status` (string), `updated_at` (date-time) ## Delete telco data usage report Delete a specific telco data usage report by its ID `DELETE /legacy/reporting/usage_reports/number_lookup/{id}` ```go err := client.Legacy.Reporting.UsageReports.NumberLookup.Delete(context.Background(), "id") if err != nil { log.Fatal(err) } ``` ## List CDR usage reports Fetch all previous requests for cdr usage reports. `GET /legacy/reporting/usage_reports/voice` ```go page, err := client.Legacy.Reporting.UsageReports.Voice.List(context.Background(), telnyx.LegacyReportingUsageReportVoiceListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page) … ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [team-telnyx](https://github.com/team-telnyx) - **Source:** [team-telnyx/ai](https://github.com/team-telnyx/ai) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-team-telnyx-ai-telnyx-account-reports-go - Seller: https://agentstack.voostack.com/s/team-telnyx - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.