Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Account - Java · team-telnyx | DecimalAI

team-telnyx/telnyx-account-java

SkillScore100Maintained

Manage account balance, payments, invoices, webhooks, and view audit logs and detail records. This skill provides Java 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-java/SKILL.md

decimalai skills pull team-telnyx-telnyx-account-java --out .claude/skills/

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

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

Raw file: /s/team-telnyx-telnyx-account-java/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-account-java.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

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

Yes — +86% lift · at higher cost+69% tokens0% turns100% of whole cases pass with skill (22/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	17%	0%
case-02	✗→✓	▲ Improved	50%	0%
case-03	✗→✓	▲ Improved	69%	0%
case-10	✗→✓	▲ Improved	2%	0%
case-07	✗→✓	▲ Improved	268%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/27/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-java/SKILL.md

View on GitHub ↗

License MITImported 8/27/2026Version v3

Skill contents

SKILL.md

Telnyx Account - Java

Installation

text
<!-- Maven -->
<dependency>
    <groupId>com.telnyx.sdk</groupId>
    <artifactId>telnyx</artifactId>
    <version>6.89.0</version>
</dependency>

// Gradle
implementation("com.telnyx.sdk:telnyx:6.89.0")

Setup

java
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

TelnyxClient client = TelnyxOkHttpClient.fromEnv();

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:

java
import com.telnyx.sdk.errors.TelnyxServiceException;

try {
    var result = client.messages().send(params);
} catch (TelnyxServiceException e) {
    System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
    if (e.statusCode() == 422) {
        System.err.println("Validation error — check required fields and formats");
    } else if (e.statusCode() == 429) {
        // Rate limited — wait and retry with exponential backoff
        Thread.sleep(1000);
    }
}

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: List methods return a page. Use .autoPager() for automatic iteration: for (var item : page.autoPager()) { ... }. For manual control, use .hasNextPage() and .nextPage().

List Audit Logs

Retrieve a list of audit log entries. Audit logs are a best-effort, eventually consistent record of significant account-related changes.

GET /audit_events

java
import com.telnyx.sdk.models.auditevents.AuditEventListPage;
import com.telnyx.sdk.models.auditevents.AuditEventListParams;

AuditEventListPage page = client.auditEvents().list();

Returns: alternate_resource_id (string | null), change_made_by (enum: telnyx, account_manager, account_owner, organization_member), change_type (string), changes (array | null), created_at (date-time), id (uuid), organization_id (uuid), record_type (string), resource_id (string), user_id (uuid)

Get user balance details

GET /balance

java
import com.telnyx.sdk.models.balance.BalanceRetrieveParams;
import com.telnyx.sdk.models.balance.BalanceRetrieveResponse;

BalanceRetrieveResponse balance = client.balance().retrieve();

Returns: available_credit (string), balance (string), credit_limit (string), currency (string), pending (string), record_type (enum: balance)

Get monthly charges breakdown

Retrieve a detailed breakdown of monthly charges for phone numbers in a specified date range. The date range cannot exceed 31 days.

GET /charges_breakdown

java
import com.telnyx.sdk.models.chargesbreakdown.ChargesBreakdownRetrieveParams;
import com.telnyx.sdk.models.chargesbreakdown.ChargesBreakdownRetrieveResponse;
import java.time.LocalDate;

ChargesBreakdownRetrieveParams params = ChargesBreakdownRetrieveParams.builder()
    .startDate(LocalDate.parse("2025-05-01"))
    .build();
ChargesBreakdownRetrieveResponse chargesBreakdown = client.chargesBreakdown().retrieve(params);

Returns: currency (string), end_date (date), results (arrayobject]), start_date (date), user_email (email), user_id (string)

Get monthly charges summary

Retrieve a summary of monthly charges for a specified date range. The date range cannot exceed 31 days.

GET /charges_summary

java
import com.telnyx.sdk.models.chargessummary.ChargesSummaryRetrieveParams;
import com.telnyx.sdk.models.chargessummary.ChargesSummaryRetrieveResponse;
import java.time.LocalDate;

ChargesSummaryRetrieveParams params = ChargesSummaryRetrieveParams.builder()
    .endDate(LocalDate.parse("2025-06-01"))
    .startDate(LocalDate.parse("2025-05-01"))
    .build();
ChargesSummaryRetrieveResponse chargesSummary = client.chargesSummary().retrieve(params);

Returns: currency (string), end_date (date), start_date (date), summary (object), total (object), user_email (email), user_id (string)

Search detail records

Search for any detail record across the Telnyx Platform

GET /detail_records

java
import com.telnyx.sdk.models.detailrecords.DetailRecordListPage;
import com.telnyx.sdk.models.detailrecords.DetailRecordListParams;

DetailRecordListPage page = client.detailRecords().list();

Returns: carrier (string), carrier_fee (string), cld (string), cli (string), completed_at (date-time), cost (string), country_code (string), created_at (date-time), currency (string), delivery_status (string), delivery_status_failover_url (string), delivery_status_webhook_url (string), direction (enum: inbound, outbound), errors (arraystring]), fteu (boolean), mcc (string), message_type (enum: SMS, MMS, RCS), mnc (string), on_net (boolean), parts (integer), profile_id (string), profile_name (string), rate (string), record_type (string), sent_at (date-time), source_country_code (string), status (enum: gw_timeout, delivered, dlr_unconfirmed, dlr_timeout, received, gw_reject, failed), tags (string), updated_at (date-time), user_id (string), uuid (string)

List invoices

Retrieve a paginated list of invoices.

GET /invoices

java
import com.telnyx.sdk.models.invoices.InvoiceListPage;
import com.telnyx.sdk.models.invoices.InvoiceListParams;

InvoiceListPage page = client.invoices().list();

Returns: file_id (uuid), invoice_id (uuid), paid (boolean), period_end (date), period_start (date), url (uri)

Get invoice by ID

Retrieve a single invoice by its unique identifier.

GET /invoices/{id}

java
import com.telnyx.sdk.models.invoices.InvoiceRetrieveParams;
import com.telnyx.sdk.models.invoices.InvoiceRetrieveResponse;

InvoiceRetrieveResponse invoice = client.invoices().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

Returns: download_url (uri), file_id (uuid), invoice_id (uuid), paid (boolean), period_end (date), period_start (date), url (uri)

List auto recharge preferences

Returns the payment auto recharge preferences.

GET /payment/auto_recharge_prefs

java
import com.telnyx.sdk.models.payment.autorechargeprefs.AutoRechargePrefListParams;
import com.telnyx.sdk.models.payment.autorechargeprefs.AutoRechargePrefListResponse;

AutoRechargePrefListResponse autoRechargePrefs = client.payment().autoRechargePrefs().list();

Returns: enabled (boolean), id (string), invoice_enabled (boolean), preference (enum: credit_paypal, ach), recharge_amount (string), record_type (string), threshold_amount (string)

Update auto recharge preferences

Update payment auto recharge preferences.

PATCH /payment/auto_recharge_prefs

Optional: enabled (boolean), invoice_enabled (boolean), preference (enum: credit_paypal, ach), recharge_amount (string), threshold_amount (string)

java
import com.telnyx.sdk.models.payment.autorechargeprefs.AutoRechargePrefUpdateParams;
import com.telnyx.sdk.models.payment.autorechargeprefs.AutoRechargePrefUpdateResponse;

AutoRechargePrefUpdateResponse autoRechargePref = client.payment().autoRechargePrefs().update();

Returns: enabled (boolean), id (string), invoice_enabled (boolean), preference (enum: credit_paypal, ach), recharge_amount (string), record_type (string), threshold_amount (string)

List User Tags

List all user tags.

GET /user_tags

java
import com.telnyx.sdk.models.usertags.UserTagListParams;
import com.telnyx.sdk.models.usertags.UserTagListResponse;

UserTagListResponse userTags = client.userTags().list();

Returns: number_tags (arraystring]), outbound_profile_tags (arraystring])

Create a stored payment transaction

POST /v2/payment/stored_payment_transactions — Required: amount

java
import com.telnyx.sdk.models.payment.PaymentCreateStoredPaymentTransactionParams;
import com.telnyx.sdk.models.payment.PaymentCreateStoredPaymentTransactionResponse;

PaymentCreateStoredPaymentTransactionParams params = PaymentCreateStoredPaymentTransactionParams.builder()
    .amount("120.00")
    .build();
PaymentCreateStoredPaymentTransactionResponse response = client.payment().createStoredPaymentTransaction(params);

Returns: amount_cents (integer), amount_currency (string), auto_recharge (boolean), created_at (date-time), id (string), processor_status (string), record_type (enum: transaction), transaction_processing_type (enum: stored_payment)

List webhook deliveries

Lists webhook_deliveries for the authenticated user

GET /webhook_deliveries

java
import com.telnyx.sdk.models.webhookdeliveries.WebhookDeliveryListPage;
import com.telnyx.sdk.models.webhookdeliveries.WebhookDeliveryListParams;

WebhookDeliveryListPage page = client.webhookDeliveries().list();

Returns: attempts (arrayobject]), finished_at (date-time), id (uuid), record_type (string), started_at (date-time), status (enum: delivered, failed), user_id (uuid), webhook (object)

Find webhook_delivery details by ID

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

GET /webhook_deliveries/{id}

java
import com.telnyx.sdk.models.webhookdeliveries.WebhookDeliveryRetrieveParams;
import com.telnyx.sdk.models.webhookdeliveries.WebhookDeliveryRetrieveResponse;

WebhookDeliveryRetrieveResponse webhookDelivery = client.webhookDeliveries().retrieve("C9C0797E-901D-4349-A33C-C2C8F31A92C2");

Returns: attempts (arrayobject]), finished_at (date-time), id (uuid), record_type (string), started_at (date-time), status (enum: delivered, failed), user_id (uuid), webhook (object)

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

Latest benchmark · publisher runVerified

8/27/2026, 06:58 UTC · 22 cases

Lift

+86%

100% vs 14%

Agent turns

0%

1.0 vs 1.0

Tokens

+69%

4,148.23 vs 2,456.91

fail → pass · 19pass → pass · 3

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need a Java implementation using the Telnyx SDK to check our current account balance and retrieve the charges breakdown for phone numbers during May 2025. Make sure the code assumes standard environment initialization and wraps the API calls with proper error handling for status codes like validation or rate limits.	fail→pass	20,163	9,055	-55%	1	1	0%	4,362	5,111	+17%	0	0	—
case-02 Please write a Java program using Telnyx's SDK that creates a stored payment transaction for $120.00 and retrieves our account's payment auto-recharge preferences. Include robust error handling that logs HTTP error responses when the service call fails.	fail→pass	17,702	12,773	-28%	1	1	0%	4,064	6,092	+50%	0	0	—
case-03 Can you show me how to use the Telnyx Java SDK to list our account invoices, retrieve details for a specific invoice ID, and look up debug delivery logs for a webhook ID? Please include standard client setup along with exception handling.	fail→pass	16,776	12,297	-27%	1	1	0%	3,486	5,895	+69%	0	0	—
case-04 We are building a Python application and need to retrieve our account balance using the official Telnyx Python client. Please show the Python setup and API call.	pass→pass	6,999	4,599	-34%	1	1	0%	1,482	3,852	+160%	0	0	—
case-05 Write a Java snippet using the Telnyx SDK to initiate an outbound voice call to +18005550199 from +18005550100 using a Call Control application ID.	pass→pass	8,885	7,083	-20%	1	1	0%	2,007	4,543	+126%	0	0	—
case-10 Write a Java code snippet using the Telnyx SDK to fetch the monthly charges summary for the date range May 1, 2025 to June 1, 2025. Ensure parameters are properly constructed.	fail→pass	20,767	7,652	-63%	1	1	0%	4,467	4,550	+2%	0	0	—
case-06 Write a Java program using the Telnyx SDK to create a new SIP Connection with credential authentication for IP voice routing.	pass→pass	11,939	7,801	-35%	1	1	0%	2,579	4,570	+77%	0	0	—
case-07 We are updating our Java project's pom.xml build configuration to integrate the official Telnyx SDK. What Maven dependency XML declaration should we add?	fail→pass	4,590	1,622	-65%	1	1	0%	862	3,176	+268%	0	0	—
case-08 We use Gradle Kotlin DSL for our build. Provide the build.gradle.kts dependency line for adding the current Telnyx Java SDK.	fail→pass	5,615	1,930	-66%	1	1	0%	1,006	3,331	+231%	0	0	—
case-09 We need to audit recent administrative actions on our account using Java. Write a snippet that fetches audit events using the standard Telnyx Java client.	fail→pass	10,792	4,387	-59%	1	1	0%	2,205	3,854	+75%	0	0	—
case-11 We want to search for detail records across our Telnyx account in Java. Provide the code that invokes the detail records list method.	fail→pass	10,967	6,301	-43%	1	1	0%	2,279	4,237	+86%	0	0	—
case-12 When listing detail records or invoices with the Telnyx Java SDK, how do we automatically iterate across all available pages in a single loop rather than manually handling page tokens? Show the loop code.	fail→pass	10,549	4,207	-60%	1	1	0%	1,947	3,837	+97%	0	0	—
case-13 Write a Java code snippet using the Telnyx client to update our account's payment auto recharge preferences. Show the client method call.	fail→pass	9,908	6,055	-39%	1	1	0%	2,157	4,292	+99%	0	0	—
case-14 Write a Java snippet using the Telnyx SDK to fetch all user tags associated with the account.	fail→pass	10,415	3,726	-64%	1	1	0%	2,007	3,744	+87%	0	0	—
case-15 We need to monitor our webhook delivery history in Java. Show the Telnyx SDK call used to list webhook deliveries.	fail→pass	8,177	4,904	-40%	1	1	0%	1,597	3,556	+123%	0	0	—
case-16 Write a Java code snippet that retrieves detailed debug data for a specific webhook delivery UUID 'C9C0797E-901D-4349-A33C-C2C8F31A92C2' using the Telnyx SDK.	fail→pass	9,359	6,333	-32%	1	1	0%	2,185	4,419	+102%	0	0	—
case-17 When catching Telnyx SDK network or validation exceptions in Java, what exact method on the exception object provides the HTTP status integer (such as 422 or 429)? Write a try-catch block showing this access.	fail→pass	13,123	3,189	-76%	1	1	0%	2,608	3,552	+36%	0	0	—
case-18 We have an invoice UUID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'. Write a Java snippet using the Telnyx SDK to fetch this specific invoice.	fail→pass	9,163	5,234	-43%	1	1	0%	2,073	4,149	+100%	0	0	—
case-19 Write Java code using the Telnyx SDK to execute a stored payment transaction of $120.00. Show how the amount parameter is set in the builder.	fail→pass	17,876	28,254	+58%	1	1	0%	3,130	4,032	+29%	0	0	—
case-20 Show the standard one-line Java initialization for TelnyxClient when reading the API key from environment variables.	fail→pass	7,669	1,431	-81%	1	1	0%	973	3,156	+224%	0	0	—
case-21 Write Java code using the Telnyx SDK to retrieve a monthly charges breakdown for phone numbers starting on May 1, 2025. Use the SDK builder for parameters.	fail→pass	28,703	4,490	-84%	1	1	0%	3,632	3,902	+7%	0	0	—
case-22 How do you retrieve current payment auto recharge preferences using the Telnyx Java SDK? Provide the exact client method chain.	fail→pass	20,424	2,700	-87%	1	1	0%	2,944	3,411	+16%	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. 22 cases were attempted. The headline lift of +86 percentage points is the difference between those two pass rates over the 22 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 13.6%
Pass rate with the skill: 100%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 0
Skill version measured: v3
Run completed: 8/27/2026, 06:58 UTC

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

Prompt

I need a Java implementation using the Telnyx SDK to check our current account balance and retrieve the charges breakdown for phone numbers during May 2025. Make sure the code assumes standard environment initialization and wraps the API calls with proper error handling for status codes like validation or rate limits.

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 run100

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+121% 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 2 days ago

Model	Method	Date	Lift
gemini-3.6-flash	verified	8/22/2026	+86%

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