Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Account Reports - curl · team-telnyx | DecimalAI

team-telnyx/telnyx-account-reports-curl

SkillScore100Maintained

Generate and retrieve usage reports for billing, analytics, and reconciliation. This skill provides REST API (curl) examples.

financeby 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-curl/SKILL.md

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

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

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

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

—+561% tokens0% turns100% of whole cases pass with skill (22/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	299%	0%
case-02	✗→✓	▲ Improved	573%	0%
case-04	✗→✓	▲ Improved	882%	0%
case-05	✗→✓	▲ Improved	328%	0%
case-06	✗→✓	▲ Improved	473%	0%

Showing 5 of 22 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-curl/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v2

Skill contents

SKILL.md

Telnyx Account Reports - curl

Installation

text
# curl is pre-installed on macOS, Linux, and Windows 10+

Setup

bash
export TELNYX_API_KEY="YOUR_API_KEY_HERE"

All examples below use $TELNYX_API_KEY for authentication.

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:

bash
# Check HTTP status code in response
response=$(curl -s -w "\n%{http_code}" \
  -X POST "https://api.telnyx.com/v2/messages" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+13125550001", "from": "+13125550002", "text": "Hello"}')

http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | sed '$d')

case $http_code in
  2*) echo "Success: $body" ;;
  422) echo "Validation error — check required fields and formats" ;;
  429) echo "Rate limited — retry after delay"; sleep 1 ;;
  401) echo "Authentication failed — check TELNYX_API_KEY" ;;
  *)   echo "Error $http_code: $body" ;;
esac

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 endpoints return paginated results. Use page[number] and page[size] query parameters to navigate pages. Check meta.total_pages in the response.

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/call_events"

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)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2019,
  "month": 10
}' \
  "https://api.telnyx.com/v2/ledger_billing_group_reports"

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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/ledger_billing_group_reports/f5586561-8ff0-4291-a0ac-84fe544797bd"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/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)

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)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "start_time": "2024-02-01T00:00:00Z",
  "end_time": "2024-02-12T23:59:59Z"
}' \
  "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/messaging/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/messaging/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/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)

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)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "start_time": "2024-02-01T00:00:00Z",
  "end_time": "2024-02-12T23:59:59Z"
}' \
  "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/voice/fields"

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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/voice/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/legacy/reporting/batch_detail_records/voice/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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)

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

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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)

Submit telco data usage report

Submit a new telco data usage report

POST /legacy/reporting/usage_reports/number_lookup

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/number_lookup/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/number_lookup/550e8400-e29b-41d4-a716-446655440000"

List CDR usage reports

Fetch all previous requests for cdr usage reports.

GET /legacy/reporting/usage_reports/voice

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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)

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

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/legacy/reporting/usage_reports/voice/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/legacy/reporting/usage_reports/voice/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/csv_downloads"

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

Create a CSV download

POST /phone_numbers/csv_downloads

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/phone_numbers/csv_downloads"

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

Retrieve a CSV download

GET /phone_numbers/csv_downloads/{id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/csv_downloads/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/cdr_usage_reports/sync?start_date=2020-07-01T00:00:00-06:00&end_date=2020-07-01T00:00:00-06:00&aggregation_type=NO_AGGREGATION&product_breakdown=NO_BREAKDOWN&connections=[1234567890123]"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/mdr_usage_reports"

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

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/reports/mdr_usage_reports"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/mdr_usage_reports/sync?start_date=2020-07-01T00:00:00-06:00&end_date=2020-07-01T00:00:00-06:00&aggregation_type=PROFILE&profiles=['My profile']"

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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/mdr_usage_reports/550e8400-e29b-41d4-a716-446655440000"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/reports/mdr_usage_reports/550e8400-e29b-41d4-a716-446655440000"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/mdrs?id=e093fbe0-5bde-11eb-ae93-0242ac130002&direction=INBOUND&profile=My profile&cld=+15551237654&cli=+15551237654&status=DELIVERED&message_type=SMS"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/reports/wdrs?start_date=2021-05-01T00:00:00Z&end_date=2021-06-01T00:00:00Z&id=e093fbe0-5bde-11eb-ae93-0242ac130002&mcc=204&mnc=01&imsi=123456&sim_group_name=sim name&sim_group_id=f05a189f-7c46-4531-ac56-1460dc465a42&sim_card_id=877f80a6-e5b2-4687-9a04-88076265720f&phone_number=+12345678910&sort=['created_at']"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/session_analysis/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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/session_analysis/metadata/{record_type}"

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}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/session_analysis/{record_type}/{event_id}"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/usage_reports"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/usage_reports/options"

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

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/wireless/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)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/wireless/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)

Get a Wireless Detail Record (WDR) Report

Returns one specific WDR report

GET /wireless/detail_records_reports/{id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/wireless/detail_records_reports/6a09cdc3-8948-47f0-aa62-74ac943d6c58"

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}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/wireless/detail_records_reports/6a09cdc3-8948-47f0-aa62-74ac943d6c58"

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-curl would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/22/2026, 08:38 UTC · 22 cases

Measured on 21 comparable cases — below the 22 needed to publish a lift, so this result is shown here but not on the registry card or leaderboard.

Lift

+73%

100% vs 27%

Agent turns

0%

1.0 vs 1.0

Tokens

+561%

10,699.43 vs 1,619.95

fail → pass · 16pass → pass · 6

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 terminal command using curl to request a batch Messaging Detail Record (MDR) report from Telnyx for the period between Feb 1, 2024 and Feb 12, 2024. Please provide a complete bash snippet that sends the request using my Telnyx API key environment variable and includes basic status code checking for common API errors.	fail→pass	13,657	7,664	-44%	1	1	0%	2,908	11,615	+299%	0	0	—
case-02 Can you give me a curl snippet to synchronously fetch a voice CDR usage report from Telnyx for a specific start and end timestamp so I don't have to poll for completion? I want to see the command formatted with HTTP bearer token authentication.	fail→pass	8,371	4,603	-45%	1	1	0%	1,619	10,902	+573%	0	0	—
case-03 I want to generate a Wireless Detail Record (WDR) report for my active IoT SIM cards using Telnyx's API via curl, and then check the status of that report once it's created. Please write out the curl statements for both initiating the report generation and fetching the report details using its unique ID.	pass→pass	9,935	6,590	-34%	1	1	0%	2,003	11,407	+469%	0	0	—
case-04 I want to see what fields are available for customizing my Telnyx Voice Call Detail Record (CDR) batch reports before creating one. What cURL request should I run to inspect the available report fields?	fail→pass	6,330	2,875	-55%	1	1	0%	1,059	10,404	+882%	0	0	—
case-05 I am building an automated diagnostic tool to inspect call session trees. I want to query Telnyx's API for session analysis metadata to see all supported record types and query parameters. Which curl endpoint should I call?	fail→pass	13,608	2,359	-83%	1	1	0%	2,422	10,376	+328%	0	0	—
case-06 Write a curl command to generate a monthly ledger billing group report in Telnyx for October 2019. I usually default to standard GET requests on /v2/billing, but I need the correct endpoint and method for ledger billing group report generation.	fail→pass	9,683	3,934	-59%	1	1	0%	1,865	10,681	+473%	0	0	—
case-07 I need a curl command to instantly generate and retrieve a messaging usage report aggregated by profile without polling an asynchronous report queue. What endpoint allows synchronous fetching for MDR usage reports?	fail→pass	13,308	3,542	-73%	1	1	0%	2,152	10,584	+392%	0	0	—
case-08 I need to search raw individual messaging record logs directly on Telnyx using curl, filtering by message status DELIVERED and direction INBOUND. Many users try calling /v2/messaging/logs, but what is the exact reports endpoint for fetching raw MDR entries?	fail→pass	12,285	4,398	-64%	1	1	0%	2,409	10,747	+346%	0	0	—
case-09 Provide a curl command to query individual cellular data session records (WDRs) on Telnyx between May 1 and June 1, 2021. I want to query the records endpoint directly rather than creating an asynchronous report job.	fail→pass	8,589	5,141	-40%	1	1	0%	1,674	10,993	+557%	0	0	—
case-10 Provide a curl request to trigger a new CSV export download of all phone numbers in a Telnyx account.	pass→pass	8,359	3,454	-59%	1	1	0%	1,563	10,609	+579%	0	0	—
case-11 Write a curl request to retrieve recent call events ordered by occurred_at for call leg analysis on Telnyx.	pass→pass	8,797	4,958	-44%	1	1	0%	1,617	10,858	+571%	0	0	—
case-12 Show me the curl command to cancel and delete an existing batch messaging detail record (MDR) report request with ID 550e8400-e29b-41d4-a716-446655440000 on Telnyx.	fail→pass	4,199	2,509	-40%	1	1	0%	864	10,461	+1111%	0	0	—
case-13 I created a batch voice CDR report by mistake on Telnyx with ID 550e8400-e29b-41d4-a716-446655440000. Give me a curl command to delete this specific voice CDR report request.	fail→pass	5,597	2,399	-57%	1	1	0%	1,168	10,415	+792%	0	0	—
case-14 What curl command should I run to list all previous telco data usage reports (number lookup usage reports) in Telnyx?	fail→pass	6,459	8,856	+37%	1	1	0%	1,192	10,476	+779%	0	0	—
case-15 Write a curl command to query Telnyx's usage report query options (BETA) to find available product dimensions and metrics.	pass→pass	6,867	3,074	-55%	1	1	0%	1,318	10,402	+689%	0	0	—
case-16 I have a specific event ID 1234-abcd and record type call. What curl command fetches the full session analysis tree including child events and root cost breakdown?	fail→pass	9,578	2,772	-71%	1	1	0%	1,572	10,443	+564%	0	0	—
case-17 Provide a curl snippet to initiate a new Voice Call Detail Record (CDR) batch report request for the period covering Feb 1, 2024 to Feb 12, 2024.	fail→pass	7,206	4,331	-40%	1	1	0%	1,364	10,785	+691%	0	0	—
case-18 Provide the curl command to create a new legacy V2 CDR usage report request.	fail→pass	12,288	2,109	-83%	1	1	0%	2,072	10,250	+395%	0	0	—
case-19 Write a curl command to delete a specific wireless detail record (WDR) report with ID 6a09cdc3-8948-47f0-aa62-74ac943d6c58.	fail→pass	5,176	2,142	-59%	1	1	0%	932	10,339	+1009%	0	0	—
case-20 How do I send an outbound SMS text message to +13125550001 from +13125550002 with the body 'Hello World' using curl and my Telnyx API key?	pass→pass	5,089	3,748	-26%	1	1	0%	980	10,690	+991%	0	0	—
case-21 Write a curl command to search for and order an available US toll-free phone number on Telnyx.	fail→pass	18,508	7,355	-60%	1	1	0%	912	11,495	+1160%	0	0	—
case-22 How do I create a new credential-based SIP connection on Telnyx using curl? Provide the cURL request for setting up the connection.	pass→pass	12,121	6,807	-44%	1	1	0%	1,266	11,251	+789%	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, and 21 counted toward the lift figure. The other 1 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +73 percentage points is the difference between those two pass rates over the 21 comparable cases.

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

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

Prompt

I need a terminal command using curl to request a batch Messaging Detail Record (MDR) report from Telnyx for the period between Feb 1, 2024 and Feb 12, 2024. Please provide a complete bash snippet that sends the request using my Telnyx API key environment variable and includes basic status code checking for common API errors.

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

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