Skip to main content

API Error Messages

You can download it as a json file by going here .

CodeTitleDetail
10001 Inactive phone numberThe phone number is inactive.
10002 Invalid phone numberThe phone number is invalid.
10003 Invalid URLThe URL provided was invalid, malformed, or too long. URLs can be a maximum of 2000 characters.
10004 Missing required parameterA required parameter was missing.
10005 Resource not foundThe requested resource or URL could not be found.
10006 Invalid IDThe resource ID provided was invalid.
10007 Unexpected errorAn unexpected error occured.
10008 Request timeoutThe request timed out.
10009 Authentication failedThe required authentication headers were either invalid or not included in the request.
10010 Authorization failedYou do not have permission to perform the requested action on the specified resource or resources.
10011 Too many requestsYou have exceeded the maximum number of allowed requests.
10012 Duplicate resourceResource is a duplicate.
10013 Missing associationOne of the associated fields does not exist.
10014 Unsupported Media TypeThe request failed because the server does not support the media type.
10015 Bad RequestThe request failed because it was not well-formed.
10016 Phone number must be in +E.164 formatThe specified phone number parameter must be in +E.164 format.
10017 Associated resource does not existThe requested parameter is invalid as the associated resource does not exist.
10018 Invalid sort directionThe 'sort_direction' parameter must have a value of either 'asc' or 'desc'.
10019 Invalid email addressThe 'email' parameter is not a valid email address.
10020 Invalid resource typeThe requested parameter must be of type 'string'
10021 Resource in useThe resource can not be removed as it is still in use.
10022 One or more invalid IDsOne or more of the IDs provided were invalid.
10023 Invalid JSONThe supplied JSON is invalid.
10024 Unsupported Content-TypeMust encode request as 'application/x-www-form-urlencoded' or 'application/json'
10025 String length out of rangeThe string length provided for the indicated field was outside the allowed range. The field must be between {min} and {max} characters long, but was {actual}.
10026 Invalid parameter typeThe parameter must be of type {expected_type}, but received type {received_type}
10027 Unprocessable EntityThe server understood the syntax of the request but was unable to process the instructions.
10028 Character encoding errorThe request body was not able to be decoded.
10029 Expected JSON Content-TypeMust encode request as 'application/json'
10030 Method not allowedThe URL is valid, but the method is not allowed.
10031 Invalid request filterThe request filter filter[{filter}] is invalid.
10032 Invalid enumerated valueThe value must be one of {enumerated_values}
10033 Value outside of rangeThe value is outside of allowed range {min_allow} to {max_allow}
10034 Expected URL-encoded form Content-TypeMust encode request as 'application/x-www-form-urlencoded'
10035 Resource lockedThe resource has been locked. Contact Telnyx support.
10036 Resource is being processedThis resource is in ongoing processing and it can't be interacted with. Please, wait for its operation to finish and retry later.
10037 Service unavailableService is unavailable.
10700 Invalid caller dataThe CNAM caller data provided is invalid.
20000 Invalid resource groupsThe resource groups provided are invalid.
20001 Invalid API Key secretThe secret provided is invalid.
20002 API Key revokedThe API Key provided is not active.
20003 API Key forbiddenThe API Key provided is forbidden.
20004 Invalid permission groupsThe permission groups provided are invalid.
20005 Invalid userThe user provided is invalid.
20006 Expired access tokenThe access token provided is expired.
20007 Invalid permission groupsThe permission groups provided must be a subset of the API Key's.
20008 Invalid API KeyThe API Key provided is invalid.
20009 Invalid userThe user provided does not exist.
20010 Invalid invitationThe invitation provided does not exist.
20011 API Key in useThe API Key can not be revoked while assigned to a portal user.
20012 Account inactiveThe request cannot be fulfilled because your account has been deactivated. It may be out of funds.
20013 Account blockedYour account has been blocked. Please contact Telnyx support.
20014 Account unverifiedYou have not completed the verifications required to perform this action. Check the 'verifications' tab under 'account' on the portal for more information.
20015 Feature not enabledThe {feature} feature is not enabled on your account.
20016 Account not level 1 verifiedLevel 1 account verification is required to perform this action. Check the 'verifications' tab under 'account' on the portal for more information.
20017 Account not level 2 verifiedLevel 2 account verification is required to perform this action. Check the 'verifications' tab under 'account' on the portal for more information.
20100 Insufficient FundsYou do not have enough funds to perform this action.
20200 Invalid addressThe address provided is invalid.
20201 Invalid country codeThe country code provided is invalid.
20202 Invalid localityThe locality provided is invalid.
20203 Invalid neighborhoodThe neighborhood provided is invalid.
20204 Invalid administrative areaThe administrative area provided is invalid.
20205 Invalid postal codeThe postal code provided is invalid.
20206 Invalid boroughThe borough provided is invalid.
20207 Invalid street addressThe street address provided is invalid.
20208 Invalid street address house numberThe street address house number provided is invalid.
20209 Invalid extended addressThe extended address provided is invalid.
40001 Not routableThe destination number is either a landline or a non-routable wireless number.
40002 Blocked as spam - temporaryThe message was flagged by a SPAM filter and was not delivered. This is a temporary condition.
40003 Blocked as spam - permanentThe message was flagged by a SPAM filter and was not delivered. The originating phone number is permanently blocked.
40004 Rejected by destinationThe recipient server is rejecting the message for an unknown reason.
40005 Message expired during transmissionThe message expired before it could be fully delivered to the recipient.
40006 Recipient server unavailableThe recipient server is unavailable or not responding.
40007 Loop detectedInfinite loop detected.
40008 UndeliverableThe recipient carrier did not accept the message.
40009 Invalid message bodyThe message body was invalid.
40011 Too many requestsExceeded upstream rate limit. As a result the message was flagged by a SPAM filter and was not delivered. This is a temporary condition.
40012 Invalid messaging destination numberThe destination phone number was deemed invalid by the carrier.
40013 Invalid messaging source numberThe source phone number was deemed invalid by the carrier.
40014 Message expired in queueThe message was not sent by Telnyx because its validity period expired.
40015 Blocked as spam - internalThe message was flagged by an internal Telnyx SPAM filter.
40016 T-Mobile 10DLC Sending Limit ReachedYou have exceeded T-Mobile's allotted throughput limits for the campaign associated to this phone number
40017 AT&T 10DLC Spam Message RejectedAT&T has rejected your message for spam on the 10DLC route
40018 AT&T 10DLC Sending Limit ReachedYou have exceeded AT&T's allotted throughput limits for the campaign associated to this phone number
40019 AT&T 10DLC Invalid Tag DataAT&T has rejected your message because the tagging information is incorrect
40100 Number not messaging enabled.The number is not currently messaging enabled.
40150 Toll free number not in registryMessaging cannot be enabled for this number because the number is not in the voice registry.
40151 Message enablement pending with other providerMessaging is in the process of being enabled with another messaging provider.
40152 Invalid OSR parameterOne of the parameters sent to the OSR was missing or invalid.
40153 Cannot access OSRTelnyx is not authorized to access the OSR.
40154 Unauthorized NNIDTelnyx is not authorized to use this NNID.
40155 LOA requiredAn LOA is required to text message enable this number.
40156 Unauthorized property name/valueTelnyx is not authorized to provision this property name or property value.
40157 Temporarily blockedTelnyx is temporarily unable to make changes to the OSR.
40158 Delete failedThe record was not found or the NNID was invalid so it could not be deleted.
40159 Unknown OSR errorAn error occurred while updating the OSR.
40300 Blocked due to STOP messageMessages cannot be sent from {src} to {dst} due to an existing block rule.
40301 Unsupported message type for the 'to' addressSending messages from {src} to {dst} is currently unsupported.
40302 Message too largeThe SMS message would be divided into {parts} parts. The maximum is {max_parts}.
40303 Message not foundThe message with ID {id} was not found.
40304 Invalid combination of message content argumentsThe message must contain exclusively 'body' for SMS, or 'subject' and/or 'media_urls' for MMS
40305 Invalid 'from' addressThe 'from' address should be string containing a valid phone number or alphanumeric sender ID associated with the sending messaging profile.
40306 Alpha sender not configuredThe messaging profile doesn't have an associated alphanumeric sender ID.
40307 Alpha sender mismatchThe specified alphanumeric sender ID {provided_sender} does not match the one configured on the profile {expected_sender}
40308 Invalid 'from' address for MMSMMS can only be sent from US long code numbers and MMS-configured short codes
40309 Invalid destination regionThe region {region} for the destination {dst} is not included in the messaging profile's whitelisted destinations.
40310 Invalid 'to' addressThe 'to' address should be a single valid number.
40311 Invalid messaging profile secretThe provided X-Profile-Secret header was invalid.
40312 Messaging profile is disabledThe specified messaging profile {id} is disabled.
40313 Missing messaging profile secretThe X-Profile-Secret header is missing.
40314 Messaging disabled on accountMessaging has been disabled on your account. Contact Telnyx support.
40315 Unhealthy 'from' addressSending number {src} (with success rate {success} and spam rejection rate {spam}) did not pass the health check.
40316 No content provided for messageThe message has no content. Either 'text' and/or 'media_urls' must be provided in the request.
40317 Invalid MMS contentMMS can only contain up to 10 items (URLs provided) and the total size must be less than 1 MB.
40318 Message queue fullMessage queue is full. Wait before resending.
40319 Incompatible message type for the 'to' addressSending messages from {src} to {dst} is not possible.
40320 Temporarily unusable 'from' addressThe sending number {src} is in a temporarily unusable or pending state.
40321 No usable numbers on messaging profileNumber Pool is not enabled, or it is unable to select a usable number on the messaging profile.
40322 Blocked due to contentMessage contains invalid content.
40323 Messaging activation failedCould not enable messaging on the number.
40324 Messaging product type change failedCould not change product types for the number.
40325 Invalid alphanumeric sender IDThe specified alphanumeric sender ID value is invalid.
40326 Cannot assign alphanumeric sender IDThe alphanumeric sender ID could not be assigned to the messaging profile.
40327 Invalid DomainThe domain provided is not listed as a valid domain to be used with URL Shortener
40328 SMS exceeds recommended sizeThe SMS message would be divided into {parts} parts. Messages over {max_parts} should be sent by MMS or by adding auto_detect=False.
40329 Tollfree number is not verifiedTry verifying the number if you haven't already; otherwise double check that verification succeeded.
40330 Tollfree number is not provisionedThis TFN is not yet fully provisioned for messaging.
40331 Missing whitelisted destinationsMessaging profile is missing whitelisted destinations.
40332 Brand cannot be deletedBrand cannot be deleted due to an associated active campaign.
41000 WhatsApp Error{code} - {title}
50000 VRF still deployedThe VRF can not be removed as it is still deployed to one or more sites
50001 VRF not deployedThe VRF is not deployed at this site
50002 VRF already deployedThe VRF is already deployed at this site
50003 Invalid IP addressThis is not a valid IP address
50004 Private IP address not permittedPrivate IP addresses are not permitted
50005 Invalid CIDR blockThis is not a valid CIDR block
50006 Private CIDR block not permittedPrivate CIDR blocks are not permitted
50007 CIDR block too largeCIDR blocks are limited to /{prefixlen} and higher
50008 Can not delete IP from sourceCan not delete IP from source {source}
65001 Invalid Room IDThe provided room_id was not valid.
70000 Consumption reached data limitThe consumption reached the defined data limit. Please, update the SIM card group data limit.
70001 There aren't enough available SIM cardsInsufficient inventory to satisfy order request.
70002 Invalid data formatThe provided data attribute was invalid.
70003 Mobile operators' preferences priorities are out of sequenceThe mobile operators' preferences priorities should be in an ascending order starting by 0.
70004 OTA update in progressSIM card network preferences can't be defined when a previous OTA update is still in progress.
70005 Could not delete SIM card groupThe SIM card group associated with the provided ID can not be deleted because there are SIM cards associated with the SIM card group.
70006 Could not delete default SIM card groupThe SIM card group associated with the provided ID can not be deleted because it is the default SIM card group on your account.
70007 SIM card doesn't have a SIM card groupA SIM card cannot be enabled unless it's associated with a SIM card group.
70008 Public IPs are unavailable at this timeThere aren't any public IPs available at this time. Please contact Telnyx support for more information.
75000 Webhook delivery errorThe webhook was not successful
75001 Could not resolve nameUnable to resolve the webhook URL domain name
75002 Could not connect to hostCould not connect to the webhook host
75003 Certificate misconfigurationWebhook host certificate could not be verified
75004 Expired certificateThe webhook host certificate has expired
75005 Certificate name mismatchThe domain name on the certificate does not match the domain in the URL
75006 Untrusted certificate rootThe certificate is not signed by a trusted authority
75299 Webhook host returned a non-200 HTTP 2XXThe server returned an HTTP 2XX code, but was not the expected HTTP 200
75300 Webhook host returned HTTP 3XXThe server returned an HTTP 3XX redirect
75400 Webhook host returned HTTP 400The server returned an HTTP 400
75404 Webhook host returned HTTP 404The server returned an HTTP 404
75499 Webhook host returned HTTP 4XXThe server returned an HTTP 4XX error
75500 Webhook host returned HTTP 500The server returned an HTTP 500
75599 Webhook host returned HTTP 5XXThe server returned an HTTP 5XX error
80000 Wrong accountOne or more numbers you are attempting to port do not belong to the specified account.
80001 Inactive numberOne or more numbers you are attempting to port are not active on the account. Only active numbers may be ported.
80002 Wrong providerTelnyx is not the service provider for one or more of the numbers you are attempting to port.
80003 Pending orderOne or more numbers are already part of another port request.
80004 Invalid desired due dateThe desired due date is not within the allowable window. Please review the porting guidelines.
80005 Invalid passcode or pinThe passcode or PIN provided does not match what has been assigned to the number.
80006 Invalid PONThe Purchase Order Number (PON) provided is invalid. It must be between 3 and 20 characters and may not contain special characters.
80007 FOC expiredThe firm order committment has expired since the number was not ported on the agreed upon due date.
80008 Missing LOAA valid LOA (Letter of Authorization) is required to port numbers.
80009 Illegible LOAThe LOA (Letter of Authorization) provided was illegible or unable to be viewed.
80010 Expired LOAThe LOA (Letter of Authorization) provided has expired and is no longer valid.
80011 Invalid SPIDThe service provider ID (SPID) provided was not recognized.
80012 Unsuported carrierThe functionality requested is not supported with the specified carrier.
80013 Invalid countryAutomated porting is only supported in the US and Canada.
80014 Service address mismatchThe service address provided does not match the address on the account.
80015 Stranded phone numbersThe BTN/ATN on the account is being ported out which would leave stranded any remaining phone numbers.
80016 No CSR data availableA CSR could not be retrieved because the data submitted did not match closely enough with the data on file with the carrier.
80017 Invalid service provider typeThe 'service_provider_type' parameter must be one of either 'Telnyx' or 'Peerless'.
80018 Invalid FOC dateThe 'foc_date' parameter must be an ISO8601 datetime selected from the available FOC dates.
80019 Invalid service provider IDThe 'service_provider_id' parameter must be the ID of an existing service provider.
80020 Invalid subscription statusThe 'subscription_status' parameter is required and must have a value of 'pending', 'concurred', 'timer_expired', 'conflict', 'activated', 'cancel_pending', 'cancelled', 'disconnect_pending', 'disconnected' or 'failed'
80021 Invalid porting optionThe 'porting_option' parameter is required and must have a value of 'full' or 'partial'.
80022 Invalid document typeThe 'document_type' parameter must have value of 'loa', 'csr', 'invoice' or 'other'.
80023 Invalid value for rate centersThe 'rate_centers' parameter must be a list of valid rate centers.
80024 Record could not be deletedThe sub_request could not be deleted as it has associated phone_numbers.
80100 Subscription version not createdThe new service provider did not create an NPAC subscription version.
80101 Subscription version does not matchThe new service provider created an NPAC subscription version that does not match the record Telnyx created.
80200 Duplicate phone numbers foundDuplicate phone numbers were found in the request.
80201 Phone number limit exceededToo many phone numbers were specified for an LSR preorder.
80400 Invalid credentialsThe Port PS account credentials were invalid.
80401 Too many phone numbersThere is a maximum of 1000 lookups per request.
85000 Must search phone number via search API firstYou must search for the number through our API before attempting to purchase.
85001 Phone numbers not availableThe numbers you are trying to order are no longer available for purchase.
85002 Phone numbers update not allowed on this orderYou are trying to update a number that is not in this order.
85003 Regulatory requirements already satisfiedRegulatory requirements cannot be updated once all have been satisfied.
85004 Invalid connection id providedThe connection id provided is invalid.
85005 Invalid messaging profile id providedThe messaging profile id provided is invalid.
85006 The phone number is already reservedThe phone number {number} is already reserved.
85007 Reservation limit exceededYou have too many active phone number reservations.
85008 Reservation extension limit exceededThe reservation has reached its limit of allowed extensions.
90000 Invalid value for formatFormat must be of type 'string' with a value of either 'mp3' or 'wav'.
90001 Invalid value for channelsChannels must be a 'string' with a value of either 'single' or 'dual'.
90002 Invalid value for timeoutThe 'timeout' parameter must be an 'integer' with a minimum and a maximum value accepted by command
90003 Invalid value for inter_digit_timeoutThe 'inter_digit_timeout' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 120000.
90004 Invalid value for minThe 'min' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90005 Invalid value for maxThe 'max' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90006 Invalid value for triesThe 'tries' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90007 Invalid value for terminating_digitThe 'terminating_digit' parameter must be a 'string' with a value of 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, or #.
90008 Invalid value for valid_digitsThe 'valid_digits' parameter must be a 'string' with a value of 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, or #.
90009 Invalid value for loopThe 'loop' parameter must either be 'infinity' or an 'integer' with a minimum value of 1 and a maximum value of 100.
90010 Invalid value for payloadThe 'payload' parameter should contain between 1 and 5000 characters.
90011 Invalid value for payload_typeThe 'payload_type' parameter must be of type 'string' with a value of either text or ssml.
90012 Invalid value for voiceThe 'voice' parameter must be 'female' or 'male' when using the en-US language.
90013 Invalid value for languageThe 'language' parameter must be of type 'string' with a value of either de-DE, en-AU, en-GB, en-US, es-ES, fr-CA, fr-FR, it-IT, ja-JP, ko-KR, nl-NL, pt-BR, sv-SE or tr-TR.
90014 Invalid value for digitsThe 'digits' parameter must be a 'string' made of a combination of either 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, w, W, * or #.
90015 Invalid Call Control IDThe provided call_control_id was not valid.
90016 Invalid value for stopThe 'stop' parameter must be a 'string' with a value of 'all', 'current' or 'overlay'.
90017 Invalid value for client_stateThe 'client_state' parameter must be a valid base64 string.
90018 Call has already endedThis call is no longer active and can't receive commands.
90019 Conference has already endedThis conference is no longer active and can't receive commands.
90020 Call recording triggered before audio startedCall recording cannot be started until audio has commenced on the call.
90021 Invalid value for durationThe 'duration' parameter must be an 'integer' with a minimum value of 100 and a maximum value of 500.
90022 Invalid value for minimum_digitsThe 'minimum_digits' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90023 Invalid value for maximum_digitsThe 'maximum_digits' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90024 Invalid value for maximum_triesThe 'maximum_tries' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 128.
90025 Invalid value for timeout_millisThe 'timeout_millis' parameter must be an 'integer' with a minimum and a maximum value accepted by command
90026 Invalid value for inter_digit_timeout_millisThe 'inter_digit_timeout_millis' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 120000.
90027 Invalid value for duration_millisThe 'duration_millis' parameter must be an 'integer' with a minimum value of 100 and a maximum value of 500.
90028 Invalid value for timeout_secsThe 'timeout_secs' parameter must be an 'integer' with a minimum and a maximum value accepted by command
90029 Invalid value for time_limit_secsThe 'time_limit_secs' parameter must be an 'integer' with a minimum value of 60 and a maximum value of 14,000.
90030 Invalid value for service_levelThe 'service_level' parameter must be of type 'string' with a value of either 'basic' or 'premium'.
90031 Call is not currently forkedCan't stop forking, because the call isn't currently forked.
90032 Too many conference participantsThe participant is unable to join because the maximum number of participants ({num}) has been reached.
90033 Conference has no active participantsThis conference does not have any active participants.
90034 Call has not been answered yetThis call can't receive this command because it has not been answered yet.
90035 Call not in queueThis call can't receive this command because it has not been put in any queue yet.
90036 Queue fullThe queue is full and can't accept more calls.
90037 Queue max_size cannot be modifiedQueue exists and max_size cannot be modified.
90038 Call already in queueCall can't be added to a queue it's already in.
90040 Downloading audio file failedProvided audio file couldn't be downloaded due to a timeout.
90041 User termination channels limit exceededThe limit of simultaneous termination channels configured to your user has been reached.
90042 Outbound voice profile channels limit exceededThe limit of simultaneous channels configured to the outbound voice profile associated to this connection has been reached.
90043 Connection outbound channels limit exceededThe limit of simultaneous outbound channels configured to this call control connection has been reached.
90044 Conference join not allowedParticipant must not join the same conference twice.
90045 Media Streaming is used.This command can't be issued when media streaming is used.
90046 Media Streaming Failed.The media streaming failed to start.
90048 Media Streaming is not used.This command can only be issued when media streaming is used.
90049 Invalid value for record_timeout_secsThe 'record_timeout_secs' parameter must be an 'integer' with a minimum value of 0.
90053 Call recording triggered with 'timeout_secs' while transcribingCall recording can not be started with 'timeout_secs' while the call is being transcribed.
90054 Call Transcription is already in progressCall Transcription can not be started more than once.
90055 Call transcription can not be stoppedCall transcription can not be stopped while there is a recording with 'timeout_secs' in progress.
90056 Invalid value for initial_timeout_millisThe 'initial_timeout_millis' parameter must be an 'integer' with a minimum value of 1 and a maximum value of 120000.
90057 Invalid call control event type for webhook_urlsThe webhook_urls json keys must be valid call control event types.
90058 Invalid conference_id or wrong regionThe conference does not exist or was created in the other region.
90059 Invalid value for recording_trackThe 'recording_track' parameter must be a 'string' with a value of either 'inbound', 'outbound' or 'both'.
90080 Cannot issue a command on fax in the current state.This command can only be issued when a fax is in either queued, media.processed or sending state.
90081 Cannot issue command for inbound fax.This command can only be issued for outbound fax.
90100 Notification key is invalidThe notification key provided is invalid.
90101 Notification context is invalidThe required notification context was either invalid or not included in the request.
90102 Command is invalidCall answer command cannot be issued for outbound calls.
100001 Invalid Dialogflow APIThe value should be either 'es' or 'cx'