{"id":"ab535a1c-969e-4529-8f61-22223412e16c","shortId":"SsjhKh","kind":"skill","title":"telnyx-porting-out-curl","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Porting Out - 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 portout requests\n\nReturns the portout requests according to filters\n\n`GET /portouts`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts\"\n```\n\nReturns: `already_ported` (boolean), `authorized_name` (string), `carrier_name` (string), `city` (string), `created_at` (string), `current_carrier` (string), `end_user_name` (string), `foc_date` (string), `host_messaging` (boolean), `id` (string), `inserted_at` (string), `lsr` (array[string]), `phone_numbers` (array[string]), `pon` (string), `reason` (string | null), `record_type` (string), `rejection_code` (integer), `requested_foc_date` (string), `service_address` (string), `spid` (string), `state` (string), `status` (enum: pending, authorized, ported, rejected, rejected-pending, canceled), `support_key` (string), `updated_at` (string), `user_id` (uuid), `vendor` (uuid), `zip` (string)\n\n## List all port-out events\n\nReturns a list of all port-out events.\n\n`GET /portouts/events`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/events\"\n```\n\nReturns: `available_notification_methods` (array[string]), `created_at` (date-time), `event_type` (enum: portout.status_changed, portout.foc_date_changed, portout.new_comment), `id` (uuid), `payload` (object), `payload_status` (enum: created, completed), `portout_id` (uuid), `record_type` (string), `updated_at` (date-time)\n\n## Show a port-out event\n\nShow a specific port-out event.\n\n`GET /portouts/events/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `available_notification_methods` (array[string]), `created_at` (date-time), `event_type` (enum: portout.status_changed, portout.foc_date_changed, portout.new_comment), `id` (uuid), `payload` (object), `payload_status` (enum: created, completed), `portout_id` (uuid), `record_type` (string), `updated_at` (date-time)\n\n## Republish a port-out event\n\nRepublish a specific port-out event.\n\n`POST /portouts/events/{id}/republish`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000/republish\"\n```\n\n## List eligible port-out rejection codes for a specific order\n\nGiven a port-out ID, list rejection codes that are eligible for that port-out\n\n`GET /portouts/rejections/{portout_id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/rejections/329d6658-8f93-405d-862f-648776e8afd7\"\n```\n\nReturns: `code` (integer), `description` (string), `reason_required` (boolean)\n\n## List port-out related reports\n\nList the reports generated about port-out operations.\n\n`GET /portouts/reports`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/reports\"\n```\n\nReturns: `created_at` (date-time), `document_id` (uuid), `id` (uuid), `params` (object), `record_type` (string), `report_type` (enum: export_portouts_csv), `status` (enum: pending, completed), `updated_at` (date-time)\n\n## Create a port-out related report\n\nGenerate reports about port-out operations.\n\n`POST /portouts/reports`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/portouts/reports\"\n```\n\nReturns: `created_at` (date-time), `document_id` (uuid), `id` (uuid), `params` (object), `record_type` (string), `report_type` (enum: export_portouts_csv), `status` (enum: pending, completed), `updated_at` (date-time)\n\n## Retrieve a report\n\nRetrieve a specific report generated.\n\n`GET /portouts/reports/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/reports/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `created_at` (date-time), `document_id` (uuid), `id` (uuid), `params` (object), `record_type` (string), `report_type` (enum: export_portouts_csv), `status` (enum: pending, completed), `updated_at` (date-time)\n\n## Get a portout request\n\nReturns the portout request based on the ID provided\n\n`GET /portouts/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `already_ported` (boolean), `authorized_name` (string), `carrier_name` (string), `city` (string), `created_at` (string), `current_carrier` (string), `end_user_name` (string), `foc_date` (string), `host_messaging` (boolean), `id` (string), `inserted_at` (string), `lsr` (array[string]), `phone_numbers` (array[string]), `pon` (string), `reason` (string | null), `record_type` (string), `rejection_code` (integer), `requested_foc_date` (string), `service_address` (string), `spid` (string), `state` (string), `status` (enum: pending, authorized, ported, rejected, rejected-pending, canceled), `support_key` (string), `updated_at` (string), `user_id` (uuid), `vendor` (uuid), `zip` (string)\n\n## List all comments for a portout request\n\nReturns a list of comments for a portout request.\n\n`GET /portouts/{id}/comments`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/comments\"\n```\n\nReturns: `body` (string), `created_at` (string), `id` (string), `portout_id` (string), `record_type` (string), `user_id` (string)\n\n## Create a comment on a portout request\n\nCreates a comment on a portout request.\n\n`POST /portouts/{id}/comments`\n\nOptional: `body` (string)\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/comments\"\n```\n\nReturns: `body` (string), `created_at` (string), `id` (string), `portout_id` (string), `record_type` (string), `user_id` (string)\n\n## List supporting documents on a portout request\n\nList every supporting documents for a portout request.\n\n`GET /portouts/{id}/supporting_documents`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/supporting_documents\"\n```\n\nReturns: `created_at` (string), `document_id` (uuid), `id` (uuid), `portout_id` (uuid), `record_type` (string), `type` (enum: loa, invoice), `updated_at` (string)\n\n## Create a list of supporting documents on a portout request\n\nCreates a list of supporting documents on a portout request.\n\n`POST /portouts/{id}/supporting_documents`\n\nOptional: `documents` (array[object])\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/supporting_documents\"\n```\n\nReturns: `created_at` (string), `document_id` (uuid), `id` (uuid), `portout_id` (uuid), `record_type` (string), `type` (enum: loa, invoice), `updated_at` (string)\n\n## Update Status\n\nAuthorize or reject portout request\n\n`PATCH /portouts/{id}/{status}` — Required: `reason`\n\nOptional: `host_messaging` (boolean)\n\n```bash\ncurl \\\n  -X PATCH \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"reason\": \"I do not recognize this transaction\"\n}' \\\n  \"https://api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/{status}\"\n```\n\nReturns: `already_ported` (boolean), `authorized_name` (string), `carrier_name` (string), `city` (string), `created_at` (string), `current_carrier` (string), `end_user_name` (string), `foc_date` (string), `host_messaging` (boolean), `id` (string), `inserted_at` (string), `lsr` (array[string]), `phone_numbers` (array[string]), `pon` (string), `reason` (string | null), `record_type` (string), `rejection_code` (integer), `requested_foc_date` (string), `service_address` (string), `spid` (string), `state` (string), `status` (enum: pending, authorized, ported, rejected, rejected-pending, canceled), `support_key` (string), `updated_at` (string), `user_id` (uuid), `vendor` (uuid), `zip` (string)","tags":["telnyx","porting","out","curl","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm"],"capabilities":["skill","source-team-telnyx","skill-telnyx-porting-out-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-porting-out-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 (9,616 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-22T06:54:46.149Z","embedding":null,"createdAt":"2026-04-18T22:07:32.428Z","updatedAt":"2026-04-22T06:54:46.149Z","lastSeenAt":"2026-04-22T06:54:46.149Z","tsv":"'+13125550001':100 '+13125550002':102 '-1':110 '/comments':847,893 '/portouts':219,730,845,891,948,1005,1060 '/portouts/events':332,399,467 '/portouts/rejections':517 '/portouts/reports':555,613,672 '/republish':469 '/supporting_documents':950,1007 '/v2/messages':86 '/v2/portouts':230 '/v2/portouts/550e8400-e29b-41d4-a716-446655440000':742 '/v2/portouts/550e8400-e29b-41d4-a716-446655440000/':1094 '/v2/portouts/550e8400-e29b-41d4-a716-446655440000/comments':858,914 '/v2/portouts/550e8400-e29b-41d4-a716-446655440000/supporting_documents':961,1029 '/v2/portouts/events':343 '/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000':411 '/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000/republish':487 '/v2/portouts/rejections/329d6658-8f93-405d-862f-648776e8afd7':530 '/v2/portouts/reports':566,631 '/v2/portouts/reports/550e8400-e29b-41d4-a716-446655440000':684 '1':141 '10':22 '2':120 '401':61,142,159 '403':163 '404':166 '422':57,124,170 '429':54,133,176 'accord':215 'address':287,799,1152 'alreadi':232,744,1097 'alway':62 'api':27,30,38,45,91,148,161,226,339,407,478,526,562,622,680,738,854,905,957,1020,1077 'api.telnyx.com':85,229,342,410,486,529,565,630,683,741,857,913,960,1028,1093 'api.telnyx.com/v2/messages':84 'api.telnyx.com/v2/portouts':228 'api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000':740 'api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/':1092 'api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/comments':856,912 'api.telnyx.com/v2/portouts/550e8400-e29b-41d4-a716-446655440000/supporting_documents':959,1027 'api.telnyx.com/v2/portouts/events':341 'api.telnyx.com/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000':409 'api.telnyx.com/v2/portouts/events/550e8400-e29b-41d4-a716-446655440000/republish':485 'api.telnyx.com/v2/portouts/rejections/329d6658-8f93-405d-862f-648776e8afd7':528 'api.telnyx.com/v2/portouts/reports':564,629 'api.telnyx.com/v2/portouts/reports/550e8400-e29b-41d4-a716-446655440000':682 'application/json':97,484,628,911,1026,1083 'array':265,269,348,416,777,781,1010,1130,1134 'authent':41,59,144 'author':88,223,235,296,336,404,475,523,559,619,677,735,747,808,851,902,954,1017,1054,1074,1100,1161 'avail':345,413 'backoff':182 'base':724 'bash':24,68,220,333,401,470,520,556,614,674,732,848,897,951,1012,1069 'bearer':89,224,337,405,476,524,560,620,678,736,852,903,955,1018,1075 'bodi':111,123,154,860,895,916 'boolean':234,258,538,746,770,1068,1099,1123 'call':46 'cancel':302,814,1167 'carrier':238,247,750,759,1103,1112 'case':116 'chang':359,362,427,430 'check':69,128,146,173,202 'citi':241,753,1106 'code':67,72,81,106,118,153,158,280,494,507,532,792,1145 'comment':364,432,830,839,878,885 'common':156 'complet':373,441,592,657,710 'content':95,482,626,909,1024,1081 'content-typ':94,481,625,908,1023,1080 'creat':243,350,372,418,440,568,598,633,686,755,862,876,883,918,963,984,994,1031,1108 'csv':588,653,706 'curl':5,9,12,76,221,334,402,471,521,557,615,675,733,849,898,952,1013,1070 'current':246,758,1111 'd':98,115,1084 'date':254,284,353,361,383,421,429,451,571,596,636,661,689,714,766,796,1119,1149 'date-tim':352,382,420,450,570,595,635,660,688,713 'delay':139 'descript':534 'document':573,638,691,934,942,966,989,999,1009,1034 'echo':107,112,121,125,134,143,150 'elig':489,510 'end':249,761,1114 'endpoint':187 'enum':294,357,371,425,439,585,590,650,655,703,708,806,978,1046,1159 'error':42,51,56,60,64,127,151,157,172 'esac':155 'event':321,330,355,390,397,423,458,465 'everi':940 'exampl':34 'exponenti':181 'export':25,586,651,704 'fail':48,145 'field':130,174 'filter':217 'foc':253,283,765,795,1118,1148 'format':132,175 'found':169 'generat':548,605,670 'get':218,331,398,516,554,671,716,729,844,947 'given':499 'h':87,93,222,335,403,474,480,522,558,618,624,676,734,850,901,907,953,1016,1022,1073,1079 'handl':43,63 'hello':104 'host':256,768,1066,1121 'http':70,80,105,117,152 'id':259,310,365,375,400,433,443,468,504,519,574,576,639,641,673,692,694,727,731,771,822,846,865,868,874,892,921,924,930,949,967,969,972,1006,1035,1037,1040,1061,1124,1175 'import':183 'insert':261,773,1126 'instal':10,16 'insuffici':164 'integ':281,533,793,1146 'invalid':160 'invoic':980,1048 'key':28,31,39,92,149,162,227,304,340,408,479,527,563,623,681,739,816,855,906,958,1021,1078,1169 'limit':53,136,178 'linux':19 'list':186,208,316,324,488,505,539,545,828,837,932,939,986,996 'loa':979,1047 'lsr':264,776,1129 'maco':18 'messag':257,769,1067,1122 'meta.total':203 'method':347,415 'n':79 'name':236,239,251,748,751,763,1101,1104,1116 'navig':200 'network':50 'note':184 'notif':346,414 'null':275,787,1140 'number':193,268,780,1133 'object':368,436,579,644,697,1011 'oper':553,611 'option':894,1008,1065 'order':498 'page':192,195,201,204 'pagin':185,189 'param':578,643,696 'paramet':198 'patch':1059,1072 'payload':367,369,435,437 'pend':295,301,591,656,709,807,813,1160,1166 'permiss':165 'phone':267,779,1132 'pon':271,783,1136 'port':3,7,233,297,319,328,388,395,456,463,491,502,514,541,551,601,609,745,809,1098,1162 'port-out':318,327,387,394,455,462,490,501,513,540,550,600,608 'portout':209,213,374,442,518,587,652,705,718,722,833,842,867,881,888,923,937,945,971,992,1002,1039,1057 'portout.foc':360,428 'portout.new':363,431 'portout.status':358,426 'post':83,466,473,612,617,890,900,1004,1015 'pre':15 'pre-instal':14 'product':66 'provid':728 'queri':197 'rate':52,135,177 'reason':273,536,785,1064,1085,1138 'recogn':1089 'record':276,377,445,580,645,698,788,870,926,974,1042,1141 'reject':279,298,300,493,506,791,810,812,1056,1144,1163,1165 'rejected-pend':299,811,1164 'relat':543,603 'report':544,547,583,604,606,648,665,669,701 'republish':453,459 'request':210,214,282,719,723,794,834,843,882,889,938,946,993,1003,1058,1147 'requir':129,537,1063 'resourc':167 'respons':74,75,108,113,207 'result':190 'retri':137,179 'retriev':663,666 'return':188,211,231,322,344,412,531,567,632,685,720,743,835,859,915,962,1030,1096 'sed':114 'servic':286,798,1151 'setup':23 'show':385,391 'size':196 'skill' 'skill-telnyx-porting-out-curl' 'sleep':140 'source-team-telnyx' 'specif':393,461,497,668 'spid':289,801,1154 'state':291,803,1156 'status':71,293,370,438,589,654,707,805,1053,1062,1095,1158 'string':237,240,242,245,248,252,255,260,263,266,270,272,274,278,285,288,290,292,305,308,315,349,379,417,447,535,582,647,700,749,752,754,757,760,764,767,772,775,778,782,784,786,790,797,800,802,804,817,820,827,861,864,866,869,872,875,896,917,920,922,925,928,931,965,976,983,1033,1044,1051,1102,1105,1107,1110,1113,1117,1120,1125,1128,1131,1135,1137,1139,1143,1150,1153,1155,1157,1170,1173,1180 'success':122 'support':303,815,933,941,988,998,1168 'tail':109 'telnyx':2,6,26,37,90,147,225,338,406,477,525,561,621,679,737,853,904,956,1019,1076 'telnyx-porting-out-curl':1 'text':11,103 'time':354,384,422,452,572,597,637,662,690,715 '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' 'transact':1091 'type':96,277,356,378,424,446,483,581,584,627,646,649,699,702,789,871,910,927,975,977,1025,1043,1045,1082,1142 'updat':306,380,448,593,658,711,818,981,1049,1052,1171 'use':36,191 'user':250,309,762,821,873,929,1115,1174 'uuid':311,313,366,376,434,444,575,577,640,642,693,695,823,825,968,970,973,1036,1038,1041,1176,1178 'valid':55,126,171 'vendor':312,824,1177 'w':78 'window':21 'x':82,472,616,899,1014,1071 'zip':314,826,1179","prices":[{"id":"e76c9b8c-4c88-4809-af14-0f672819b729","listingId":"ab535a1c-969e-4529-8f61-22223412e16c","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:07:32.428Z"}],"sources":[{"listingId":"ab535a1c-969e-4529-8f61-22223412e16c","source":"github","sourceId":"team-telnyx/ai/telnyx-porting-out-curl","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-porting-out-curl","isPrimary":false,"firstSeenAt":"2026-04-18T22:07:32.428Z","lastSeenAt":"2026-04-22T06:54:46.149Z"}],"details":{"listingId":"ab535a1c-969e-4529-8f61-22223412e16c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-porting-out-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":"5c29470734506136c9c15ade8d159a1ec73db3c8","skill_md_path":"skills/telnyx-porting-out-curl/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-porting-out-curl"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-porting-out-curl","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-porting-out-curl"},"updatedAt":"2026-04-22T06:54:46.149Z"}}