Errors that may arise when performing tasks like searching for phone numbers or ordering phone numbers have specific error codes associated with them. These error codes and a human readable description are listed on this page.
XML tags <Code>
and <Description>
will be included in the response body. Refer to the API endpoints for specific formats. Below is an example for a response when trying to order a malformed phone number.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OrderResponse>
<ErrorList>
<Error>
<Code>5070</Code>
<Description>Telephone number is invalid.</Description>
<TelephoneNumber>55544433</TelephoneNumber>
</Error>
</ErrorList>
<Order>
<CustomerOrderId>id</CustomerOrderId>
<OrderCreateDate>2020-07-29T18:43:56.389Z</OrderCreateDate>
<BackOrderRequested>false</BackOrderRequested>
<ExistingTelephoneNumberOrderType>
<TelephoneNumberList>
<TelephoneNumber>5554443333</TelephoneNumber>
<TelephoneNumber>55544433</TelephoneNumber>
</TelephoneNumberList>
</ExistingTelephoneNumberOrderType>
<PartialAllowed>true</PartialAllowed>
<SiteId>123</SiteId>
</Order>
</OrderResponse>