Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Telnyx Account Reports - Ruby · team-telnyx | DecimalAI

team-telnyx/telnyx-account-reports-ruby

SkillScore91Maintained

Generate and retrieve usage reports for billing, analytics, and reconciliation. This skill provides Ruby SDK examples.

codingby team-telnyx

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/team-telnyx-telnyx-account-reports-ruby/SKILL.md

decimalai skills pull team-telnyx-telnyx-account-reports-ruby --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/team-telnyx-telnyx-account-reports-ruby/SKILL.md https://app.decimal.ai/s/team-telnyx-telnyx-account-reports-ruby/SKILL.md

Raw file: /s/team-telnyx-telnyx-account-reports-ruby/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-account-reports-ruby.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

23 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 6d ago

Yes — +78% lift · at higher cost+397% tokens0% turns91% of whole cases pass with skill (21/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	241%	0%
case-02	✗→✓	▲ Improved	546%	0%
case-03	✗→✓	▲ Improved	379%	0%
case-04	✗→✓	▲ Improved	545%	0%
case-05	✗→✓	▲ Improved	571%	0%

Showing 5 of 23 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/10/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

team-telnyx / ai

skills/telnyx-account-reports-ruby/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v2

Skill contents

SKILL.md

Telnyx Account Reports - Ruby

Installation

bash
gem install telnyx

Setup

ruby
require "telnyx"

client = Telnyx::Client.new(
  api_key: ENV["TELNYX_API_KEY"], # This is the default and can be omitted
)

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:

ruby
begin
  result = client.messages.send_(to: "+13125550001", from: "+13125550002", text: "Hello")
rescue Telnyx::Errors::APIConnectionError
  puts "Network error — check connectivity and retry"
rescue Telnyx::Errors::RateLimitError
  # 429: rate limited — wait and retry with exponential backoff
  sleep(1) # Check Retry-After header for actual delay
rescue Telnyx::Errors::APIStatusError => e
  puts "API error #{e.status}: #{e.message}"
  if e.status == 422
    puts "Validation error — check required fields and formats"
  end
end

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 .auto_paging_each for automatic iteration: page.auto_paging_each { |item| puts item.id }.

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

ruby
page = client.call_events.list

puts(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)

ruby
ledger_billing_group_report = client.ledger_billing_group_reports.create

puts(ledger_billing_group_report)

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}

ruby
ledger_billing_group_report = client.ledger_billing_group_reports.retrieve("f5586561-8ff0-4291-a0ac-84fe544797bd")

puts(ledger_billing_group_report)

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

ruby
messagings = client.legacy.reporting.batch_detail_records.messaging.list

puts(messagings)

Returns: connections (arrayinteger]), created_at (date-time), directions (arraystring]), end_date (date-time), filters (arrayobject]), id (uuid), profiles (arraystring]), record_type (string), record_types (arraystring]), 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 (arrayinteger]), directions (arrayinteger]), filters (arrayobject]), include_message_body (boolean), managed_accounts (arraystring]), profiles (arraystring]), record_types (arrayinteger]), report_name (string), select_all_managed_accounts (boolean), timezone (string)

ruby
messaging = client.legacy.reporting.batch_detail_records.messaging.create(
  end_time: "2024-02-12T23:59:59Z",
  start_time: "2024-02-01T00:00:00Z"
)

puts(messaging)

Returns: connections (arrayinteger]), created_at (date-time), directions (arraystring]), end_date (date-time), filters (arrayobject]), id (uuid), profiles (arraystring]), record_type (string), record_types (arraystring]), 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}

ruby
messaging = client.legacy.reporting.batch_detail_records.messaging.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(messaging)

Returns: connections (arrayinteger]), created_at (date-time), directions (arraystring]), end_date (date-time), filters (arrayobject]), id (uuid), profiles (arraystring]), record_type (string), record_types (arraystring]), 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}

ruby
messaging = client.legacy.reporting.batch_detail_records.messaging.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(messaging)

Returns: connections (arrayinteger]), created_at (date-time), directions (arraystring]), end_date (date-time), filters (arrayobject]), id (uuid), profiles (arraystring]), record_type (string), record_types (arraystring]), 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

ruby
voices = client.legacy.reporting.batch_detail_records.voice.list

puts(voices)

Returns: call_types (arrayinteger]), connections (arrayinteger]), created_at (string), end_time (string), filters (arrayobject]), id (string), managed_accounts (arraystring]), record_type (string), record_types (arrayinteger]), 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 (arrayinteger]), connections (arrayinteger]), fields (arraystring]), filters (arrayobject]), include_all_metadata (boolean), managed_accounts (arraystring]), record_types (arrayinteger]), report_name (string), select_all_managed_accounts (boolean), source (string), timezone (string)

ruby
voice = client.legacy.reporting.batch_detail_records.voice.create(
  end_time: "2024-02-12T23:59:59Z",
  start_time: "2024-02-01T00:00:00Z"
)

puts(voice)

Returns: call_types (arrayinteger]), connections (arrayinteger]), created_at (string), end_time (string), filters (arrayobject]), id (string), managed_accounts (arraystring]), record_type (string), record_types (arrayinteger]), 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

ruby
response = client.legacy.reporting.batch_detail_records.voice.retrieve_fields

puts(response)

Returns: Billing (arraystring]), Interaction Data (arraystring]), Number Information (arraystring]), Telephony Data (arraystring])

Get a specific CDR report request

Retrieves a specific CDR report request by ID

GET /legacy/reporting/batch_detail_records/voice/{id}

ruby
voice = client.legacy.reporting.batch_detail_records.voice.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(voice)

Returns: call_types (arrayinteger]), connections (arrayinteger]), created_at (string), end_time (string), filters (arrayobject]), id (string), managed_accounts (arraystring]), record_type (string), record_types (arrayinteger]), 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}

ruby
voice = client.legacy.reporting.batch_detail_records.voice.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(voice)

Returns: call_types (arrayinteger]), connections (arrayinteger]), created_at (string), end_time (string), filters (arrayobject]), id (string), managed_accounts (arraystring]), record_type (string), record_types (arrayinteger]), 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

ruby
page = client.legacy.reporting.usage_reports.messaging.list

puts(page)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), profiles (arraystring]), 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

ruby
messaging = client.legacy.reporting.usage_reports.messaging.create(aggregation_type: 0)

puts(messaging)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), profiles (arraystring]), 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}

ruby
messaging = client.legacy.reporting.usage_reports.messaging.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(messaging)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), profiles (arraystring]), 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}

ruby
messaging = client.legacy.reporting.usage_reports.messaging.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(messaging)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), profiles (arraystring]), 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

ruby
number_lookups = client.legacy.reporting.usage_reports.number_lookup.list

puts(number_lookups)

Returns: aggregation_type (string), created_at (date-time), end_date (date), id (uuid), managed_accounts (arraystring]), record_type (string), report_url (string), result (arrayobject]), 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

ruby
number_lookup = client.legacy.reporting.usage_reports.number_lookup.create

puts(number_lookup)

Returns: aggregation_type (string), created_at (date-time), end_date (date), id (uuid), managed_accounts (arraystring]), record_type (string), report_url (string), result (arrayobject]), 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}

ruby
number_lookup = client.legacy.reporting.usage_reports.number_lookup.retrieve("550e8400-e29b-41d4-a716-446655440000")

puts(number_lookup)

Returns: aggregation_type (string), created_at (date-time), end_date (date), id (uuid), managed_accounts (arraystring]), record_type (string), report_url (string), result (arrayobject]), 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}

ruby
result = client.legacy.reporting.usage_reports.number_lookup.delete("550e8400-e29b-41d4-a716-446655440000")

puts(result)

List CDR usage reports

Fetch all previous requests for cdr usage reports.

GET /legacy/reporting/usage_reports/voice

ruby
page = client.legacy.reporting.usage_reports.voice.list

puts(page)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), product_breakdown (int32), record_type (string), report_url (string), result (object), start_time (date-time), status (int32), updated_at (date-time)

Create a new legacy usage V2 CDR report request

Creates a new legacy usage V2 CDR report request with the specified filters

POST /legacy/reporting/usage_reports/voice

ruby
voice = client.legacy.reporting.usage_reports.voice.create(
  end_time: "2024-02-01T00:00:00Z",
  start_time: "2024-02-01T00:00:00Z"
)

puts(voice)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), product_breakdown (int32), record_type (string), report_url (string), result (object), start_time (date-time), status (int32), updated_at (date-time)

Get a CDR usage report

Fetch single cdr usage report by id.

GET /legacy/reporting/usage_reports/voice/{id}

ruby
voice = client.legacy.reporting.usage_reports.voice.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(voice)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), product_breakdown (int32), record_type (string), report_url (string), result (object), start_time (date-time), status (int32), updated_at (date-time)

Delete a V2 legacy usage CDR report request

Deletes a specific V2 legacy usage CDR report request by ID

DELETE /legacy/reporting/usage_reports/voice/{id}

ruby
voice = client.legacy.reporting.usage_reports.voice.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(voice)

Returns: aggregation_type (int32), connections (arraystring]), created_at (date-time), end_time (date-time), id (uuid), product_breakdown (int32), record_type (string), report_url (string), result (object), start_time (date-time), status (int32), updated_at (date-time)

List CSV downloads

GET /phone_numbers/csv_downloads

ruby
page = client.phone_numbers.csv_downloads.list

puts(page)

Returns: id (string), record_type (string), status (enum: pending, complete, failed, expired), url (string)

Create a CSV download

POST /phone_numbers/csv_downloads

ruby
csv_download = client.phone_numbers.csv_downloads.create

puts(csv_download)

Returns: id (string), record_type (string), status (enum: pending, complete, failed, expired), url (string)

Retrieve a CSV download

GET /phone_numbers/csv_downloads/{id}

ruby
csv_download = client.phone_numbers.csv_downloads.retrieve("550e8400-e29b-41d4-a716-446655440000")

puts(csv_download)

Returns: id (string), record_type (string), status (enum: pending, complete, failed, expired), url (string)

Generates and fetches CDR Usage Reports

Generate and fetch voice usage report synchronously. This endpoint will both generate and fetch the voice report over a specified time period. No polling is necessary but the response may take up to a couple of minutes.

GET /reports/cdr_usage_reports/sync

ruby
response = client.reports.cdr_usage_reports.fetch_sync(
  aggregation_type: :NO_AGGREGATION,
  product_breakdown: :NO_BREAKDOWN
)

puts(response)

Returns: aggregation_type (enum: NO_AGGREGATION, CONNECTION, TAG, BILLING_GROUP), connections (arrayinteger]), created_at (date-time), end_time (date-time), id (uuid), product_breakdown (enum: NO_BREAKDOWN, DID_VS_TOLL_FREE, COUNTRY, DID_VS_TOLL_FREE_PER_COUNTRY), record_type (string), report_url (string), result (object), start_time (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Fetch all Messaging usage reports

Fetch all messaging usage reports. Usage reports are aggregated messaging data for specified time period and breakdown

GET /reports/mdr_usage_reports

ruby
page = client.reports.mdr_usage_reports.list

puts(page)

Returns: aggregation_type (enum: NO_AGGREGATION, PROFILE, TAGS), connections (arrayinteger]), created_at (date-time), end_date (date-time), id (uuid), profiles (string), record_type (string), report_url (string), result (arrayobject]), start_date (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Create MDR Usage Report

Submit request for new new messaging usage report. This endpoint will pull and aggregate messaging data in specified time period.

POST /reports/mdr_usage_reports

ruby
mdr_usage_report = client.reports.mdr_usage_reports.create(
  aggregation_type: :NO_AGGREGATION,
  end_date: "2020-07-01T00:00:00-06:00",
  start_date: "2020-07-01T00:00:00-06:00"
)

puts(mdr_usage_report)

Returns: aggregation_type (enum: NO_AGGREGATION, PROFILE, TAGS), connections (arrayinteger]), created_at (date-time), end_date (date-time), id (uuid), profiles (string), record_type (string), report_url (string), result (arrayobject]), start_date (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Generate and fetch MDR Usage Report

Generate and fetch messaging usage report synchronously. This endpoint will both generate and fetch the messaging report over a specified time period. No polling is necessary but the response may take up to a couple of minutes.

GET /reports/mdr_usage_reports/sync

ruby
response = client.reports.mdr_usage_reports.fetch_sync(aggregation_type: :PROFILE)

puts(response)

Returns: aggregation_type (enum: NO_AGGREGATION, PROFILE, TAGS), connections (arrayinteger]), created_at (date-time), end_date (date-time), id (uuid), profiles (string), record_type (string), report_url (string), result (arrayobject]), start_date (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Retrieve messaging report

Fetch a single messaging usage report by id

GET /reports/mdr_usage_reports/{id}

ruby
mdr_usage_report = client.reports.mdr_usage_reports.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(mdr_usage_report)

Returns: aggregation_type (enum: NO_AGGREGATION, PROFILE, TAGS), connections (arrayinteger]), created_at (date-time), end_date (date-time), id (uuid), profiles (string), record_type (string), report_url (string), result (arrayobject]), start_date (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Delete MDR Usage Report

Delete messaging usage report by id

DELETE /reports/mdr_usage_reports/{id}

ruby
mdr_usage_report = client.reports.mdr_usage_reports.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(mdr_usage_report)

Returns: aggregation_type (enum: NO_AGGREGATION, PROFILE, TAGS), connections (arrayinteger]), created_at (date-time), end_date (date-time), id (uuid), profiles (string), record_type (string), report_url (string), result (arrayobject]), start_date (date-time), status (enum: PENDING, COMPLETE, FAILED, EXPIRED), updated_at (date-time)

Fetch all Mdr records

GET /reports/mdrs

ruby
response = client.reports.list_mdrs

puts(response)

Returns: cld (string), cli (string), cost (string), created_at (date-time), currency (enum: AUD, CAD, EUR, GBP, USD), direction (string), id (string), message_type (enum: SMS, MMS), parts (number), profile_name (string), rate (string), record_type (string), status (enum: GW_TIMEOUT, DELIVERED, DLR_UNCONFIRMED, DLR_TIMEOUT, RECEIVED, GW_REJECT, FAILED)

Fetches all Wdr records

Fetch all Wdr records

GET /reports/wdrs

ruby
page = client.reports.list_wdrs

puts(page)

Returns: cost (object), created_at (date-time), downlink_data (object), duration_seconds (number), id (string), imsi (string), mcc (string), mnc (string), phone_number (string), rate (object), record_type (string), sim_card_id (string), sim_group_id (string), sim_group_name (string), uplink_data (object)

Get metadata overview

Returns all available record types and supported query parameters for session analysis.

GET /session_analysis/metadata

ruby
metadata = client.session_analysis.metadata.retrieve

puts(metadata)

Returns: meta (object), query_parameters (object), record_types (arrayobject])

Get record type metadata

Returns detailed metadata for a specific record type, including relationships and examples.

GET /session_analysis/metadata/{record_type}

ruby
response = client.session_analysis.metadata.retrieve_record_type("record_type")

puts(response)

Returns: aliases (arraystring]), child_relationships (arrayobject]), event (string), examples (object), meta (object), parent_relationships (arrayobject]), product (string), record_type (string)

Get session analysis

Retrieves a full session analysis tree for a given event, including costs, child events, and product linkages.

GET /session_analysis/{record_type}/{event_id}

ruby
session_analysis = client.session_analysis.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", record_type: "record_type")

puts(session_analysis)

Returns: cost (object), meta (object), root (object), session_id (string)

Get Telnyx product usage data (BETA)

Get Telnyx usage data by product, broken out by the specified dimensions

GET /usage_reports

ruby
page = client.usage_reports.list(dimensions: ["string"], metrics: ["string"], product: "wireless")

puts(page)

Returns: data (arrayobject]), meta (object)

Get Usage Reports query options (BETA)

Get the Usage Reports options for querying usage, including the products available and their respective metrics and dimensions

GET /usage_reports/options

ruby
response = client.usage_reports.get_options

puts(response)

Returns: product (string), product_dimensions (arraystring]), product_metrics (arraystring]), record_types (arrayobject])

Get all Wireless Detail Records (WDRs) Reports

Returns the WDR Reports that match the given parameters.

GET /wireless/detail_records_reports

ruby
detail_records_reports = client.wireless.detail_records_reports.list

puts(detail_records_reports)

Returns: created_at (string), end_time (string), id (uuid), record_type (string), report_url (string), start_time (string), status (enum: pending, complete, failed, deleted), updated_at (string)

Create a Wireless Detail Records (WDRs) Report

Asynchronously create a report containing Wireless Detail Records (WDRs) for the SIM cards that consumed wireless data in the given time period.

POST /wireless/detail_records_reports

Optional: end_time (string), start_time (string)

ruby
detail_records_report = client.wireless.detail_records_reports.create

puts(detail_records_report)

Returns: created_at (string), end_time (string), id (uuid), record_type (string), report_url (string), start_time (string), status (enum: pending, complete, failed, deleted), updated_at (string)

Get a Wireless Detail Record (WDR) Report

Returns one specific WDR report

GET /wireless/detail_records_reports/{id}

ruby
detail_records_report = client.wireless.detail_records_reports.retrieve("6a09cdc3-8948-47f0-aa62-74ac943d6c58")

puts(detail_records_report)

Returns: created_at (string), end_time (string), id (uuid), record_type (string), report_url (string), start_time (string), status (enum: pending, complete, failed, deleted), updated_at (string)

Delete a Wireless Detail Record (WDR) Report

Deletes one specific WDR report.

DELETE /wireless/detail_records_reports/{id}

ruby
detail_records_report = client.wireless.detail_records_reports.delete("6a09cdc3-8948-47f0-aa62-74ac943d6c58")

puts(detail_records_report)

Returns: created_at (string), end_time (string), id (uuid), record_type (string), report_url (string), start_time (string), status (enum: pending, complete, failed, deleted), updated_at (string)

Want to see if team-telnyx/telnyx-account-reports-ruby would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/23/2026, 12:40 UTC · 23 cases

Lift

+78%

91% vs 13%

Agent turns

0%

1.0 vs 1.0

Tokens

+397%

9,138.57 vs 1,837.48

fail → pass · 19pass → pass · 2fail → fail · 1pass → fail · 1

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 Write a Ruby script using the Telnyx client to fetch call events. Please ensure the response structure provides the leg identifier, session identifier, when the event happened, associated metadata, the event name, and both the record and command/webhook types.	fail→pass	14,187	13,176	-7%	1	1	0%	2,792	9,513	+241%	0	0	—
case-02 I need to generate a new report for wireless detail records using the Ruby SDK. The expected return object must contain the creation and update timestamps, the start and end times, the report's unique identifier, the specific record type, the URL where the report can be accessed, and its current processing state.	fail→pass	7,749	5,736	-26%	1	1	0%	1,483	9,580	+546%	0	0	—
case-03 Can you show me how to retrieve the session analysis metadata overview in Ruby? I am expecting the API to return an object containing the general meta information, the allowed query parameters, and an array of the various record types available.	fail→pass	11,270	3,170	-72%	1	1	0%	1,881	9,010	+379%	0	0	—
case-04 When making requests with the Telnyx Ruby client, what specific exception class should I rescue to implement an exponential backoff strategy for HTTP 429 responses?	fail→pass	8,422	2,248	-73%	1	1	0%	1,372	8,850	+545%	0	0	—
case-05 If I submit improperly formatted fields to the Telnyx API, the Ruby SDK will raise an exception. Which specific exception class should I catch, and what HTTP status code property should I check to confirm it's a validation failure?	fail→pass	7,607	3,020	-60%	1	1	0%	1,344	9,014	+571%	0	0	—
case-06 I want to iterate through all pages of a Telnyx list response in my Ruby application without manually managing cursors. What specific method should I call on the returned page object to yield each item automatically?	pass→pass	5,005	2,613	-48%	1	1	0%	778	8,826	+1034%	0	0	—
case-11 What is the correct Ruby SDK method chain to retrieve a paginated list of legacy telco data usage reports, specifically for number lookups?	fail→pass	11,234	2,336	-79%	1	1	0%	1,841	8,830	+380%	0	0	—
case-07 Using the Telnyx Ruby SDK, write the code to initiate a new ledger billing group report. The method should accept optional month and year parameters.	fail→pass	7,233	4,333	-40%	1	1	0%	1,282	9,214	+619%	0	0	—
case-08 I need to request a batch detail record for messaging using the legacy reporting endpoints in the Telnyx Ruby SDK. What is the exact method chain to create this request with start and end times?	fail→pass	9,117	3,458	-62%	1	1	0%	1,609	9,093	+465%	0	0	—
case-09 How do I fetch the list of available fields (like Billing, Interaction Data, etc.) that can be included in legacy voice batch detail records using the Telnyx Ruby client?	fail→pass	14,099	3,592	-75%	1	1	0%	2,210	9,077	+311%	0	0	—
case-10 I need to construct a V2 messaging usage report request using the legacy reporting module in the Telnyx Ruby SDK. Set the aggregation type to zero.	fail→pass	7,459	2,870	-62%	1	1	0%	1,226	8,860	+623%	0	0	—
case-12 Write the Ruby code to remove a V2 legacy usage report request for voice, given its UUID.	fail→pass	10,280	2,927	-72%	1	1	0%	1,630	8,919	+447%	0	0	—
case-13 I have the ID of a pending CSV download for phone numbers. Which Telnyx Ruby SDK method should I use to check its status?	fail→pass	6,713	2,248	-67%	1	1	0%	1,011	8,838	+774%	0	0	—
case-14 I want to generate and immediately fetch a voice usage report without writing a polling loop. Which synchronous method in the Telnyx Ruby SDK handles this?	fail→pass	13,194	2,936	-78%	1	1	0%	2,092	8,944	+328%	0	0	—
case-15 How do I submit a request to aggregate messaging data over a specific time period using the non-legacy MDR usage reports endpoint in Ruby?	fail→pass	14,260	5,233	-63%	1	1	0%	2,464	9,447	+283%	0	0	—
case-16 What is the specific method on the Telnyx Ruby client to fetch a raw list of all MDR records (not the aggregated usage report)?	fail→pass	12,212	3,176	-74%	1	1	0%	2,061	8,960	+335%	0	0	—
case-17 I need to retrieve all Wireless Detail Records (WDRs) showing downlink and uplink data. What is the correct Ruby SDK method to list these?	fail→pass	10,830	3,825	-65%	1	1	0%	1,728	9,159	+430%	0	0	—
case-18 Using the Telnyx session analysis API in Ruby, how do I fetch the detailed metadata, including parent and child relationships, for a specific record type?	fail→pass	12,916	4,763	-63%	1	1	0%	2,108	9,299	+341%	0	0	—
case-19 How do I query the beta usage reports endpoint in the Telnyx Ruby SDK to get usage data broken down by specific dimensions and metrics for the 'wireless' product?	fail→pass	11,165	3,105	-72%	1	1	0%	2,078	8,932	+330%	0	0	—
case-20 I want to discover which products, dimensions, and metrics are available for querying in the beta usage reports API. What Ruby SDK method returns these options?	fail→pass	27,720	2,544	-91%	1	1	0%	4,536	8,887	+96%	0	0	—
case-21 How do I search for and purchase a new local phone number in Chicago using the Telnyx Ruby SDK?	pass→pass	10,454	7,047	-33%	1	1	0%	1,887	9,777	+418%	0	0	—
case-22 What is the Ruby code to provision a new IP-based SIP connection on my Telnyx account?	fail→fail	9,769	7,571	-22%	1	1	0%	1,728	9,726	+463%	0	0	—
case-23 I need to initiate an outbound voice call to a customer using the Telnyx Ruby SDK. What class and method should I use?	pass→fail	6,534	5,816	-11%	1	1	0%	1,121	9,432	+741%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted. The headline lift of +78 percentage points is the difference between those two pass rates over the 23 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 13%
Pass rate with the skill: 91.3%
Cases attempted: 23
Cases counted toward lift: 23
Cases that regressed: 1
Skill version measured: v2
Run completed: 8/23/2026, 12:40 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

Write a Ruby script using the Telnyx client to fetch call events. Please ensure the response structure provides the leg identifier, session identifier, when the event happened, associated metadata, the event name, and both the record and command/webhook types.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run91

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+598% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 5 days ago

Other measured skills in the registry, with their headline benchmark lift.