You are here: API Commands > API Error Codes

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