{"id":"403646f5-a380-4d88-8968-4819f3788a95","shortId":"AgzKTC","kind":"skill","title":"telnyx-messaging-hosted-curl","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Messaging Hosted - 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- **Phone numbers** must be in E.164 format (e.g., `+13125550001`). Include the `+` prefix and country code. No spaces, dashes, or parentheses.\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## Send an RCS message\n\n`POST /messages/rcs` — Required: `agent_id`, `to`, `messaging_profile_id`, `agent_message`\n\nOptional: `mms_fallback` (object), `sms_fallback` (object), `type` (enum: RCS), `webhook_url` (url)\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"agent_id\": \"Agent007\",\n  \"to\": \"+13125551234\",\n  \"messaging_profile_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"agent_message\": {}\n}' \\\n  \"https://api.telnyx.com/v2/messages/rcs\"\n```\n\nReturns: `body` (object), `direction` (string), `encoding` (string), `from` (object), `id` (string), `messaging_profile_id` (string), `organization_id` (string), `received_at` (date-time), `record_type` (string), `to` (array[object]), `type` (string), `wait_seconds` (float)\n\n## Generate RCS deeplink\n\nGenerate a deeplink URL that can be used to start an RCS conversation with a specific agent.\n\n`GET /messages/rcs/deeplinks/{agent_id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messages/rcs/deeplinks/{agent_id}?phone_number=%2B18445550001&body=hello%20world\"\n```\n\nReturns: `url` (string)\n\n## List all RCS agents\n\n`GET /messaging/rcs/agents`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging/rcs/agents\"\n```\n\nReturns: `agent_id` (string), `agent_name` (string), `created_at` (date-time), `enabled` (boolean), `profile_id` (uuid), `updated_at` (date-time), `user_id` (string), `webhook_failover_url` (url), `webhook_url` (url)\n\n## Retrieve an RCS agent\n\n`GET /messaging/rcs/agents/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `agent_id` (string), `agent_name` (string), `created_at` (date-time), `enabled` (boolean), `profile_id` (uuid), `updated_at` (date-time), `user_id` (string), `webhook_failover_url` (url), `webhook_url` (url)\n\n## Modify an RCS agent\n\n`PATCH /messaging/rcs/agents/{id}`\n\nOptional: `profile_id` (uuid), `webhook_failover_url` (url), `webhook_url` (url)\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/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `agent_id` (string), `agent_name` (string), `created_at` (date-time), `enabled` (boolean), `profile_id` (uuid), `updated_at` (date-time), `user_id` (string), `webhook_failover_url` (url), `webhook_url` (url)\n\n## Check RCS capabilities (batch)\n\n`POST /messaging/rcs/bulk_capabilities` — Required: `agent_id`, `phone_numbers`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"agent_id\": \"TestAgent\",\n  \"phone_numbers\": [\n    \"+13125551234\"\n  ]\n}' \\\n  \"https://api.telnyx.com/v2/messaging/rcs/bulk_capabilities\"\n```\n\nReturns: `agent_id` (string), `agent_name` (string), `features` (array[string]), `phone_number` (string), `record_type` (enum: rcs.capabilities)\n\n## Check RCS capabilities\n\n`GET /messaging/rcs/capabilities/{agent_id}/{phone_number}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging/rcs/capabilities/{agent_id}/+13125550001\"\n```\n\nReturns: `agent_id` (string), `agent_name` (string), `features` (array[string]), `phone_number` (string), `record_type` (enum: rcs.capabilities)\n\n## Add RCS test number\n\nAdds a test phone number to an RCS agent for testing purposes.\n\n`PUT /messaging/rcs/test_number_invite/{id}/{phone_number}`\n\n```bash\ncurl \\\n  -X PUT \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.telnyx.com/v2/messaging/rcs/test_number_invite/550e8400-e29b-41d4-a716-446655440000/+13125550001\"\n```\n\nReturns: `agent_id` (string), `phone_number` (string), `record_type` (enum: rcs.test_number_invite), `status` (string)\n\n## List messaging hosted number orders\n\n`GET /messaging_hosted_number_orders`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_hosted_number_orders\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## Create a messaging hosted number order\n\n`POST /messaging_hosted_number_orders`\n\nOptional: `messaging_profile_id` (string), `phone_numbers` (array[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/messaging_hosted_number_orders\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## Check hosted messaging eligibility\n\n`POST /messaging_hosted_number_orders/eligibility_numbers_check` — Required: `phone_numbers`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"phone_numbers\": [\n    \"+13125550001\"\n  ]\n}' \\\n  \"https://api.telnyx.com/v2/messaging_hosted_number_orders/eligibility_numbers_check\"\n```\n\nReturns: `phone_numbers` (array[object])\n\n## Retrieve a messaging hosted number order\n\n`GET /messaging_hosted_number_orders/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## Delete a messaging hosted number order\n\nDelete a messaging hosted number order and all associated phone numbers.\n\n`DELETE /messaging_hosted_number_orders/{id}`\n\n```bash\ncurl \\\n  -X DELETE \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  \"https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## Upload hosted number document\n\n`POST /messaging_hosted_number_orders/{id}/actions/file_upload`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -F \"loa=@/path/to/file\" \\\n  -F \"bill=@/path/to/file\" \\\n  \"https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/actions/file_upload\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## Validate hosted number codes\n\nValidate the verification codes sent to the numbers of the hosted order. The verification codes must be created in the verification codes endpoint.\n\n`POST /messaging_hosted_number_orders/{id}/validation_codes` — Required: `verification_codes`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"verification_codes\": [\n    {}\n  ]\n}' \\\n  \"https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/validation_codes\"\n```\n\nReturns: `order_id` (uuid), `phone_numbers` (array[object])\n\n## Create hosted number verification codes\n\nCreate verification codes to validate numbers of the hosted order. The verification codes will be sent to the numbers of the hosted order.\n\n`POST /messaging_hosted_number_orders/{id}/verification_codes` — Required: `phone_numbers`, `verification_method`\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"phone_numbers\": [\n    \"+13125550001\"\n  ],\n  \"verification_method\": \"sms\"\n}' \\\n  \"https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/verification_codes\"\n```\n\nReturns: `error` (string), `phone_number` (string), `type` (enum: sms, call), `verification_code_id` (uuid)\n\n## Delete a messaging hosted number\n\n`DELETE /messaging_hosted_numbers/{id}`\n\n```bash\ncurl \\\n  -X DELETE \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  \"https://api.telnyx.com/v2/messaging_hosted_numbers/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `id` (uuid), `messaging_profile_id` (string | null), `phone_numbers` (array[object]), `record_type` (string), `status` (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)\n\n## List Verification Requests\n\nGet a list of previously-submitted tollfree verification requests\n\n`GET /messaging_tollfree/verification/requests`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests\"\n```\n\nReturns: `records` (array[object]), `total_records` (integer)\n\n## Submit Verification Request\n\nSubmit a new tollfree verification request\n\n`POST /messaging_tollfree/verification/requests` — Required: `businessName`, `corporateWebsite`, `businessAddr1`, `businessCity`, `businessState`, `businessZip`, `businessContactFirstName`, `businessContactLastName`, `businessContactEmail`, `businessContactPhone`, `messageVolume`, `phoneNumbers`, `useCase`, `useCaseSummary`, `productionMessageContent`, `optInWorkflow`, `optInWorkflowImageURLs`, `additionalInformation`\n\nOptional: `ageGatedContent` (boolean), `businessAddr2` (string), `businessRegistrationCountry` (string | null), `businessRegistrationNumber` (string | null), `businessRegistrationType` (string | null), `campaignVerifyAuthorizationToken` (string | null), `doingBusinessAs` (string | null), `entityType` (object), `helpMessageResponse` (string | null), `isvReseller` (string | null), `optInConfirmationResponse` (string | null), `optInKeywords` (string | null), `privacyPolicyURL` (string | null), `termsAndConditionURL` (string | null), `webhookUrl` (string)\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"businessName\": \"Telnyx LLC\",\n  \"corporateWebsite\": \"http://example.com\",\n  \"businessAddr1\": \"600 Congress Avenue\",\n  \"businessCity\": \"Austin\",\n  \"businessState\": \"Texas\",\n  \"businessZip\": \"78701\",\n  \"businessContactFirstName\": \"John\",\n  \"businessContactLastName\": \"Doe\",\n  \"businessContactEmail\": \"email@example.com\",\n  \"businessContactPhone\": \"+18005550100\",\n  \"messageVolume\": \"100,000\",\n  \"phoneNumbers\": [\n    {\n      \"phoneNumber\": \"+18773554398\"\n    },\n    {\n      \"phoneNumber\": \"+18773554399\"\n    }\n  ],\n  \"useCase\": \"2FA\",\n  \"useCaseSummary\": \"This is a use case where Telnyx sends out 2FA codes to portal users to verify their identity in order to sign into the portal\",\n  \"productionMessageContent\": \"Your Telnyx OTP is XXXX\",\n  \"optInWorkflow\": \"User signs into the Telnyx portal, enters a number and is prompted to select whether they want to use 2FA verification for security purposes. If they've opted in a confirmation message is sent out to the handset\",\n  \"optInWorkflowImageURLs\": [\n    {\n      \"url\": \"https://telnyx.com/sign-up\"\n    },\n    {\n      \"url\": \"https://telnyx.com/company/data-privacy\"\n    }\n  ],\n  \"additionalInformation\": \"Additional context for this request.\"\n}' \\\n  \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests\"\n```\n\nReturns: `additionalInformation` (string), `ageGatedContent` (boolean), `businessAddr1` (string), `businessAddr2` (string), `businessCity` (string), `businessContactEmail` (string), `businessContactFirstName` (string), `businessContactLastName` (string), `businessContactPhone` (string), `businessName` (string), `businessRegistrationCountry` (string), `businessRegistrationNumber` (string), `businessRegistrationType` (string), `businessState` (string), `businessZip` (string), `campaignVerifyAuthorizationToken` (string | null), `corporateWebsite` (string), `doingBusinessAs` (string), `entityType` (object), `helpMessageResponse` (string), `id` (uuid), `isvReseller` (string), `messageVolume` (object), `optInConfirmationResponse` (string), `optInKeywords` (string), `optInWorkflow` (string), `optInWorkflowImageURLs` (array[object]), `phoneNumbers` (array[object]), `privacyPolicyURL` (string), `productionMessageContent` (string), `termsAndConditionURL` (string), `useCase` (object), `useCaseSummary` (string), `verificationRequestId` (string), `verificationStatus` (object), `webhookUrl` (string)\n\n## Get Verification Request\n\nGet a single verification request by its ID.\n\n`GET /messaging_tollfree/verification/requests/{id}`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `additionalInformation` (string), `ageGatedContent` (boolean), `businessAddr1` (string), `businessAddr2` (string), `businessCity` (string), `businessContactEmail` (string), `businessContactFirstName` (string), `businessContactLastName` (string), `businessContactPhone` (string), `businessName` (string), `businessRegistrationCountry` (string), `businessRegistrationNumber` (string), `businessRegistrationType` (string), `businessState` (string), `businessZip` (string), `campaignVerifyAuthorizationToken` (string | null), `corporateWebsite` (string), `createdAt` (date-time), `doingBusinessAs` (string), `entityType` (object), `helpMessageResponse` (string), `id` (uuid), `isvReseller` (string), `messageVolume` (object), `optInConfirmationResponse` (string), `optInKeywords` (string), `optInWorkflow` (string), `optInWorkflowImageURLs` (array[object]), `phoneNumbers` (array[object]), `privacyPolicyURL` (string), `productionMessageContent` (string), `reason` (string), `termsAndConditionURL` (string), `updatedAt` (date-time), `useCase` (object), `useCaseSummary` (string), `verificationStatus` (object), `webhookUrl` (string)\n\n## Update Verification Request\n\nUpdate an existing tollfree verification request. This is particularly useful when there are pending customer actions to be taken.\n\n`PATCH /messaging_tollfree/verification/requests/{id}` — Required: `businessName`, `corporateWebsite`, `businessAddr1`, `businessCity`, `businessState`, `businessZip`, `businessContactFirstName`, `businessContactLastName`, `businessContactEmail`, `businessContactPhone`, `messageVolume`, `phoneNumbers`, `useCase`, `useCaseSummary`, `productionMessageContent`, `optInWorkflow`, `optInWorkflowImageURLs`, `additionalInformation`\n\nOptional: `ageGatedContent` (boolean), `businessAddr2` (string), `businessRegistrationCountry` (string | null), `businessRegistrationNumber` (string | null), `businessRegistrationType` (string | null), `campaignVerifyAuthorizationToken` (string | null), `doingBusinessAs` (string | null), `entityType` (object), `helpMessageResponse` (string | null), `isvReseller` (string | null), `optInConfirmationResponse` (string | null), `optInKeywords` (string | null), `privacyPolicyURL` (string | null), `termsAndConditionURL` (string | null), `webhookUrl` (string)\n\n```bash\ncurl \\\n  -X PATCH \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"businessName\": \"Telnyx LLC\",\n  \"corporateWebsite\": \"http://example.com\",\n  \"businessAddr1\": \"600 Congress Avenue\",\n  \"businessCity\": \"Austin\",\n  \"businessState\": \"Texas\",\n  \"businessZip\": \"78701\",\n  \"businessContactFirstName\": \"John\",\n  \"businessContactLastName\": \"Doe\",\n  \"businessContactEmail\": \"email@example.com\",\n  \"businessContactPhone\": \"+18005550100\",\n  \"messageVolume\": \"100,000\",\n  \"phoneNumbers\": [\n    {\n      \"phoneNumber\": \"+18773554398\"\n    },\n    {\n      \"phoneNumber\": \"+18773554399\"\n    }\n  ],\n  \"useCase\": \"2FA\",\n  \"useCaseSummary\": \"This is a use case where Telnyx sends out 2FA codes to portal users to verify their identity in order to sign into the portal\",\n  \"productionMessageContent\": \"Your Telnyx OTP is XXXX\",\n  \"optInWorkflow\": \"User signs into the Telnyx portal, enters a number and is prompted to select whether they want to use 2FA verification for security purposes. If they've opted in a confirmation message is sent out to the handset\",\n  \"optInWorkflowImageURLs\": [\n    {\n      \"url\": \"https://telnyx.com/sign-up\"\n    },\n    {\n      \"url\": \"https://telnyx.com/company/data-privacy\"\n    }\n  ],\n  \"additionalInformation\": \"Additional context for this request.\"\n}' \\\n  \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000\"\n```\n\nReturns: `additionalInformation` (string), `ageGatedContent` (boolean), `businessAddr1` (string), `businessAddr2` (string), `businessCity` (string), `businessContactEmail` (string), `businessContactFirstName` (string), `businessContactLastName` (string), `businessContactPhone` (string), `businessName` (string), `businessRegistrationCountry` (string), `businessRegistrationNumber` (string), `businessRegistrationType` (string), `businessState` (string), `businessZip` (string), `campaignVerifyAuthorizationToken` (string | null), `corporateWebsite` (string), `doingBusinessAs` (string), `entityType` (object), `helpMessageResponse` (string), `id` (uuid), `isvReseller` (string), `messageVolume` (object), `optInConfirmationResponse` (string), `optInKeywords` (string), `optInWorkflow` (string), `optInWorkflowImageURLs` (array[object]), `phoneNumbers` (array[object]), `privacyPolicyURL` (string), `productionMessageContent` (string), `termsAndConditionURL` (string), `useCase` (object), `useCaseSummary` (string), `verificationRequestId` (string), `verificationStatus` (object), `webhookUrl` (string)\n\n## Delete Verification Request\n\nDelete a verification request\n\nA request may only be deleted when when the request is in the \"rejected\" state. * `HTTP 200`: request successfully deleted\n* `HTTP 400`: request exists but can't be deleted (i.e. not rejected)\n* `HTTP 404`: request unknown or already deleted\n\n`DELETE /messaging_tollfree/verification/requests/{id}`\n\n```bash\ncurl \\\n  -X DELETE \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000\"\n```\n\n## Get Verification Request Status History\n\nGet the history of status changes for a verification request. Returns a paginated list of historical status changes including the reason for each change and when it occurred.\n\n`GET /messaging_tollfree/verification/requests/{id}/status_history`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000/status_history\"\n```\n\nReturns: `records` (array[object]), `total_records` (integer)\n\n## List messaging URL domains\n\n`GET /messaging_url_domains`\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \"https://api.telnyx.com/v2/messaging_url_domains\"\n```\n\nReturns: `id` (string), `record_type` (string), `url_domain` (string), `use_case` (string)","tags":["telnyx","messaging","hosted","curl","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm"],"capabilities":["skill","source-team-telnyx","skill-telnyx-messaging-hosted-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-messaging-hosted-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 (21,628 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:38.679Z","embedding":null,"createdAt":"2026-04-18T22:06:38.762Z","updatedAt":"2026-04-22T06:54:38.679Z","lastSeenAt":"2026-04-22T06:54:38.679Z","tsv":"'+13125550001':100,193,613,845,1172 '+13125550002':102 '+13125551234':276,570 '+18005550100':1397,1806 '+18773554398':1403,1812 '+18773554399':1405,1814 '-1':110 '/actions/file_upload':994 '/company/data-privacy':1487,1896 '/messages/rcs':233 '/messages/rcs/deeplinks':346 '/messaging/rcs/agents':376,425,475 '/messaging/rcs/bulk_capabilities':543 '/messaging/rcs/capabilities':595 '/messaging/rcs/test_number_invite':648 '/messaging_hosted_number_orders':691,750,861,932,992,1082,1146 '/messaging_hosted_number_orders/eligibility_numbers_check':823 '/messaging_hosted_numbers':1199 '/messaging_tollfree/verification/requests':1268,1297,1585,1705,2029,2078 '/messaging_url_domains':2104 '/path/to/file':1007,1010 '/sign-up':1483,1892 '/status_history':2080 '/v2/messages':86 '/v2/messages/rcs':290 '/v2/messages/rcs/deeplinks/':359 '/v2/messaging/rcs/agents':387 '/v2/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000':437,505 '/v2/messaging/rcs/bulk_capabilities':573 '/v2/messaging/rcs/capabilities/':610 '/v2/messaging/rcs/test_number_invite/550e8400-e29b-41d4-a716-446655440000/+13125550001':669 '/v2/messaging_hosted_number_orders':702,777 '/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000':873,946 '/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/actions/file_upload':1013 '/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/validation_codes':1108 '/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/verification_codes':1178 '/v2/messaging_hosted_number_orders/eligibility_numbers_check':848 '/v2/messaging_hosted_numbers/550e8400-e29b-41d4-a716-446655440000':1213 '/v2/messaging_tollfree/verification/requests':1279,1496 '/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000':1597,1905,2043 '/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000/status_history':2091 '/v2/messaging_url_domains':2115 '/validation_codes':1084 '/verification_codes':1148 '000':1400,1809 '1':141 '10':22 '100':1399,1808 '2':120 '200':2005 '20world':367 '2b18445550001':364 '2fa':1407,1418,1460,1816,1827,1869 '400':2010 '401':61,142,159 '403':163 '404':166,2022 '41d4':283 '422':57,124,170 '429':54,133,176 '446655440000':285 '550e8400':280 '600':1381,1790 '78701':1389,1798 'a716':284 'action':1700 'add':631,635 'addit':1489,1898 'additionalinform':1316,1488,1498,1599,1725,1897,1907 'agegatedcont':1318,1500,1601,1727,1909 'agent':235,241,272,286,344,347,360,374,389,392,423,439,442,473,507,510,545,565,575,578,596,611,615,618,643,671 'agent007':274 'alreadi':2026 'alway':62 'api':27,30,38,45,91,148,161,264,355,383,433,496,557,606,660,698,768,835,869,942,1003,1096,1162,1209,1275,1367,1593,1776,2039,2087,2111 'api.telnyx.com':85,289,358,386,436,504,572,609,668,701,776,847,872,945,1012,1107,1177,1212,1278,1495,1596,1904,2042,2090,2114 'api.telnyx.com/v2/messages':84 'api.telnyx.com/v2/messages/rcs':288 'api.telnyx.com/v2/messages/rcs/deeplinks/':357 'api.telnyx.com/v2/messaging/rcs/agents':385 'api.telnyx.com/v2/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000':435,503 'api.telnyx.com/v2/messaging/rcs/bulk_capabilities':571 'api.telnyx.com/v2/messaging/rcs/capabilities/':608 'api.telnyx.com/v2/messaging/rcs/test_number_invite/550e8400-e29b-41d4-a716-446655440000/+13125550001':667 'api.telnyx.com/v2/messaging_hosted_number_orders':700,775 'api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000':871,944 'api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/actions/file_upload':1011 'api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/validation_codes':1106 'api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/verification_codes':1176 'api.telnyx.com/v2/messaging_hosted_number_orders/eligibility_numbers_check':846 'api.telnyx.com/v2/messaging_hosted_numbers/550e8400-e29b-41d4-a716-446655440000':1211 'api.telnyx.com/v2/messaging_tollfree/verification/requests':1277,1494 'api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000':1595,1903,2041 'api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000/status_history':2089 'api.telnyx.com/v2/messaging_url_domains':2113 'application/json':97,270,502,563,666,774,841,1102,1168,1373,1782 'array':318,582,622,713,758,788,852,884,957,1024,1115,1224,1282,1552,1555,1657,1660,1961,1964,2094 'associ':928 'austin':1385,1794 'authent':41,59,144 'author':88,261,352,380,430,493,554,603,657,695,765,832,866,939,1000,1093,1159,1206,1272,1364,1590,1773,2036,2084,2108 'avenu':1383,1792 'backoff':182 'bash':24,68,256,349,377,427,488,549,600,652,692,760,827,863,934,995,1088,1154,1201,1269,1359,1587,1768,2031,2081,2105 'batch':541 'bearer':89,262,353,381,431,494,555,604,658,696,766,833,867,940,1001,1094,1160,1207,1273,1365,1591,1774,2037,2085,2109 'bill':730,805,901,974,1009,1041,1241 'bodi':111,123,154,292,365 'boolean':401,451,519,1319,1501,1602,1728,1910 'businessaddr1':1301,1380,1502,1603,1710,1789,1911 'businessaddr2':1320,1504,1605,1729,1913 'businessc':1302,1384,1506,1607,1711,1793,1915 'businesscontactemail':1307,1394,1508,1609,1716,1803,1917 'businesscontactfirstnam':1305,1390,1510,1611,1714,1799,1919 'businesscontactlastnam':1306,1392,1512,1613,1715,1801,1921 'businesscontactphon':1308,1396,1514,1615,1717,1805,1923 'businessnam':1299,1375,1516,1617,1708,1784,1925 'businessregistrationcountri':1322,1518,1619,1731,1927 'businessregistrationnumb':1325,1520,1621,1734,1929 'businessregistrationtyp':1328,1522,1623,1737,1931 'businessst':1303,1386,1524,1625,1712,1795,1933 'businesszip':1304,1388,1526,1627,1713,1797,1935 'call':46,1188 'campaignverifyauthorizationtoken':1331,1528,1629,1740,1937 'capabl':540,593 'carrier':720,733,795,808,891,904,964,977,1031,1044,1231,1244 'case':116,1413,1822,2126 'chang':2054,2066,2072 'check':69,128,146,173,222,538,591,818 'code':67,72,81,106,118,153,158,199,1057,1061,1072,1079,1087,1105,1121,1124,1134,1190,1419,1828 'common':156 'complianc':722,797,893,966,1033,1233 'confirm':1471,1880 'congress':1382,1791 'content':95,268,500,561,664,772,839,1100,1166,1371,1780 'content-typ':94,267,499,560,663,771,838,1099,1165,1370,1779 'context':1490,1899 'convers':340 'corporatewebsit':1300,1378,1531,1632,1709,1787,1940 'countri':198 'creat':395,445,513,743,1075,1117,1122 'createdat':1634 'curl':5,9,12,76,257,350,378,428,489,550,601,653,693,761,828,864,935,996,1089,1155,1202,1270,1360,1588,1769,2032,2082,2106 'custom':1699 'd':98,115,271,564,842,1103,1169,1374,1783 'dash':202 'date':312,398,408,448,458,516,526,1636,1672 'date-tim':311,397,407,447,457,515,525,1635,1671 'deeplink':327,330 'delay':139 'delet':725,800,896,914,920,931,937,969,1036,1193,1198,1204,1236,1982,1985,1994,2008,2017,2027,2028,2034 'direct':294 'document':728,803,899,972,990,1039,1239 'doe':1393,1802 'doingbusinessa':1334,1533,1638,1743,1942 'domain':2102,2123 'e.164':190 'e.g':192 'e29b':282 'e29b-41d4-a716':281 'echo':107,112,121,125,134,143,150 'elig':821 'email@example.com':1395,1804 'enabl':400,450,518 'encod':296 'endpoint':207,1080 'enter':1447,1856 'entitytyp':1337,1535,1640,1746,1944 'enum':251,589,629,679,719,794,890,963,1030,1186,1230 'error':42,51,56,60,64,127,151,157,172,1180 'esac':155 'exampl':34 'example.com':1379,1788 'exist':1687,2012 'exponenti':181 'export':25 'f':1005,1008 'fail':48,145,724,726,799,801,895,897,968,970,1035,1037,1235,1237 'failov':414,464,482,532 'fallback':245,248 'featur':581,621 'field':130,174 'file':735,738,810,813,906,909,979,982,1046,1049,1246,1249 'float':324 'format':132,175,191 'found':169 'generat':325,328 'get':345,375,424,594,690,860,1257,1267,1573,1576,1584,2044,2049,2077,2103 'h':87,93,260,266,351,379,429,492,498,553,559,602,656,662,694,764,770,831,837,865,938,999,1092,1098,1158,1164,1205,1271,1363,1369,1589,1772,1778,2035,2083,2107 'handl':43,63 'handset':1478,1887 'hello':104,366 'helpmessagerespons':1339,1537,1642,1748,1946 'histor':2064 'histori':2048,2051 'host':4,8,687,746,819,857,917,923,988,1055,1068,1118,1130,1143,1196 'http':70,80,105,117,152,2004,2009,2021 'i.e':2018 'id':236,240,273,279,300,304,307,348,361,390,403,411,426,440,453,461,476,479,508,521,529,546,566,576,597,612,616,649,672,704,708,754,779,783,862,875,879,933,948,952,993,1015,1019,1083,1111,1147,1191,1200,1215,1219,1539,1583,1586,1644,1706,1948,2030,2079,2117 'ident':1426,1835 'import':183 'includ':194,2067 'incomplet':727,802,898,971,1038,1238 'incorrect':729,804,900,973,1040,1240 'inelig':732,807,903,976,1043,1243 'inform':731,806,902,975,1042,1242 'instal':10,16 'insuffici':164 'integ':1286,2098 'invalid':160,736,811,907,980,1047,1247 'invit':682 'isvresel':1342,1541,1646,1751,1950 'john':1391,1800 'key':28,31,39,92,149,162,265,356,384,434,497,558,607,661,699,769,836,870,943,1004,1097,1163,1210,1276,1368,1594,1777,2040,2088,2112 'limit':53,136,178 'linux':19 'list':206,371,685,1254,1259,2062,2099 'llc':1377,1786 'loa':734,737,809,812,905,908,978,981,1006,1045,1048,1245,1248 'maco':18 'may':1991 'messag':3,7,231,238,242,277,287,302,686,706,745,752,781,820,856,877,916,922,950,1017,1195,1217,1472,1881,2100 'messagevolum':1309,1398,1543,1648,1718,1807,1952 'meta.total':223 'method':1153,1174 'mms':244 'modifi':470 'must':187,1073 'n':79 'name':393,443,511,579,619 'navig':220 'network':50 'new':1292 'note':184 'null':710,785,881,954,1021,1221,1324,1327,1330,1333,1336,1341,1344,1347,1350,1353,1356,1530,1631,1733,1736,1739,1742,1745,1750,1753,1756,1759,1762,1765,1939 'number':186,213,363,548,569,585,599,625,634,639,651,675,681,688,712,747,757,787,826,844,851,858,883,918,924,930,956,989,1023,1056,1065,1114,1119,1127,1140,1151,1171,1183,1197,1223,1449,1858 'object':246,249,293,299,319,714,789,853,885,958,1025,1116,1225,1283,1338,1536,1544,1553,1556,1564,1570,1641,1649,1658,1661,1675,1679,1747,1945,1953,1962,1965,1973,1979,2095 'occur':2076 'opt':1468,1877 'optinconfirmationrespons':1345,1545,1650,1754,1954 'optinkeyword':1348,1547,1652,1757,1956 'optinworkflow':1314,1440,1549,1654,1723,1849,1958 'optinworkflowimageurl':1315,1479,1551,1656,1724,1888,1960 'option':243,477,751,1317,1726 'order':689,748,859,919,925,1069,1110,1131,1144,1428,1837 'organ':306 'otp':1437,1846 'page':212,215,221,224 'pagin':205,209,2061 'paramet':218 'parenthes':204 'particular':1693 'patch':474,491,1704,1771 'pend':740,815,911,984,1051,1251,1698 'permiss':165 'phone':185,362,547,568,584,598,624,638,650,674,711,756,786,825,843,850,882,929,955,1022,1113,1150,1170,1182,1222 'phonenumb':1310,1401,1402,1404,1554,1659,1719,1810,1811,1813,1963 'portal':1421,1433,1446,1830,1842,1855 'post':83,232,259,542,552,749,763,822,830,991,998,1081,1091,1145,1157,1296,1362 'pre':15 'pre-instal':14 'prefix':196 'previous':1262 'previously-submit':1261 'privacypolicyurl':1351,1557,1662,1760,1966 'product':66 'productionmessagecont':1313,1434,1559,1664,1722,1843,1968 'profil':239,278,303,402,452,478,520,707,753,782,878,951,1018,1218 'prompt':1452,1861 'provis':741,816,912,985,1052,1252 'purpos':646,1464,1873 'put':647,655 'queri':217 'rate':52,135,177 'rcs':230,252,326,339,373,422,472,539,592,632,642 'rcs.capabilities':590,630 'rcs.test':680 'reason':1666,2069 'receiv':309 'record':314,587,627,677,715,790,886,959,1026,1226,1281,1285,2093,2097,2119 'reject':721,796,892,965,1032,1232,2002,2020 'request':1256,1266,1289,1295,1493,1575,1580,1684,1690,1902,1984,1988,1990,1998,2006,2011,2023,2046,2058 'requir':129,234,544,824,1085,1149,1298,1707 'resourc':167 'respons':74,75,108,113,227 'result':210 'retri':137,179 'retriev':420,854 'return':208,291,368,388,438,506,574,614,670,703,778,849,874,947,1014,1109,1179,1214,1280,1497,1598,1906,2059,2092,2116 'review':723,798,894,967,1034,1234 'second':323 'secur':1463,1872 'sed':114 'select':1454,1863 'send':228,1416,1825 'sent':1062,1137,1474,1883 'setup':23 'sign':1430,1442,1839,1851 'singl':1578 'size':216 'skill' 'skill-telnyx-messaging-hosted-curl' 'sleep':140 'sms':247,1175,1187 'source-team-telnyx' 'space':201 'specif':343 'start':337 'state':2003 'status':71,683,718,793,889,962,1029,1229,2047,2053,2065 'string':295,297,301,305,308,316,321,370,391,394,412,441,444,462,509,512,530,577,580,583,586,617,620,623,626,673,676,684,709,717,755,759,784,792,880,888,953,961,1020,1028,1181,1184,1220,1228,1321,1323,1326,1329,1332,1335,1340,1343,1346,1349,1352,1355,1358,1499,1503,1505,1507,1509,1511,1513,1515,1517,1519,1521,1523,1525,1527,1529,1532,1534,1538,1542,1546,1548,1550,1558,1560,1562,1566,1568,1572,1600,1604,1606,1608,1610,1612,1614,1616,1618,1620,1622,1624,1626,1628,1630,1633,1639,1643,1647,1651,1653,1655,1663,1665,1667,1669,1677,1681,1730,1732,1735,1738,1741,1744,1749,1752,1755,1758,1761,1764,1767,1908,1912,1914,1916,1918,1920,1922,1924,1926,1928,1930,1932,1934,1936,1938,1941,1943,1947,1951,1955,1957,1959,1967,1969,1971,1975,1977,1981,2118,2121,2124,2127 'submit':1263,1287,1290 'success':122,739,742,814,817,910,913,983,986,1050,1053,1250,1253,2007 'tail':109 'taken':1703 'telnyx':2,6,26,37,90,147,263,354,382,432,495,556,605,659,697,767,834,868,941,1002,1095,1161,1208,1274,1366,1376,1415,1436,1445,1592,1775,1785,1824,1845,1854,2038,2086,2110 'telnyx-messaging-hosted-curl':1 'telnyx.com':1482,1486,1891,1895 'telnyx.com/company/data-privacy':1485,1894 'telnyx.com/sign-up':1481,1890 'termsandconditionurl':1354,1561,1668,1763,1970 'test':633,637,645 'testag':567 'texa':1387,1796 'text':11,103 'time':313,399,409,449,459,517,527,1637,1673 'tollfre':1264,1293,1688 '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':1284,2096 'type':96,250,269,315,320,501,562,588,628,665,678,716,773,791,840,887,960,1027,1101,1167,1185,1227,1372,1781,2120 'unknown':2024 'updat':405,455,523,1682,1685 'updatedat':1670 'upload':987 'url':254,255,331,369,415,416,418,419,465,466,468,469,483,484,486,487,533,534,536,537,1480,1484,1889,1893,2101,2122 'use':36,211,335,1412,1459,1694,1821,1868,2125 'usecas':1311,1406,1563,1674,1720,1815,1972 'usecasesummari':1312,1408,1565,1676,1721,1817,1974 'user':410,460,528,1422,1441,1831,1850 'uuid':404,454,480,522,705,780,876,949,1016,1112,1192,1216,1540,1645,1949 'valid':55,126,171,1054,1058,1126 've':1467,1876 'verif':1060,1071,1078,1086,1104,1120,1123,1133,1152,1173,1189,1255,1265,1288,1294,1461,1574,1579,1683,1689,1870,1983,1987,2045,2057 'verifi':1424,1833 'verificationrequestid':1567,1976 'verificationstatus':1569,1678,1978 'w':78 'wait':322 'want':1457,1866 'webhook':253,413,417,463,467,481,485,531,535 'webhookurl':1357,1571,1680,1766,1980 'whether':1455,1864 'window':21 'x':82,258,490,551,654,762,829,936,997,1090,1156,1203,1361,1770,2033 'xxxx':1439,1848","prices":[{"id":"fc9f1bc2-f8be-42e8-bc6a-95f852d4f5df","listingId":"403646f5-a380-4d88-8968-4819f3788a95","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:06:38.762Z"}],"sources":[{"listingId":"403646f5-a380-4d88-8968-4819f3788a95","source":"github","sourceId":"team-telnyx/ai/telnyx-messaging-hosted-curl","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-messaging-hosted-curl","isPrimary":false,"firstSeenAt":"2026-04-18T22:06:38.762Z","lastSeenAt":"2026-04-22T06:54:38.679Z"}],"details":{"listingId":"403646f5-a380-4d88-8968-4819f3788a95","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-messaging-hosted-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":"01ac6636c7e845cb537dd298e5830520d09df4d8","skill_md_path":"skills/telnyx-messaging-hosted-curl/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-messaging-hosted-curl"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-messaging-hosted-curl","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-messaging-hosted-curl"},"updatedAt":"2026-04-22T06:54:38.679Z"}}