{"id":"ea746e5d-a61f-4208-b6eb-fd4f68b9202c","shortId":"hWKCYV","kind":"skill","title":"telnyx-account-curl","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Account - curl\n\n## Installation\n\n```text\n# curl is pre-installed on macOS, Linux, and Windows 10+\n```\n\n## Setup\n\n```bash\nexport TELNYX_API_KEY=\"YOUR_API_KEY_HERE\"\n```\n\nAll examples below use `$TELNYX_API_KEY` for authentication.\n\n## Error Handling\n\nAll API calls can fail with network errors, rate limits (429), validation errors (422),\nor authentication errors (401). Always handle errors in production code:\n\n```bash\n# Check HTTP status code in response\nresponse=$(curl -s -w \"\\n%{http_code}\" \\\n  -X POST \"https://api.telnyx.com/v2/messages\" \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"to\": \"+13125550001\", \"from\": \"+13125550002\", \"text\": \"Hello\"}')\n\nhttp_code=$(echo \"$response\" | tail -1)\nbody=$(echo \"$response\" | sed '$d')\n\ncase $http_code in\n  2*) echo \"Success: $body\" ;;\n  422) echo \"Validation error — check required fields and formats\" ;;\n  429) echo \"Rate limited — retry after delay\"; sleep 1 ;;\n  401) echo \"Authentication failed — check TELNYX_API_KEY\" ;;\n  *)   echo \"Error $http_code: $body\" ;;\nesac\n```\n\nCommon error codes: `401` invalid API key, `403` insufficient permissions,\n`404` resource not found, `422` validation error (check field formats),\n`429` rate limited (retry with exponential backoff).\n\n## Important Notes\n\n- **Pagination:** List endpoints return paginated results. Use `page[number]` and `page[size]` query parameters to navigate pages. Check `meta.total_pages` in the response.\n\n## List Audit Logs\n\nRetrieve a list of audit log entries. Audit logs are a best-effort, eventually consistent record of significant account-related changes.\n\n`GET /audit_events`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/audit_events?sort=desc\"\n```\n\nReturns: `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)\n\n## Get user balance details\n\n`GET /balance`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/balance\"\n```\n\nReturns: `available_credit` (string), `balance` (string), `credit_limit` (string), `currency` (string), `pending` (string), `record_type` (enum: balance)\n\n## Get monthly charges breakdown\n\nRetrieve a detailed breakdown of monthly charges for phone numbers in a specified date range. The date range cannot exceed 31 days.\n\n`GET /charges_breakdown`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/charges_breakdown?start_date=2025-05-01&end_date=2025-06-01&format=json\"\n```\n\nReturns: `currency` (string), `end_date` (date), `results` (array[object]), `start_date` (date), `user_email` (email), `user_id` (string)\n\n## Get monthly charges summary\n\nRetrieve a summary of monthly charges for a specified date range. The date range cannot exceed 31 days.\n\n`GET /charges_summary`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/charges_summary?start_date=2025-05-01&end_date=2025-06-01\"\n```\n\nReturns: `currency` (string), `end_date` (date), `start_date` (date), `summary` (object), `total` (object), `user_email` (email), `user_id` (string)\n\n## Search detail records\n\nSearch for any detail record across the Telnyx Platform\n\n`GET /detail_records`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/detail_records\"\n```\n\nReturns: `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` (array[string]), `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)\n\n## List invoices\n\nRetrieve a paginated list of invoices.\n\n`GET /invoices`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/invoices?sort=period_start\"\n```\n\nReturns: `file_id` (uuid), `invoice_id` (uuid), `paid` (boolean), `period_end` (date), `period_start` (date), `url` (uri)\n\n## Get invoice by ID\n\nRetrieve a single invoice by its unique identifier.\n\n`GET /invoices/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/invoices/550e8400-e29b-41d4-a716-446655440000?action=json\"\n```\n\nReturns: `download_url` (uri), `file_id` (uuid), `invoice_id` (uuid), `paid` (boolean), `period_end` (date), `period_start` (date), `url` (uri)\n\n## List auto recharge preferences\n\nReturns the payment auto recharge preferences.\n\n`GET /payment/auto_recharge_prefs`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/payment/auto_recharge_prefs\"\n```\n\nReturns: `enabled` (boolean), `id` (string), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `record_type` (string), `threshold_amount` (string)\n\n## Update auto recharge preferences\n\nUpdate payment auto recharge preferences.\n\n`PATCH /payment/auto_recharge_prefs`\n\nOptional: `enabled` (boolean), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `threshold_amount` (string)\n\n```bash\ncurl \\\n  -X PATCH \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/payment/auto_recharge_prefs\"\n```\n\nReturns: `enabled` (boolean), `id` (string), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `record_type` (string), `threshold_amount` (string)\n\n## List User Tags\n\nList all user tags.\n\n`GET /user_tags`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/user_tags\"\n```\n\nReturns: `number_tags` (array[string]), `outbound_profile_tags` (array[string])\n\n## Create a stored payment transaction\n\n`POST /v2/payment/stored_payment_transactions` — Required: `amount`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"amount\": \"120.00\"\n}' \\\n  \"https://api.telnyx.com/v2/v2/payment/stored_payment_transactions\"\n```\n\nReturns: `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)\n\n## List webhook deliveries\n\nLists webhook_deliveries for the authenticated user\n\n`GET /webhook_deliveries`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/webhook_deliveries\"\n```\n\nReturns: `attempts` (array[object]), `finished_at` (date-time), `id` (uuid), `record_type` (string), `started_at` (date-time), `status` (enum: delivered, failed), `user_id` (uuid), `webhook` (object)\n\n## Find webhook_delivery details by ID\n\nProvides webhook_delivery debug data, such as timestamps, delivery status and attempts.\n\n`GET /webhook_deliveries/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/webhook_deliveries/C9C0797E-901D-4349-A33C-C2C8F31A92C2\"\n```\n\nReturns: `attempts` (array[object]), `finished_at` (date-time), `id` (uuid), `record_type` (string), `started_at` (date-time), `status` (enum: delivered, failed), `user_id` (uuid), `webhook` (object)","tags":["telnyx","account","curl","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk"],"capabilities":["skill","source-team-telnyx","skill-telnyx-account-curl","topic-agent-skills","topic-ai-coding-agent","topic-claude-code","topic-cpaas","topic-cursor","topic-iot","topic-llm","topic-sdk","topic-sip","topic-sms","topic-speech-to-text","topic-telephony"],"categories":["ai"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/team-telnyx/ai/telnyx-account-curl","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add team-telnyx/ai","source_repo":"https://github.com/team-telnyx/ai","install_from":"skills.sh"}},"qualityScore":"0.533","qualityRationale":"deterministic score 0.53 from registry signals: · indexed on github topic:agent-skills · 167 github stars · SKILL.md body (7,961 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:54:40.033Z","embedding":null,"createdAt":"2026-04-18T22:05:53.134Z","updatedAt":"2026-04-22T12:54:40.033Z","lastSeenAt":"2026-04-22T12:54:40.033Z","tsv":"'+13125550001':98 '+13125550002':100 '-1':108 '/audit_events':233 '/balance':292 '/charges_breakdown':348 '/charges_summary':401 '/detail_records':445 '/invoices':575,617 '/payment/auto_recharge_prefs':661,705 '/user_tags':771 '/v2/audit_events?sort=desc':244 '/v2/balance':303 '/v2/charges_breakdown?start_date=2025-05-01&end_date=2025-06-01&format=json':359 '/v2/charges_summary?start_date=2025-05-01&end_date=2025-06-01':412 '/v2/detail_records':456 '/v2/invoices/550e8400-e29b-41d4-a716-446655440000?action=json':629 '/v2/invoices?sort=period_start':586 '/v2/messages':84 '/v2/payment/auto_recharge_prefs':672,740 '/v2/payment/stored_payment_transactions':799 '/v2/user_tags':782 '/v2/v2/payment/stored_payment_transactions':822 '/v2/webhook_deliveries':875 '/v2/webhook_deliveries/c9c0797e-901d-4349-a33c-c2c8f31a92c2':935 '/webhook_deliveries':864,923 '1':139 '10':20 '120.00':819 '2':118 '31':345,398 '401':59,140,157 '403':161 '404':164 '422':55,122,168 '429':52,131,174 'account':3,6,229,256,258 'account-rel':228 'ach':685,716,753 'across':440 'altern':246 'alway':60 'amount':687,693,718,721,755,761,801,818,824,827 'api':25,28,36,43,89,146,159,240,299,355,408,452,582,625,668,731,778,810,871,931 'api.telnyx.com':83,243,302,358,411,455,585,628,671,739,781,821,874,934 'api.telnyx.com/v2/audit_events?sort=desc':242 'api.telnyx.com/v2/balance':301 'api.telnyx.com/v2/charges_breakdown?start_date=2025-05-01&end_date=2025-06-01&format=json':357 'api.telnyx.com/v2/charges_summary?start_date=2025-05-01&end_date=2025-06-01':410 'api.telnyx.com/v2/detail_records':454 'api.telnyx.com/v2/invoices/550e8400-e29b-41d4-a716-446655440000?action=json':627 'api.telnyx.com/v2/invoices?sort=period_start':584 'api.telnyx.com/v2/messages':82 'api.telnyx.com/v2/payment/auto_recharge_prefs':670,738 'api.telnyx.com/v2/user_tags':780 'api.telnyx.com/v2/v2/payment/stored_payment_transactions':820 'api.telnyx.com/v2/webhook_deliveries':873 'api.telnyx.com/v2/webhook_deliveries/c9c0797e-901d-4349-a33c-c2c8f31a92c2':933 'application/json':95,737,816 'array':266,367,502,786,791,878,938 'attempt':877,921,937 'audit':207,213,216 'authent':39,57,142,861 'author':86,237,296,352,405,449,579,622,665,728,775,807,868,928 'auto':651,657,696,701,830 'avail':305 'backoff':180 'balanc':289,308,320 'bash':22,66,234,293,349,402,446,576,619,662,723,772,802,865,925 'bearer':87,238,297,353,406,450,580,623,666,729,776,808,869,929 'best':221 'best-effort':220 'bodi':109,121,152 'boolean':505,518,595,641,675,680,708,711,743,748,832 'breakdown':324,328 'call':44 'cannot':343,396 'carrier':458,460 'case':114 'cent':825 'chang':231,251,262,265 'charg':323,331,380,387 'check':67,126,144,171,200 'cld':463 'cli':465 'code':65,70,79,104,116,151,156,475,539 'common':154 'complet':467 'consist':224 'content':93,735,814 'content-typ':92,734,813 'cost':472 'countri':474,538 'creat':268,477,793,833 'credit':306,310,683,714,751 'curl':4,7,10,74,235,294,350,403,447,577,620,663,724,773,803,866,926 'currenc':313,361,414,482,828 'd':96,113,817 'data':914 'date':271,338,341,364,365,370,371,391,394,417,418,420,421,470,480,535,559,598,601,644,647,836,883,893,943,953 'date-tim':270,469,479,534,558,835,882,892,942,952 'day':346,399 'debug':913 'delay':137 'deliv':545,897,957 'deliveri':484,487,492,855,858,906,912,918 'detail':290,327,433,438,907 'direct':497 'dlr':546,548 'download':631 'echo':105,110,119,123,132,141,148 'effort':222 'email':373,374,427,428 'enabl':674,679,707,710,742,747 'end':363,416,597,643 'endpoint':185 'entri':215 'enum':254,319,498,510,542,682,713,750,845,850,896,956 'error':40,49,54,58,62,125,149,155,170,501 'esac':153 'eventu':223 'exampl':32 'exceed':344,397 'exponenti':179 'export':23 'fail':46,143,553,898,958 'failov':489 'fee':461 'field':128,172 'file':588,634 'find':904 'finish':880,940 'format':130,173 'found':167 'fteu':504 'get':232,287,291,321,347,378,400,444,574,604,616,660,770,863,922 'gw':543,551 'h':85,91,236,295,351,404,448,578,621,664,727,733,774,806,812,867,927 'handl':41,61 'hello':102 'http':68,78,103,115,150 'id':248,273,276,282,285,376,430,522,562,589,592,607,618,635,638,676,744,838,885,900,909,924,945,960 'identifi':615 'import':181 'inbound':499 'instal':8,14 'insuffici':162 'integ':520,826 'invalid':158 'invoic':567,573,591,605,611,637,678,709,746 'key':26,29,37,90,147,160,241,300,356,409,453,583,626,669,732,779,811,872,932 'limit':51,134,176,311 'linux':17 'list':184,206,211,566,571,650,763,766,853,856 'log':208,214,217 'maco':16 'made':252 'manag':257 'mcc':506 'member':261 'messag':508 'meta.total':201 'mms':512 'mnc':514 'month':322,330,379,386 'n':77 'name':525 'navig':198 'net':517 'network':48 'note':182 'null':250,267 'number':191,334,784 'object':368,423,425,879,903,939,963 'option':706 'organ':260,275 'outbound':500,788 'owner':259 'page':190,193,199,202 'pagin':183,187,570 'paid':594,640 'paramet':196 'part':519 'patch':704,726 'payment':656,700,796,852 'paypal':684,715,752 'pend':315 'period':596,599,642,645 'permiss':163 'phone':333 'platform':443 'post':81,798,805 'pre':13 'pre-instal':12 'prefer':653,659,681,698,703,712,749 'process':848 'processor':840 'product':64 'profil':521,524,789 'provid':910 'queri':195 'rang':339,342,392,395 'rate':50,133,175,527 'rcs':513 'receiv':550 'recharg':652,658,686,697,702,717,754,831 'record':225,278,317,434,439,529,689,757,843,887,947 'reject':552 'relat':230 'requir':127,800 'resourc':165,247,281 'respons':72,73,106,111,205 'result':188,366 'retri':135,177 'retriev':209,325,382,568,608 'return':186,245,304,360,413,457,587,630,654,673,741,783,823,876,936 'search':432,435 'sed':112 'sent':532 'setup':21 'signific':227 'singl':610 'size':194 'skill' 'skill-telnyx-account-curl' 'sleep':138 'sms':511 'sourc':537 'source-team-telnyx' 'specifi':337,390 'start':369,419,600,646,890,950 'status':69,485,488,493,541,841,895,919,955 'store':795,851 'string':249,264,280,283,307,309,312,314,316,362,377,415,431,459,462,464,466,473,476,483,486,491,496,503,507,515,523,526,528,531,540,555,563,565,677,688,691,694,719,722,745,756,759,762,787,792,829,839,842,889,949 'success':120 'summari':381,384,422 'tag':554,765,769,785,790 'tail':107 'telnyx':2,5,24,35,88,145,239,255,298,354,407,442,451,581,624,667,730,777,809,870,930 'telnyx-account-curl':1 'text':9,101 'threshold':692,720,760 'time':272,471,481,536,560,837,884,894,944,954 'timeout':544,549 'timestamp':917 'topic-agent-skills' 'topic-ai-coding-agent' 'topic-claude-code' 'topic-cpaas' 'topic-cursor' 'topic-iot' 'topic-llm' 'topic-sdk' 'topic-sip' 'topic-sms' 'topic-speech-to-text' 'topic-telephony' 'total':424 'transact':797,846,847 'type':94,263,279,318,509,530,690,736,758,815,844,849,888,948 'unconfirm':547 'uniqu':614 'updat':556,695,699 'uri':603,633,649 'url':490,495,602,632,648 'use':34,189 'user':284,288,372,375,426,429,561,764,768,862,899,959 'uuid':274,277,286,564,590,593,636,639,886,901,946,961 'valid':53,124,169 'w':76 'webhook':494,854,857,902,905,911,962 'window':19 'x':80,725,804","prices":[{"id":"96138523-556f-47ac-943f-dcc2f5a32ad1","listingId":"ea746e5d-a61f-4208-b6eb-fd4f68b9202c","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"team-telnyx","category":"ai","install_from":"skills.sh"},"createdAt":"2026-04-18T22:05:53.134Z"}],"sources":[{"listingId":"ea746e5d-a61f-4208-b6eb-fd4f68b9202c","source":"github","sourceId":"team-telnyx/ai/telnyx-account-curl","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-curl","isPrimary":false,"firstSeenAt":"2026-04-18T22:05:53.134Z","lastSeenAt":"2026-04-22T12:54:40.033Z"}],"details":{"listingId":"ea746e5d-a61f-4208-b6eb-fd4f68b9202c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-account-curl","github":{"repo":"team-telnyx/ai","stars":167,"topics":["agent-skills","ai","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk","sip","sms","speech-to-text","telephony","telnyx","tts","twilio-migration","voice-agents","voice-ai","webrtc","windsurf"],"license":"mit","html_url":"https://github.com/team-telnyx/ai","pushed_at":"2026-04-21T22:09:49Z","description":"Official one-stop shop for AI Agents and developers building with Telnyx.","skill_md_sha":"a8ebf78e2fcb65dd57e67d1e973455a84b236507","skill_md_path":"skills/telnyx-account-curl/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-curl"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-account-curl","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-account-curl"},"updatedAt":"2026-04-22T12:54:40.033Z"}}