API Error Codes
When you run a query against the eNom API, the response includes a numeric code and a corresponding text message. This allows us to standardize our responses and make them more specific; it also allows our international resellers to translate API responses to their local language.
Please note that the numeric codes are the stable standard on which you should build. The catalog of numeric codes will grow, but any individual code will remain stable once it is created. You are free to create your own text messages—in fact, we encourage you to do so—using the tables below as a guideline.
The numerical response codes are six-digit numbers that indicate the system, type of error, and parameter that are the subjects of this response.
- The first digit in each six-digit error code indicates the system that is generating the message. For example, error codes that begin with 4 indicate authentication errors. This first digit is referred to as the system bit.
- The second and third digits in an error code indicate the nature of the error. For example, x04xxx indicates invalid data. These digits are referred to as the error bit.
- The last three digits in an error code indicate the parameter that is failing. For example, xxx156 indicates a problem with the password. These digits are referred to as the parameter bit.
Error code components
System bit
The first digit in each six-digit error code indicates the system that is generating the message. This first digit is referred to as the system bit.
| System bit | Definition |
|---|---|
| 0xxxxx | An unknown error has occurred |
| 1xxxxx | Command completed successfully |
| 2xxxxx | Registry error |
| 3xxxxx | Validation error |
| 4xxxxx | Authentication error |
| 5xxxxx | Payment error |
| 6xxxxx | System error |
| 7xxxxx | Policy error |
Error bit
The second and third digits in an error code indicate the nature of the error. These digits are referred to as the
error bit.
| Error bit | Definition |
|---|---|
| x00xxx | Does not apply |
| x01xxx | Missing |
| x02xxx | Duplicate |
| x03xxx | Out of range |
| x04xxx | Invalid |
| x05xxx | Type mismatch |
| x06xxx | Policy violation |
| x07xxx | Connection failed |
| x08xxx | Failed to retrieve |
| x09xxx | Failed to add |
| x10xxx | Failed to update |
| x11xxx | Failed to delete |
| x12xxx | Disabled |
| x13xxx | Unauthorized |
| x14xxx | Declined |
| x15xxx | Not available |
| x16xxx | Not found |
| x17xxx | Expired |
| x18xxx | Down for maintenance |
| x19xxx | Failed to deduct |
| x20xxx | Failed to send |
| x99xxx | Unknown |
Parameter bit
The last three digits in an error code indicate the parameter that is failing. These digits are referred to as the
parameter bit.
| Parameter bit | Definition |
|---|---|
| xxx000 | Does not apply |
| xxx001 | First name (generic); for specific contact types see xxx019 through xxx024 |
| xxx002 | Last name (generic); for specific contact types see xxx025 through xxx029 |
| xxx003 | Address (generic); for specific contact types see xxx030 through xxx034 |
| xxx004 | City (generic); for specific contact types see xxx040 through xxx044 |
| xxx005 | State/Province (generic); for specific contact types see xxx045 through xxx049 |
| xxx006 | Postal code (generic); for specific contact types see xxx050 through xxx054 |
| xxx007 | Country (generic); for specific contact types see xxx055 through xxx059 |
| xxx008 | Job title (generic); for specific contact types see xxx060 through xxx064 |
| xxx009 | Organization (generic) |
| xxx010 | Phone number (generic); for specific contact types see xxx065 through xxx069 |
| xxx011 | Fax number (generic); for specific contact types see xxx070 through xxx074 |
| xxx012 | Email (generic); for specific contact types see xxx075 through xxx079 |
| xxx019 | Registrant contact first name |
| xxx021 | Auxiliary Billing contact first name |
| xxx022 | Technical contact first name |
| xxx023 | Administrative contact first name |
| xxx024 | Billing contact first name |
| xxx025 | Registrant contact last name |
| xxx026 | Auxiliary Billing contact last name |
| xxx027 | Technical contact last name |
| xxx028 | Administrative contact last name |
| xxx029 | Billing contact last name |
| xxx030 | Registrant contact address, line 1 |
| xxx031 | Auxiliary Billing contact address, line 1 |
| xxx032 | Technical contact address, line 1 |
| xxx033 | Administrative contact address, line 1 |
| xxx034 | Billing contact address, line 1 |
| xxx035 | Registrant contact address, line 2 |
| xxx036 | Auxiliary Billing contact address, line 2 |
| xxx037 | Technical contact address, line 2 |
| xxx038 | Administrative contact address, line 2 |
| xxx039 | Billing contact address, line 2 |
| xxx040 | Registrant contact city |
| xxx041 | Auxiliary Billing contact city |
| xxx042 | Technical contact city |
| xxx043 | Administrative contact city |
| xxx044 | Billing contact city |
| xxx045 | Registrant contact state/province |
| xxx046 | Auxiliary Billing contact state/province |
| xxx047 | Technical contact state/province |
| xxx048 | Administrative contact state/province |
| xxx049 | Billing contact state/province |
| xxx050 | Registrant contact postal code |
| xxx051 | Auxiliary Billing contact postal code |
| xxx052 | Technical contact postal code |
| xxx053 | Administrative contact postal code |
| xxx054 | Billing contact postal code |
| xxx055 | Registrant contact country |
| xxx056 | Auxiliary Billing contact country |
| xxx057 | Technical contact country |
| xxx058 | Administrative contact country |
| xxx059 | Billing contact country |
| xxx060 | Registrant contact job title |
| xxx061 | Auxiliary Billing contact job title |
| xxx062 | Technical contact job title |
| xxx063 | Administrative contact job title |
| xxx064 | Billing contact job title |
| xxx065 | Registrant contact phone |
| xxx066 | Auxiliary Billing contact phone |
| xxx067 | Technical contact phone |
| xxx068 | Administrative contact phone |
| xxx069 | Billing contact phone |
| xxx070 | Registrant contact fax |
| xxx071 | Auxiliary Billing contact fax |
| xxx072 | Technical contact fax |
| xxx073 | Administrative contact fax |
| xxx074 | Billing contact fax |
| xxx075 | Registrant contact email |
| xxx076 | Auxiliary Billing contact email |
| xxx077 | Technical contact email |
| xxx078 | Administrative contact email |
| xxx079 | Billing contact email |
| xxx144 | Party ID |
| xxx145 | Registrant contact (use this when you are unable to retrieve the entire block of registrant contact information) |
| xxx146 | Auxiliary Billing contact (entire block) |
| xxx147 | Technical contact (entire block) |
| xxx148 | Administrative contact (entire block) |
| xxx149 | Billing contact (entire block) |
| xxx150 | Command |
| xxx151 | SLD |
| xxx152 | TLD |
| xxx153 | Domain name |
| xxx154 | Expiration date (applies to all domains and services) |
| xxx155 | Login ID |
| xxx156 | Password (use this for domain name account password and domain password; xxx303 is Web hosting account password) |
| xxx157 | Subaccount(s) (generic) |
| xxx158 | Name server name |
| xxx159 | Name server IP address |
| xxx160 | End user IP address |
| xxx161 | Server IP address |
| xxx162 | Parking page |
| xxx163 | Renewal settings |
| xxx164 | Notification amount |
| xxx165 | Customer preferences |
| xxx166 | Connection timeout |
| xxx167 | Session timeout |
| xxx168 | Account type |
| xxx169 | Domain count |
| xxx170 | Email record(s) |
| xxx171 | Host records(s) |
| xxx172 | Forward to |
| xxx173 | URL address (forwarding—URL address in host records) |
| xxx174 | Price(s) |
| xxx175 | Queue |
| xxx176 | Club Drop |
| xxx177 | Reseller key |
| xxx178 | Reseller pricing |
| xxx179 | Retail pricing |
| xxx180 | Price break |
| xxx181 | Account balance |
| xxx182 | Product type |
| xxx183 | Quantity |
| xxx184 | Reference(s) |
| xxx185 | Authorization answer |
| xxx186 | Order number |
| xxx187 | Reference number |
| xxx188 | Page |
| xxx189 | Page size |
| xxx190 | URL (generic, including paging) |
| xxx191 | Address book |
| xxx192 | Shopping cart |
| xxx193 | Item ID |
| xxx194 | Host name (name of a host record, not a Web hosting account) |
| xxx195 | Address |
| xxx196 | Month |
| xxx197 | Year(s) |
| xxx198 | Card type |
| xxx199 | Cardholder name |
| xxx200 | Cardholder address |
| xxx201 | Cardholder city |
| xxx202 | Cardholder state/province |
| xxx203 | Cardholder postal code |
| xxx204 | Cardholder country |
| xxx205 | Credit card number |
| xxx206 | Cardholder phone |
| xxx207 | Amount |
| xxx208 | Address does not match |
| xxx209 | Postal code does not match |
| xxx210 | Credit card verification number |
| xxx217 | Date |
| xxx218 | Metatag(s) |
| xxx219 | Watch list |
| xxx220 | Service(s) |
| xxx221 | Transfer order(s) |
| xxx222 | Transfer order detail(s) |
| xxx223 | Web Site Builder |
| xxx224 | Information |
| xxx225 | Option ID |
| xxx226 | Token |
| xxx227 | Count |
| xxx228 | Registrar Lock |
| xxx229 | Domain name ID |
| xxx230 | Credit card processing |
| xxx231 | Credit card information |
| xxx232 | Contact (generic) |
| xxx233 | Item count |
| xxx234 | Page view(s) |
| xxx235 | Bundle (generic—use for .name bundle, and so on) |
| xxx236 | Item(s) |
| xxx237 | Character limit |
| xxx238 | Word(s) |
| xxx239 | Status |
| xxx240 | Commission balance |
| xxx241 | Load parameter |
| xxx242 | Order(s) |
| xxx243 | RequestID |
| xxx244 | Record(s) |
| xxx245 | Preference(s) |
| xxx246 | Time stamp |
| xxx247 | Reseller API |
| xxx248 | Reseller |
| xxx249 | Active reseller |
| xxx250 | Usage |
| xxx251 | Setting(s) |
| xxx252 | Request(s) |
| xxx253 | Parking text |
| xxx254 | User(s) |
| xxx255 | Account(s) |
| xxx256 | Option |
| xxx257 | Order type |
| xxx258 | Authorization |
| xxx259 | Order ID |
| xxx260 | Detail ID |
| xxx261 | Action |
| xxx262 | Comment(s) |
| xxx263 | Display flag |
| xxx264 | Object(s) |
| xxx265 | Date |
| xxx266 | Image(s) |
| xxx267 | Preconfigure DNS |
| xxx268 | Submit times |
| xxx269 | Pak ID of a POP pak associated with a domain name in a domain name account. For POP units associated with a Web hosting account, see xxx314. For package IDs of products other than domain name POP paks, see xxx327. |
| xxx270 | Meta base |
| xxx271 | POP pak associated with a domain name in a domain name account. For POP units associated with a Web hosting account, see xxx314. |
| xxx272 | Full name |
| xxx273 | Runtime |
| xxx274 | Product ID |
| xxx275 | Bid |
| xxx276 | Auction |
| xxx277 | Site ID |
| xxx278 | Location name |
| xxx279 | Group name |
| xxx280 | URI |
| xxx281 | Time zone |
| xxx282 | Start time |
| xxx283 | End time |
| xxx284 | Alert interval |
| xxx285 | Name server(s) |
| xxx286 | User name of a POP mailbox in a POP pak associated with a domain name. For a Web-hosting-account mailbox, see xxx313. |
| xxx287 | Keyword (generic) |
| xxx288 | Type (generic) |
| xxx289 | Extended attribute |
| xxx290 | Contact information (generic) |
| xxx291 | Cookie |
| xxx292 | MX Preference |
| xxx293 | Record type |
| xxx294 | Accounting transaction |
| xxx295 | Account information |
| xxx296 | TLD information |
| xxx297 | Site processor |
| xxx298 | Registrar information |
| xxx299 | Database |
| xxx300 | Hosts count (number of Web hosting accounts in a domain name account) |
| xxx301 | Web hosting account directory |
| xxx302 | Web hosting account user name |
| xxx303 | Web hosting account password |
| xxx304 | Web hosting host header(s) |
| xxx305 | Domain header(s) |
| xxx306 | File permissions |
| xxx307 | Files |
| xxx308 | SQL table(s) |
| xxx309 | Server information |
| xxx310 | Bandwidth |
| xxx311 | Web hosting account ID |
| xxx312 | Database storage |
| xxx313 | Individual POP3 mailboxes in a Web hosting account. For POP paks associated with a domain name in a domain name account, see xxx271. |
| xxx314 | POP paks (units of 10) in a Web hosting account. For POP paks associated with a domain name in a domain name account, see xxx271. |
| xxx315 | Web storage |
| xxx316 | Overage option |
| xxx317 | Stored procedure name |
| xxx318 | SQL statement |
| xxx319 | Table name |
| xxx320 | Index name |
| xxx321 | Database column |
| xxx322 | Database type |
| xxx323 | Operating system type |
| xxx324 | Web hosting account ID |
| xxx325 | Path name |
| xxx326 | Package(s) Use for all packages except POP paks associated with a domain name in a domain name account. For domain-name POP paks, see xxx271. |
| xxx327 | Package ID Use for all products sold as multiple-unit “packages” except POP paks associated with a domain name in a domain name account. For the Pak ID of a domain-name POP pak, see xxx269. |
| xxx328 | Package name |
| xxx329 | Stored procedure text |
| xxx330 | Stored procedure(s) |
| xxx331 | Index property(s) |
| xxx350 | Agreement |
| xxx351 | Secret type |
| xxx352 | Display name |
| xxx353 | Location count |
| xxx354 | Notification count |
| xxx355 | ExpiredCount—number of expired domain names currently in this account. |
| xxx356 | DomainCount_Others |
| xxx357 | ExpiredCount_Others |
| xxx358 | Language code |
| xxx359 | Day(s) |
| xxx360 | Order status |
| xxx361 | Email key(s) |
| xxx362 | Registrar |
| xxx363 | Color |
| xxx364 | Fraud record(s) |
| xxx365 | Fraud type |
| xxx366 | Fraud value |
| xxx367 | Fraud level |
| xxx368 | Enable instruction(s) |
| xxx369 | PayPal contract |
| xxx370 | Category ID |
| xxx371 | Subcategory ID |
| xxx372 | Category name |
| xxx373 | Subcategory name |
| xxx374 | Category keyword type code |
| xxx375 | Filter mask |
| xxx376 | Category keyword reference ID |
| xxx377 | Category keyword relevance level |
| xxx378 | Access control violation -- Stored procedure failure |
| xxx379 | Access control violation -- Access control lock |
| xxx380 | Access control violation -- Domain not under account |
| xxx381 | Access control violation -- Escrow hold |
| xxx382 | Access control violation -- Invalid PartyID |
| xxx383 | Access control violation -- Invalid access type |
| xxx384 | Invalid promotion code |
| xxx385 | Adult |
| xxx386 | Hard core |
| xxx387 | China |
| xxx388 | Web Site Creator |
| xxx999 | Unknown |