ENom API Reference
ENom API Reference
ENom API Reference
- ii -
Contents
Overview 1
Domains and TLDs 2
Selling and Managing Domains 2
Contents 3
Why sell domain names? 3
Audience for this guide 3
If you use the AddToCart command 3
Help with implementation 3
Domain registration and management 3
Task 1Decide which TLDs to offer 4
Sample query strings: 4
Task 2Set pricing 5
Task 3Choose universal settings 5
Task 4Check domain names 6
Sample query strings: 6
Task 5Bill and register domain names 7
Sample query strings: 8
Task 6List domain names and their statuses 9
Sample query strings: 9
Task 7Retrieve status information 9
Sample query strings: 10
Task 8Manage Whois and other contacts 10
Sample query strings: 11
Task 9Set name servers 12
Sample query strings: 13
Task 10Set host records 13
Sample query strings: 14
Task 11Protect domain names from hijacking 15
- iii -
Sample query strings: 15
Task 12Renew domain names 16
Sample query strings: 17
Task 13Offer DNS Hosting 18
Sample query strings: 19
Task 14Transfer domain names in 19
Sample query strings: 20
Task 15Transfer domain names away 22
Sample query strings: 22
New TLD - Watchlist 23
Usage 23
LIST 24
International Domain Name (IDN) 24
Step 1 - Add domain(s) to a new or existing LIST in a Watchlist 25
Step 2 - Get Watchlist LIST 25
Step 3 - Delete domain(s)/LIST from a Watchlist 25
Agreement Page 26
New TLD - Queue 26
Step 1 - Get Queue information 26
Step 2 - Get Extended Attributes 27
Step 3 - Purchase domain(s) in a Queue 27
Step 4 - Get Queue domains 27
Order history and detail 28
Agreement Page 28
.ASIA Eligibility Requirements 28
Whats changing 28
Timeline and test environment 29
Audience for this document 29
Where the changes apply 29
- iv -
.ASIA-approved countries 30
.AU, .ES and .PE 32
TLD Settings 33
Step 1 - Extended Attributes 33
Step 2 - Purchase 33
Real-time 33
Shopping cart 34
Agreement Pages 34
.CA Business Rules 35
Audience 35
Affected API commands 35
Overview of .ca eligibility requirements and contact types 35
When to use contact names and organization names 37
Source of this information 37
Valid formats and data values for .ca 37
Corporation (Canada or Canadian province or territory) 37
Registrant name format requirements 38
Canadian citizen 38
Registrant name format requirements 38
Permanent resident of Canada 39
Registrant name format requirements 39
Government or government entity in Canada 40
Registrant name format requirements 40
Canadian educational institution 40
Registrant name format requirements 41
Canadian unincorporated association 41
Registrant name format requirements 42
Canadian hospital 42
Registrant name format requirements 42
-v-
Partnership registered in Canada 43
Registrant name format requirements 43
Trade-mark registered in Canada by non-Canadian owner 43
Registrant name format requirements 44
Canadian trade union 44
Registrant name format requirements 44
Canadian political party 45
Registrant name format requirements 45
Canadian library, archive or museum 45
Registrant name format requirements 45
Trust established in Canada 46
Registrant name format requirements 46
Aboriginal Peoples (individuals) indigenous to Canada 46
Registrant name format requirements 47
Aboriginal Peoples (groups) indigenous to Canada 47
Registrant name format requirements 47
Indian Band recognized by the Indian Act of Canada 48
Registrant name format requirements 48
Legal representative of a Canadian citizen or permanent resident 48
Registrant name format requirements 49
Official marks registered in Canada 49
Registrant name format requirements 49
Her Majesty the Queen 50
Registrant name format requirements 50
About valid and invalid contact names 50
Required terms in contact information for non-Individuals 50
Disallowed terms in contact information for Individuals 52
Authorization Information 55
Permitted formats for input values 56
- vi -
Domain Names 56
Email Addresses 56
IP Addresses 56
Postal Codes 56
Telephone and Fax Numbers, and telephone extensions 57
Permitted values for country, province, and state codes 57
Country codes 57
Canadian province codes 66
US state, territory, or region codes 67
.AU, .ES and .PE 69
TLD Settings 70
Step 1 - Extended Attributes 70
Step 2 - Purchase 70
Real-time 70
Shopping cart 71
Agreement Pages 71
.EU Transfer 72
Schedule 72
Changes 72
SINGLE CALL 72
MULTIPLE CALLS 72
.NU Registrant Requirements 73
What's changing 73
Timeline and test environment 74
Step 1 - Get Extended Attributes 74
Step 2 - Purchase 75
Real-time 75
Shopping cart 75
Agreement Pages 76
- vii -
Related commands 76
.AU, .ES and .PE 76
TLD Settings 77
Step 1 - Extended Attributes 77
Step 2 - Purchase 77
Real-time 77
Shopping cart 78
Agreement Pages 78
Nominet (.UK Registry) System Changes 79
Description 79
Multi-Year Registrations and Renewals 79
Real-Time Response 79
API Real-Time Purchase Sample 80
Get extended attributes 82
.xxx 83
Purchase 84
Preconfigure 85
Get extended attributes 88
Membership 89
.XXX Transfer 91
Description 91
Quick transfer 91
Pre-Configuration method 93
1. TP_CreateOrder 94
2. TP_UpdateOrderDetail 95
3. TP_SubmitOrder 97
API Command Categories 99
Domain Registration 99
Domain RegistrationPremium Domains 99
- viii -
Domain ManagementHost Records 99
Domain ManagementName Servers 100
Domain ManagementContacts 100
Domain ManagementGeneral 100
Domain ManagementMagic Folders 101
Domain Management.tel 101
Domain ManagementWatchlist 101
Domain Management.xxx 101
Domain Renewal 102
Domain Transfer 102
DNS Hosting 102
Domain Services 103
Service ManagementIdentity Protection 103
Service ManagementSSL Certificates 103
Service ManagementTRUSTe Privacy Policy 103
Service ManagementVeriSign Trust Seal 104
Service ManagementGeoTrust Anti-Malware 104
Service ManagementSiteLock 104
Service ManagementRichContent 104
Service ManagementBusiness Listing 104
Service ManagementEmail Services 105
Service ManagementWeb Site Creator 105
Service ManagementgoMobi 105
Account 106
Accounting 106
Shopping Cart 107
Real-Time Purchase 107
Reporting commands 107
Customer Support 108
- ix -
Web Hosting Packages 108
Web Site Creator packages 108
Web Hosting Accounts and Accounting 108
Web contentdirectories and files 109
Domain Headers 109
Host Headers 109
IIS Applications 109
POP3 Email in Web Hosting Packages 109
SQL Database 110
AddBulkDomains 110
Description 110
Constraints 110
Input parameters 110
Returned parameters and values 112
Notes 112
Example 112
Related commands 114
AddContact 114
Description 114
Constraints 115
Input parameters 115
Returned parameters and values 116
Notes 116
Example 117
Related commands 118
AddDomainFolder 118
Description 118
Constraints 119
Input parameters 119
-x-
Returned parameters and values 120
Notes 121
Example 121
Related commands 122
AddDomainHeader 122
Description 122
Constraints 123
Input parameters 123
Returned parameters and values 124
Notes 124
Example 124
Related commands 125
AddHostHeader 125
Description 125
Constraints 126
Input parameters 126
Returned parameters and values 127
Notes 127
Example 127
Related commands 128
AddToCart 129
Description 129
Constraints 129
Input parameters 129
Input parameters for domains 130
Input parameters for dot-name 132
Input parameters for ID Protect 133
Input parameters for SSL certificates 134
Input parameters for TRUSTe Privacy Policy 136
- xi -
Input parameters for VeriSign Trust Seal 137
Input parameters for GeoTrust Anti-Malware 138
Input parameters for SiteLock 139
Input parameters for RichContent 140
Input parameters for Business Listing 141
Input parameters for POP Email 142
Input parameters for Email Forwarding and URL Forwarding 144
Input parameters for Instant Reseller 145
Input parameters for Web hosting 146
Input parameters for Web Site Creator 147
Input parameters for goMobi 148
Returned parameters and values 149
Notes 150
Example 150
Related commands 151
AdvancedDomainSearch 151
Description 151
Constraints 152
Input parameters 152
Returned parameters and values 155
Notes 158
Example 158
Related commands 162
AM_AutoRenew 162
Description 162
Constraints 163
Input parameters 163
Returned parameters and values 163
Notes 164
- xii -
Example 164
Related commands 165
AM_Configure 165
Description 165
Constraints 165
Input parameters 166
Returned parameters and values 167
Notes 167
Example 167
Related commands 168
AM_GetAccountDetail 168
Description 168
Constraints 169
Input parameters 169
Returned parameters and values 169
Notes 170
Example 170
Related commands 171
AM_GetAccounts 172
Description 172
Constraints 172
Input parameters 172
Returned parameters and values 174
Notes 174
Example 174
Related commands 176
AssignToDomainFolder 176
Description 176
Constraints 177
- xiii -
Input parameters 177
Returned parameters and values 178
Notes 179
Example 179
Related commands 180
AuthorizeTLD 181
Description 181
Constraints 181
Input parameters 182
Returned parameters and values 182
Notes 183
Example 183
Related commands 184
AutoRenew 184
Description 184
Constraints 185
Input parameters 185
Returned parameters and values 185
Notes 186
Example 186
Related commands 187
CalculateAllHostPackagePricing 187
Description 187
Constraints 188
Input parameters 188
Returned parameters and values 188
Notes 189
Example 190
Related commands 191
- xiv -
CalculateHostPackagePricing 192
Description 192
Constraints 192
Input parameters 192
Returned parameters and values 194
Notes 194
Example 195
Related commands 196
CancelHostAccount 197
Description 197
Constraints 197
Input parameters 197
Returned parameters and values 199
Notes 199
Example 199
Related commands 200
CancelOrder 200
Description 200
Constraints 201
Input parameters 201
Returned parameters and values 201
Notes 202
Example 202
Related commands 203
CertChangeApproverEmail 203
Description 203
Constraints 204
Input parameters 204
Returned parameters and values 205
- xv -
Notes 205
Example 205
Related commands 206
CertConfigureCert 207
Description 207
Constraints 207
Input parameters 207
Returned parameters and values 212
Notes 213
Example 213
Related commands 216
CertGetApproverEmail 216
Description 216
Constraints 217
Input parameters 217
Returned parameters and values 217
Notes 218
Example 218
Related commands 220
CertGetCertDetail 220
Description 220
Constraints 221
Input parameters 221
Returned parameters and values 221
Notes 223
Example 223
Related commands 227
CertGetCerts 228
Description 228
- xvi -
Constraints 228
Input parameters 228
Returned parameters and values 230
Notes 231
Example 231
Related commands 233
CertModifyOrder 233
Description 233
Constraints 234
Input parameters 234
Returned parameters and values 234
Notes 235
Example 235
Related commands 236
CertParseCSR 236
Description 236
Constraints 237
Input parameters 237
Returned parameters and values 238
Notes 238
Example 238
Related commands 240
CertPurchaseCert 240
Description 240
Constraints 241
Input parameters 241
Returned parameters and values 243
Notes 243
Example 243
- xvii -
Related commands 244
CertReissueCert 244
Description 244
Constraints 245
Input parameters 245
Returned parameters and values 246
Notes 246
Example 246
Related commands 248
CertResendApproverEmail 248
Description 248
Constraints 249
Input parameters 249
Returned parameters and values 250
Notes 250
Example 250
Related commands 251
CertResendFulfillmentEmail 252
Description 252
Constraints 252
Input parameters 252
Returned parameters and values 253
Notes 253
Example 253
Related commands 254
Check 255
Description 255
Constraints 255
Input parameters 256
- xviii -
Returned parameters and values 256
Notes 257
Example 257
Related commands 258
CheckLogin 259
Description 259
Constraints 259
Input parameters 259
Returned parameters and values 260
Notes 261
Example 262
Related commands 265
CheckNSStatus 265
Description 265
Constraints 266
Input parameters 266
Returned parameters and values 267
Notes 267
Example 267
Related commands 268
CommissionAccount 269
Description 269
Constraints 269
Input parameters 269
Returned parameters and values 270
Notes 270
Example 270
Related commands 272
Contacts 272
- xix -
Description 272
Constraints 273
Input parameters 273
Returned parameters and values 275
Notes 276
Example 276
Related commands 277
CreateAccount 278
Description 278
Constraints 278
Input parameters 278
Returned parameters and values 281
Notes 283
Example 283
Related commands 285
CreateHostAccount 286
Description 286
Constraints 286
Input parameters 287
Returned parameters and values 288
Notes 289
Example 289
Related commands 290
CreateSubAccount 290
Description 290
Constraints 291
Input parameters 291
Returned parameters and values 293
Notes 293
- xx -
Example 293
Related commands 294
DeleteAllPOPPaks 295
Description 295
Constraints 295
Input parameters 295
Returned parameters and values 296
Notes 296
Example 297
Related commands 297
DeleteContact 298
Description 298
Constraints 298
Input parameters 298
Returned parameters and values 299
Notes 299
Example 299
Related commands 300
DeleteCustomerDefinedData 300
Description 300
Constraints 301
Input parameters 301
Returned parameters and values 302
Notes 302
Example 302
Related commands 303
DeleteDomainFolder 303
Description 303
Constraints 304
- xxi -
Input parameters 304
Returned parameters and values 305
Notes 305
Example 305
Related commands 306
DeleteDomainHeader 306
Description 306
Constraints 307
Input parameters 307
Returned parameters and values 308
Notes 308
Example 309
Related commands 309
DeleteFromCart 310
Description 310
Constraints 310
Input parameters 310
Returned parameters and values 311
Notes 311
Example 311
Related commands 312
DeleteHostedDomain 313
Description 313
Constraints 313
Input parameters 313
Returned parameters and values 314
Notes 314
Example 314
Related commands 315
- xxii -
DeleteHostHeader 316
Description 316
Constraints 316
Input parameters 316
Returned parameters and values 317
Notes 317
Example 318
Related commands 318
DeleteNameServer 319
Description 319
Constraints 319
Input parameters 319
Returned parameters and values 320
Notes 320
Example 321
Related commands 322
DeletePOP3 322
Description 322
Constraints 322
Input parameters 322
Returned parameters and values 323
Notes 323
Example 324
Related commands 324
DeletePOPPak 325
Description 325
Constraints 325
Input parameters 325
Returned parameters and values 326
- xxiii -
Notes 326
Example 327
Related commands 327
DeleteRegistration 328
Description 328
Constraints 328
Input parameters 328
Returned parameters and values 329
Notes 329
Example 330
Related commands 331
DeleteSubaccount 331
Description 331
Constraints 331
Input parameters 332
Returned parameters and values 332
Notes 333
Example 333
Related commands 334
DisableFolderApp 334
Description 334
Constraints 335
Input parameters 335
Returned parameters and values 335
Notes 336
Example 336
Related commands 337
DisableServices 337
Description 337
- xxiv -
Constraints 338
Input parameters 338
Returned parameters and values 338
Notes 339
Example 339
Related commands 340
EnableFolderApp 340
Description 340
Constraints 341
Input parameters 341
Returned parameters and values 341
Notes 342
Example 342
Related commands 343
EnableServices 343
Description 343
Constraints 344
Input parameters 344
Returned parameters and values 344
Notes 345
Example 345
Related commands 346
Extend 346
Description 346
Constraints 347
Input parameters 347
Returned parameters and values 350
Notes 350
Example 351
- xxv -
Related commands 352
Extend_RGP 352
Description 352
Constraints 353
Input parameters 353
Returned parameters and values 354
Notes 354
Example 354
Related commands 355
ExtendDomainDNS 356
Description 356
Constraints 356
Input parameters 357
Returned parameters and values 359
Notes 360
Example 360
Related commands 361
Forwarding 361
Description 361
Constraints 362
Input parameters 362
Returned parameters and values 363
Notes 363
Example 363
Related commands 364
GetAccountInfo 365
Description 365
Constraints 365
Input parameters 365
- xxvi -
Returned parameters and values 366
Notes 366
Example 367
Related commands 368
GetAccountPassword 368
Description 368
Constraints 369
Input parameters 369
Returned parameters and values 369
Notes 370
Example 370
Related commands 371
GetAccountValidation 371
Description 371
Constraints 372
Input parameters 372
Returned parameters and values 372
Notes 373
Example 373
Related commands 374
GetAddressBook 375
Description 375
Constraints 375
Input parameters 375
Returned parameters and values 376
Notes 377
Example 377
Related commands 380
GetAgreementPage 380
- xxvii -
Description 380
Constraints 380
Input parameters 381
Returned parameters and values 383
Notes 383
Example 383
Related commands 385
GetAllAccountInfo 385
Description 385
Constraints 386
Input parameters 386
Returned parameters and values 386
Notes 388
Example 388
Related commands 390
GetAllDomains 391
Description 391
Constraints 391
Input parameters 391
Returned parameters and values 393
Notes 393
Example 393
Related commands 395
GetAllHostAccounts 395
Description 395
Constraints 396
Input parameters 396
Returned parameters and values 396
Notes 397
- xxviii -
Example 397
Related commands 399
GetAllResellerHostPricing 399
Description 399
Constraints 400
Input parameters 400
Returned parameters and values 400
Notes 401
Example 402
Related commands 404
GetBalance 404
Description 404
Constraints 405
Input parameters 405
Returned parameters and values 405
Notes 406
Example 406
Related commands 407
GetCartContent 407
Description 407
Constraints 408
Input parameters 408
Returned parameters and values 409
Notes 410
Example 410
Related commands 413
GetCatchAll 413
Description 413
Constraints 414
- xxix -
Input parameters 414
Returned parameters and values 414
Notes 415
Example 415
Related commands 416
GetCerts 416
Description 416
Constraints 417
Input parameters 417
Returned parameters and values 417
Notes 418
Example 418
Related commands 420
GetConfirmationSettings 420
Description 420
Constraints 421
Input parameters 421
Returned parameters and values 421
Notes 422
Example 422
Related commands 423
GetContacts 424
Description 424
Constraints 424
Input parameters 424
Returned parameters and values 425
Notes 427
Example 427
Related commands 432
- xxx -
GetCusPreferences 432
Description 432
Constraints 433
Input parameters 433
Returned parameters and values 433
Notes 435
Example 436
Related commands 437
GetCustomerDefinedData 438
Description 438
Constraints 438
Input parameters 438
Returned parameters and values 439
Notes 440
Example 440
Related commands 441
GetCustomerPaymentInfo 441
Description 441
Constraints 441
Input parameters 441
Returned parameters and values 442
Notes 443
Example 443
Related commands 444
GetDNS 444
Description 444
Constraints 445
Input parameters 445
Returned parameters and values 445
- xxxi -
Notes 446
Example 446
Related commands 447
GetDNSStatus 448
Description 448
Constraints 448
Input parameters 448
Returned parameters and values 449
Notes 449
Example 449
Related commands 450
GetDomainCount 451
Description 451
Constraints 451
Input parameters 451
Returned parameters and values 452
Notes 452
Example 453
Related commands 454
GetDomainExp 454
Description 454
Constraints 455
Input parameters 455
Returned parameters and values 456
Notes 456
Example 456
Related commands 457
GetDomainFolderDetail 458
Description 458
- xxxii -
Constraints 458
Input parameters 458
Returned parameters and values 459
Notes 462
Example 463
Related commands 467
GetDomainFolderList 467
Description 467
Constraints 468
Input parameters 468
Returned parameters and values 469
Notes 469
Example 469
Related commands 471
GetDomainHeader 471
Description 471
Constraints 472
Input parameters 472
Returned parameters and values 472
Notes 473
Example 473
Related commands 474
GetDomainInfo 474
Description 474
Constraints 475
Input parameters 475
Returned parameters and values 475
Notes 478
Example 478
- xxxiii -
Related commands 481
GetDomainNameID 482
Description 482
Constraints 482
Input parameters 483
Returned parameters and values 483
Notes 484
Example 484
Related commands 485
GetDomains 485
Description 485
Constraints 485
Input parameters 486
Returned parameters and values 487
Notes 488
Example 488
Related commands 490
GetDomainServices 490
Description 490
Constraints 491
Input parameters 491
Returned parameters and values 492
Notes 492
Example 493
Related commands 494
GetDomainSLDTLD 494
Description 494
Constraints 495
Input parameters 495
- xxxiv -
Returned parameters and values 495
Notes 496
Example 496
Related commands 497
GetDomainSRVHosts 497
Description 497
Constraints 497
Input parameters 498
Returned parameters and values 498
Notes 499
Example 499
Related commands 500
GetDomainStatus 501
Description 501
Constraints 501
Input parameters 501
Returned parameters and values 502
Notes 502
Example 503
Related commands 504
GetDomainSubServices 504
Description 504
Constraints 505
Input parameters 505
Returned parameters and values 505
Notes 506
Example 506
Related commands 507
GetDotNameForwarding 507
- xxxv -
Description 507
Constraints 508
Input parameters 508
Returned parameters and values 508
Notes 509
Example 509
Related commands 510
GetExpiredDomains 510
Description 510
Constraints 511
Input parameters 511
Returned parameters and values 511
Notes Notes 512
Example 512
Related commands 514
GetExtAttributes 515
Description 515
Constraints 515
Input parameters 515
Returned parameters and values 516
Notes 517
Example 517
Related commands 519
GetExtendInfo 519
Description 519
Constraints 520
Input parameters 520
Returned parameters and values 521
Notes 522
- xxxvi -
Example 523
Related commands 525
GetFilePermissions 525
Description 525
Constraints 526
Input parameters 526
Returned parameters and values 527
Notes 527
Example 527
Related commands 528
GetForwarding 528
Description 528
Constraints 529
Input parameters 529
Returned parameters and values 530
Notes 531
Example 531
Related commands 532
GetGlobalChangeStatus 532
Description 532
Constraints 533
Input parameters 533
Returned parameters and values 534
Notes 534
Example 534
Related commands 537
GetGlobalChangeStatusDetail 537
Description 537
Constraints 538
- xxxvii -
Input parameters 538
Returned parameters and values 539
Notes 539
Example 539
Related commands 541
GetHomeDomainList 541
Description 541
Constraints 542
Input parameters 542
Returned parameters and values 542
Notes 543
Example 543
Related commands 544
GetHostAccount 545
Description 545
Constraints 545
Input parameters 545
Returned parameters and values 546
Notes 547
Example 548
Related commands 549
GetHostAccounts 549
Description 549
Constraints 549
Input parameters 550
Returned parameters and values 550
Notes 551
Example 551
Related commands 553
- xxxviii -
GetHostHeader 553
Description 553
Constraints 553
Input parameters 554
Returned parameters and values 554
Notes 555
Example 555
Related commands 556
GetHosts 556
Description 556
Constraints 557
Input parameters 557
Returned parameters and values 558
Notes 558
Example 558
Related commands 560
GetIDNCodes 560
Description 560
Constraints 561
Input parameters 561
Returned parameters and values 561
Notes 562
Example 562
Related commands 563
GetIPResolver 563
Description 563
Constraints 564
Input parameters 564
Returned parameters and values 564
- xxxix -
Notes 565
Example 565
Related commands 567
GetMailHosts 567
Description 567
Constraints 567
Input parameters 567
Returned parameters and values 568
Notes 569
Example 569
Related commands 571
GetMetaTag 571
Description 571
Constraints 571
Input parameters 572
Returned parameters and values 572
Notes 573
Example 573
Related commands 574
GetNameSuggestions 574
Description 574
Constraints 574
Input parameters 575
Returned parameters and values 576
Notes 577
Example 577
Related commands 578
GetNews 578
Description 578
- xl -
Constraints 579
Input parameters 579
Returned parameters and values 579
Notes 580
Example 580
Related commands 581
GetOrderDetail 581
Description 581
Constraints 582
Input parameters 582
Returned parameters and values 583
Notes 584
Example 584
Related commands 586
GetOrderList 586
Description 586
Constraints 587
Input parameters 587
Returned parameters and values 587
Notes 588
Example 589
Related commands 590
GetPasswordBit 591
Description 591
Constraints 591
Input parameters 591
Returned parameters and values 592
Notes 592
Example 592
- xli -
Related commands 593
GetPOP3 594
Description 594
Constraints 594
Input parameters 594
Returned parameters and values 595
Notes 596
Example 596
Related commands 600
GetPOPExpirations 600
Description 600
Constraints 601
Input parameters 601
Returned parameters and values 602
Notes 602
Example 602
Related commands 604
GetPOPForwarding 604
Description 604
Constraints 604
Input parameters 605
Returned parameters and values 605
Notes 606
Example 606
Related commands 607
GetProductNews 607
Description 607
Constraints 608
Input parameters 608
- xlii -
Returned parameters and values 608
Notes 609
Example 609
Related commands 610
GetProductSelectionList 610
Description 610
Constraints 610
Input parameters 610
Returned parameters and values 611
Notes 611
Example 612
Related commands 613
GetRegHosts 614
Description 614
Constraints 614
Input parameters 614
Returned parameters and values 615
Notes 615
Example 616
Related commands 618
GetRegistrationStatus 618
Description 618
Constraints 619
Input parameters 619
Returned parameters and values 619
Notes 620
Example 620
Related commands 621
GetRegLock 621
- xliii -
Description 621
Constraints 622
Input parameters 622
Returned parameters and values 622
Notes 623
Example 623
Related commands 624
GetRenew 625
Description 625
Constraints 625
Input parameters 625
Returned parameters and values 626
Notes 627
Example 627
Related commands 628
GetReport 628
Description 628
Constraints 629
Input parameters 629
Returned parameters and values 630
Notes 631
Example 631
Related commands 632
GetResellerHostPricing 632
Description 632
Constraints 633
Input parameters 633
Returned parameters and values 634
Notes 635
- xliv -
Example 635
Related commands 636
GetResellerInfo 637
Description 637
Constraints 637
Input parameters 638
Returned parameters and values 638
Notes 639
Example 639
Related commands 640
GetServiceContact 641
Description 641
Constraints 641
Input parameters 641
Returned parameters and values 642
Notes 643
Example 643
Related commands 644
GetSPFHosts 644
Description 644
Constraints 645
Input parameters 645
Returned parameters and values 645
Notes 646
Example 646
Related commands 648
GetStorageUsage 648
Description 648
Constraints 648
- xlv -
Input parameters 648
Returned parameters and values 649
Notes 649
Example 650
Related commands 650
GetSubAccountDetails 651
Description 651
Constraints 651
Input parameters 652
Returned parameters and values 652
Notes 655
Example 655
Related commands 658
GetSubAccountPassword 659
Description 659
Constraints 659
Input parameters 659
Returned parameters and values 660
Notes 660
Example 660
Related commands 661
GetSubAccounts 662
Description 662
Constraints 662
Input parameters 662
Returned parameters and values 663
Notes 663
Example 664
Related commands 665
- xlvi -
GetSubaccountsDetailList 666
Description 666
Constraints 666
Input parameters 667
Returned parameters and values 667
Notes 668
Example 668
Related commands 670
GetTLDDetails 670
Description 670
Constraints 671
Input parameters 671
Returned parameters and values 671
Notes 674
Example 674
GetTLDList 677
Description 677
Constraints 677
Input parameters 677
Returned parameters and values 678
Notes 678
Example 679
Related commands 680
GetTransHistory 680
Description 680
Constraints 681
Input parameters 681
Returned parameters and values 682
Notes 684
- xlvii -
Example 684
Related commands 686
GetWebHostingAll 686
Description 686
Constraints 687
Input parameters 687
Returned parameters and values 688
Notes 688
Example 688
Related commands 690
GetWhoisContact 690
Description 690
Constraints 691
Input parameters 691
Returned parameters and values 691
Notes 692
Example 693
Related commands 695
GetWPPSInfo 696
Description 696
Constraints 696
Input parameters 696
Returned parameters and values 697
Notes 698
Example 698
Related commands 700
GM_CancelSubscription 700
Description 700
Constraints 701
- xlviii -
Input parameters 701
Returned parameters and values 702
Notes 702
Example 703
Related commands 704
GM_CheckDomain 704
Description 704
Constraints 705
Input parameters 705
Returned parameters and values 706
Notes 706
Example 707
Related commands 708
GM_GetCancelReasons 708
Description 708
Constraints 709
Input parameters 709
Returned parameters and values 710
Notes 710
Example 710
Related commands 712
GM_GetControlPanelLoginURL 712
Description 712
Constraints 713
Input parameters 713
Returned parameters and values 713
Notes 714
Example 714
Related commands 716
- xlix -
GM_GetRedirectScript 716
Description 716
Constraints 717
Input parameters 717
Returned parameters and values 717
Notes 718
Example 718
Related commands 719
GM_GetStatuses 720
Description 720
Constraints 720
Input parameters 720
Returned parameters and values 721
Notes 721
Example 721
Related commands 723
GM_GetSubscriptionDetails 723
Description 723
Constraints 724
Input parameters 724
Returned parameters and values 724
Notes 725
Example 725
Related commands 727
GM_GetSubscriptions 727
Description 727
Constraints 727
Input parameters 728
Returned parameters and values 729
-l-
Notes 729
Example 729
Related commands 732
GM_ReactivateSubscription 732
Description 732
Constraints 733
Input parameters 733
Returned parameters and values 733
Notes 734
Example 734
Related commands 735
GM_RenewSubscription 736
Description 736
Constraints 736
Input parameters 737
Returned parameters and values 737
Notes 737
Example 738
Related commands 739
GM_UpdateBillingCycle 740
Description 740
Constraints 740
Input parameters 740
Returned parameters and values 741
Notes 741
Example 742
Related commands 743
GM_UpdateSubscriptionDetails 743
Description 743
- li -
Constraints 744
Input parameters 744
Returned parameters and values 745
Notes 745
Example 746
Related commands 747
HostPackageDefine 747
Description 747
Constraints 748
Input parameters 748
Returned parameters and values 750
Notes 750
Example 750
Related commands 751
HostPackageDelete 752
Description 752
Constraints 752
Input parameters 752
Returned parameters and values 753
Notes 753
Example 754
Related commands 754
HostPackageModify 755
Description 755
Constraints 755
Input parameters 756
Returned parameters and values 757
Notes 757
Example 758
- lii -
Related commands 758
HostPackageView 759
Description 759
Constraints 760
Input parameters 760
Returned parameters and values 761
Notes 762
Example 762
Related commands 764
HostParkingPage 764
Description 764
Constraints 765
Input parameters 765
Returned parameters and values 765
Notes 766
Example 766
Related commands 767
InsertNewOrder 767
Description 767
Constraints 768
Input parameters 768
Returned parameters and values 769
Notes 769
Example 770
Related commands 771
IsFolderEnabled 771
Description 771
Constraints 771
Input parameters 772
- liii -
Returned parameters and values 772
Notes 773
Example 773
Related commands 774
ListDomainHeaders 774
Description 774
Constraints 774
Input parameters 775
Returned parameters and values 775
Notes 776
Example 776
Related commands 777
ListHostHeaders 778
Description 778
Constraints 778
Input parameters 778
Returned parameters and values 779
Notes 780
Example 780
Related commands 781
ListWebFiles 781
Description 781
Constraints 782
Input parameters 782
Returned parameters and values 783
Notes 783
Example 783
Related commands 785
MetaBaseGetValue 785
- liv -
Description 785
Constraints 786
Input parameters 786
Returned parameters and values 787
Notes 787
Example 787
Related commands 788
MetaBaseSetValue 789
Description 789
Constraints 789
Input parameters 789
Returned parameters and values 790
Notes 791
Example 791
Related commands 792
ModifyDomainHeader 792
Description 792
Constraints 793
Input parameters 793
Returned parameters and values 794
Notes 794
Example 794
Related commands 795
ModifyHostHeader 796
Description 796
Constraints 796
Input parameters 796
Returned parameters and values 797
Notes 797
- lv -
Example 798
Related commands 799
ModifyNS 799
Description 799
Constraints 800
Input parameters 800
Returned parameters and values 801
Notes 801
Example 801
Related commands 802
ModifyNSHosting 802
Description 802
Constraints 803
Input parameters 803
Returned parameters and values 804
Notes 804
Example 804
Related commands 805
ModifyPOP3 805
Description 805
Constraints 806
Input parameters 806
Returned parameters and values 807
Notes 807
Example 808
Related commands 809
MySQL_GetDBInfo 809
Description 809
Constraints 809
- lvi -
Input parameters 810
Returned parameters and values 810
Notes 811
Example 811
Related commands 812
NameSpinner 813
Description 813
Constraints 813
Input parameters 813
Returned parameters and values 815
Notes 816
Example 816
Related commands 817
NM_CancelOrder 818
Description 818
Constraints 818
Input parameters 818
Returned parameters and values 819
Notes 819
Example 819
Related commands 821
NM_ExtendOrder 821
Description 821
Constraints 822
Input parameters 822
Returned parameters and values 822
Notes 823
Example 823
Related commands 824
- lvii -
NM_GetPremiumDomainSettings 825
Description 825
Constraints 825
Input parameters 825
Returned parameters and values 826
Notes 826
Example 827
Related commands 828
NM_GetSearchCategories 828
Description 828
Constraints 829
Input parameters 829
Returned parameters and values 830
Notes 830
Example 830
Related commands 832
NM_ProcessOrder 832
Description 832
Constraints 833
Input parameters 833
Returned parameters and values 834
Notes 834
Example 834
Related commands 836
NM_Search 836
Description 836
Constraints 836
Input parameters 836
Returned parameters and values 839
- lviii -
Notes 839
Example 839
Related commands 841
NM_SetPremiumDomainSettings 842
Description 842
Constraints 843
Input parameters 843
Returned parameters and values 843
Notes 844
Example 844
Related commands 845
ParseDomain 845
Description 845
Constraints 846
Input parameters 846
Returned parameters and values 846
Notes 847
Example 847
Related commands 848
PE_GetCustomerPricing 848
Description 848
Constraints 849
Input parameters 849
Returned parameters and values 849
Notes 852
Example 852
Related commands 853
PE_GetDomainPricing 854
Description 854
- lix -
Constraints 854
Input parameters 854
Returned parameters and values 855
Notes 855
Example 855
Related commands 857
PE_GetEapPricing 857
Description 857
Constraints 858
Input parameters 858
Returned parameters and values 859
Notes 859
Example 859
Related commands 862
PE_GetPOPPrice 862
Description 862
Constraints 863
Input parameters 863
Returned parameters and values 863
Notes 864
Example 864
Related commands 865
PE_GetPremiumPricing 865
Description 865
Constraints 866
Input parameters 866
Returned parameters and values 867
Notes 867
Example 867
- lx -
Related commands 868
PE_GetProductPrice 869
Description 869
Constraints 869
Input parameters 869
Returned parameters and values 872
Notes 873
Example 873
Related commands 874
PE_GetResellerPrice 874
Description 874
Constraints 875
Input parameters 875
Returned parameters and values 877
Notes 878
Example 878
Related commands 879
PE_GetRetailPrice 879
Description 879
Constraints 880
Input parameters 880
Returned parameters and values 883
Notes 883
Example 884
Related commands 884
PE_GetRetailPricing 885
Description 885
Constraints 885
Input parameters 886
- lxi -
Returned parameters and values 886
Notes 888
Example 888
Related commands 890
PE_GetRocketPrice 890
Description 890
Constraints 891
Input parameters 891
Returned parameters and values 892
Notes 892
Example 892
Related commands 893
PE_GetTLDID 894
Description 894
Constraints 894
Input parameters 894
Returned parameters and values 895
Notes 895
Example 895
Related commands 896
PE_SetPricing 896
Description 896
Constraints 897
Input parameters 897
Returned parameters and values 901
Notes 901
Example 902
Related commands 902
Portal_GetAwardedDomains 903
- lxii -
Description 903
Constraints 903
Input parameters 904
Returned parameters and values 904
Notes 905
Example 906
Related commands 907
Portal_GetDomainInfo 907
Description 907
Constraints 908
Input parameters 908
Returned parameters and values 908
Notes 909
Example 910
Portal_GetToken 914
Description 914
Constraints 915
Input parameters 915
Returned parameters and values 915
Notes 916
Example 916
Portal_UpdateAwardedDomains 917
Description 917
Constraints 917
Input parameters 917
Returned parameters and values 918
Notes 918
Example 918
Related commands 919
- lxiii -
PP_CancelSubscription 920
Description 920
Constraints 920
Input parameters 920
Returned parameters and values 921
Notes 922
Example 922
Related commands 923
PP_CheckUpgrade 924
Description 924
Constraints 925
Input parameters 925
Returned parameters and values 926
Notes 926
Example 926
Related commands 928
PP_GetCancelReasons 928
Description 928
Constraints 929
Input parameters 929
Returned parameters and values 929
Notes 930
Example 930
Related commands 931
PP_GetControlPanelLoginURL 932
Description 932
Constraints 933
Input parameters 933
Returned parameters and values 933
- lxiv -
Notes 934
Example 934
Related commands 935
PP_GetStatuses 936
Description 936
Constraints 936
Input parameters 936
Returned parameters and values 937
Notes 937
Example 937
Related commands 939
PP_GetSubscriptionDetails 939
Description 939
Constraints 940
Input parameters 940
Returned parameters and values 940
Notes 942
Example 942
Related commands 944
PP_GetSubscriptions 944
Description 944
Constraints 945
Input parameters 945
Returned parameters and values 946
Notes 947
Example 947
Related commands 949
PP_ReactivateSubscription 949
Description 949
- lxv -
Constraints 950
Input parameters 950
Returned parameters and values 950
Notes 951
Example 951
Related commands 952
PP_UpdateSubscriptionDetails 953
Description 953
Constraints 953
Input parameters 954
Returned parameters and values 955
Notes 955
Example 955
Related commands 957
PP_ValidatePassword 957
Description 957
Constraints 958
Input parameters 958
Returned parameters and values 958
Notes 959
Example 959
Related commands 961
Preconfigure 961
Description 961
Constraints 962
Input parameters 962
Returned parameters and values 966
Notes 967
Example 967
- lxvi -
Related commands 968
Purchase 969
Description 969
Constraints 970
Input parameters 971
Returned parameters and values 978
Notes 979
Example 980
Related commands 981
PurchaseHosting 981
Description 981
Constraints 982
Input parameters 982
Returned parameters and values 984
Notes 984
Example 985
Related commands 986
PurchasePOPBundle 986
Description 986
Constraints 987
Input parameters 987
Returned parameters and values 987
Notes 988
Example 988
Related commands 989
PurchasePreview 990
Description 990
Constraints 990
Input parameters 990
- lxvii -
Returned parameters and values 991
Notes 992
Example 992
Related commands 993
PurchaseServices 993
Description 993
Constraints 994
Input parameters 994
Input parameters for ID Protect 995
Input parameters for SSL Certificates 997
Input parameters for TRUSTe Privacy Policy 998
Input parameters for VeriSign Trust Seal 1000
Input parameters for GeoTrust Anti-Malware 1001
Input parameters for SiteLock 1001
Input parameters for RichContent 1002
Input parameters for Business Listing 1003
Input parameters for POP Email 1005
Input parameters for Web Site Creator 1006
Input parameters for Web hosting 1007
Input parameters for DNS hosting 1008
Input parameters for goMobi 1011
Returned parameters and values 1011
Notes 1012
Example 1013
Related commands 1014
PushDomain 1014
Description 1014
Constraints 1015
Input parameters 1015
- lxviii -
Returned parameters and values 1016
Notes 1016
Example 1016
Related commands 1017
Queue_DomainPurchase 1017
Description 1017
Constraints 1018
Input parameters 1018
Returned parameters and values 1020
Notes 1021
Example 1021
Related commands 1022
Queue_GetDomains 1023
Description 1023
Constraints 1023
Input parameters 1023
Returned parameters and values 1024
Notes 1025
Example 1026
Related commands 1028
Queue_GetExtAttributes 1028
Description 1028
Constraints 1028
Input parameters 1028
Returned parameters and values 1029
Notes 1029
Example 1030
Related commands 1031
Queue_GetInfo 1031
- lxix -
Description 1031
Constraints 1032
Input parameters 1032
Returned parameters and values 1033
Notes 1033
Example 1034
Related commands 1035
Queue_GetOrderDetail 1035
Description 1035
Constraints 1036
Input parameters 1036
Returned parameters and values 1037
Notes 1037
Example 1038
Related commands 1039
Queue_GetOrders 1039
Description 1039
Constraints 1040
Input parameters 1040
Returned parameters and values 1040
Notes 1041
Example 1041
Related commands 1042
RAA_GetInfo 1043
Description 1043
Constraints 1043
Input parameters 1043
Returned parameters and values 1044
Notes 1045
- lxx -
Example 1045
Related commands 1049
RAA_ResendNotifications 1050
Description 1050
Constraints 1050
Input parameters 1050
Returned parameters and values 1051
Notes 1051
Example 1052
Related commands 1053
RC_CancelSubscription 1053
Description 1053
Constraints 1054
Input parameters 1054
Returned parameters and values 1055
Notes 1055
Example 1055
Related commands 1056
RC_FreeTrialCheck 1056
Description 1056
Constraints 1057
Input parameters 1057
Returned parameters and values 1058
Notes 1058
Example 1058
Related commands 1059
RC_GetLoginToken 1060
Description 1060
Constraints 1060
- lxxi -
Input parameters 1060
Returned parameters and values 1061
Notes 1061
Example 1062
Related commands 1063
RC_GetSubscriptionDetails 1063
Description 1063
Constraints 1063
Input parameters 1064
Returned parameters and values 1064
Notes 1065
Example 1065
Related commands 1067
RC_GetSubscriptions 1067
Description 1067
Constraints 1067
Input parameters 1068
Returned parameters and values 1068
Notes 1069
Example 1069
Related commands 1071
RC_RebillSubscription 1071
Description 1071
Constraints 1072
Input parameters 1072
Returned parameters and values 1073
Notes 1073
Example 1073
Related commands 1074
- lxxii -
RC_ResetPassword 1075
Description 1075
Constraints 1075
Input parameters 1075
Returned parameters and values 1076
Notes 1076
Example 1076
Related commands 1077
RC_SetBillingCycle 1078
Description 1078
Constraints 1078
Input parameters 1078
Returned parameters and values 1079
Notes 1080
Example 1080
Related commands 1081
RC_SetPassword 1081
Description 1081
Constraints 1082
Input parameters 1082
Returned parameters and values 1083
Notes 1083
Example 1083
Related commands 1084
RC_SetSubscriptionDomain 1085
Description 1085
Constraints 1085
Input parameters 1085
Returned parameters and values 1086
- lxxiii -
Notes 1086
Example 1087
Related commands 1088
RC_SetSubscriptionName 1088
Description 1088
Constraints 1088
Input parameters 1089
Returned parameters and values 1089
Notes 1090
Example 1090
Related commands 1091
RefillAccount 1091
Description 1091
Constraints 1092
Input parameters 1092
Returned parameters and values 1094
Notes 1095
Example 1095
Related commands 1096
RegisterNameServer 1097
Description 1097
Constraints 1097
Input parameters 1097
Returned parameters and values 1098
Notes 1098
Example 1099
Related commands 1100
RemoveTLD 1100
Description 1100
- lxxiv -
Constraints 1101
Input parameters 1101
Returned parameters and values 1101
Notes 1102
Example 1102
Related commands 1103
RemoveUnsyncedDomains 1103
Description 1103
Constraints 1104
Input parameters 1104
Returned parameters and values 1104
Notes 1105
Example 1105
Related commands 1106
RenewPOPBundle 1106
Description 1106
Constraints 1107
Input parameters 1107
Returned parameters and values 1109
Notes 1109
Example 1110
Related commands 1111
RenewServices 1111
Description 1111
Constraints 1111
Input parameters 1112
Returned parameters and values 1114
Notes 1114
Example 1114
- lxxv -
Related commands 1115
RPT_GetReport 1115
Description 1115
Constraints 1116
Input parameters 1116
Returned parameters and values 1118
Notes 1119
Example 1120
Related commands 1122
SendAccountEmail 1123
Description 1123
Constraints 1123
Input parameters 1123
Returned parameters and values 1124
Notes 1124
Example 1124
Related commands 1125
ServiceSelect 1125
Description 1125
Constraints 1126
Input parameters 1126
Returned parameters and values 1128
Notes 1128
Example 1128
Related commands 1129
SetCatchAll 1130
Description 1130
Constraints 1130
Input parameters 1130
- lxxvi -
Returned parameters and values 1131
Notes 1131
Example 1132
Related commands 1132
SetCustomerDefinedData 1133
Description 1133
Constraints 1133
Input parameters 1133
Returned parameters and values 1134
Notes 1135
Example 1135
Related commands 1136
SetDNSHost 1136
Description 1136
Constraints 1136
Input parameters 1137
Returned parameters and values 1137
Notes 1138
Example 1138
Related commands 1139
SetDomainSRVHosts 1139
Description 1139
Constraints 1140
Input parameters 1140
Returned parameters and values 1141
Notes 1142
Example 1142
Related commands 1143
SetDomainSubServices 1143
- lxxvii -
Description 1143
Constraints 1143
Input parameters 1144
Returned parameters and values 1144
Notes 1145
Example 1145
Related commands 1146
SetDotNameForwarding 1146
Description 1146
Constraints 1147
Input parameters 1147
Returned parameters and values 1148
Notes 1148
Example 1148
Related commands 1149
SetFilePermissions 1149
Description 1149
Constraints 1150
Input parameters 1150
Returned parameters and values 1151
Notes 1151
Example 1151
Related commands 1152
SetHosts 1153
Description 1153
Constraints 1153
Input parameters 1153
Returned parameters and values 1155
Notes 1155
- lxxviii -
Example 1156
Related commands 1157
SetIPResolver 1157
Description 1157
Constraints 1157
Input parameters 1158
Returned parameters and values 1158
Notes 1159
Example 1159
Related commands 1160
SetPakRenew 1160
Description 1160
Constraints 1161
Input parameters 1161
Returned parameters and values 1162
Notes 1162
Example 1162
Related commands 1163
SetPassword 1164
Description 1164
Constraints 1164
Input parameters 1164
Returned parameters and values 1165
Notes 1165
Example 1166
Related commands 1166
SetPOPForwarding 1167
Description 1167
Constraints 1167
- lxxix -
Input parameters 1168
Returned parameters and values 1169
Notes 1169
Example 1169
Related commands 1170
SetRegLock 1170
Description 1170
Constraints 1171
Input parameters 1171
Returned parameters and values 1172
Notes 1172
Example 1172
Related commands 1173
SetRenew 1174
Description 1174
Constraints 1174
Input parameters 1175
Returned parameters and values 1176
Notes 1176
Example 1176
Related commands 1177
SetResellerServicesPricing 1178
Description 1178
Constraints 1178
Input parameters 1178
Returned parameters and values 1179
Notes 1180
Example 1180
Related commands 1181
- lxxx -
SetResellerTLDPricing 1181
Description 1181
Constraints 1182
Input parameters 1182
Returned parameters and values 1183
Notes 1184
Example 1184
Related commands 1185
SetSPFHosts 1186
Description 1186
Constraints 1186
Input parameters 1186
Returned parameters and values 1187
Notes 1188
Example 1188
Related commands 1189
SetUpPOP3User 1189
Description 1189
Constraints 1189
Input parameters 1190
Returned parameters and values 1191
Notes 1191
Example 1192
Related commands 1193
SL_AutoRenew 1193
Description 1193
Constraints 1193
Input parameters 1194
Returned parameters and values 1194
- lxxxi -
Notes 1195
Example 1195
Related commands 1196
SL_Configure 1196
Description 1196
Constraints 1196
Input parameters 1197
Returned parameters and values 1197
Notes 1198
Example 1198
Related commands 1199
SL_GetAccountDetail 1199
Description 1199
Constraints 1200
Input parameters 1200
Returned parameters and values 1200
Notes 1201
Example 1201
Related commands 1202
SL_GetAccounts 1202
Description 1202
Constraints 1203
Input parameters 1203
Returned parameters and values 1205
Notes 1205
Example 1205
Related commands 1207
StatusDomain 1207
Description 1207
- lxxxii -
Constraints 1208
Input parameters 1208
Returned parameters and values 1208
Notes 1209
Example 1209
Related commands 1210
SubAccountDomains 1211
Description 1211
Constraints 1211
Input parameters 1211
Returned parameters and values 1212
Notes 1213
Example 1213
Related commands 1215
SynchAuthInfo 1215
Description 1215
Constraints 1216
Input parameters 1216
Returned parameters and values 1217
Notes 1217
Example 1217
Related commands 1218
TEL_AddCTHUser 1218
Description 1218
Constraints 1219
Input parameters 1219
Returned parameters and values 1220
Notes 1220
Example 1220
- lxxxiii -
Related commands 1221
TEL_GetCTHUserInfo 1222
Description 1222
Constraints 1222
Input parameters 1222
Returned parameters and values 1223
Notes 1223
Example 1224
Related commands 1225
TEL_GetCTHUserList 1225
Description 1225
Constraints 1225
Input parameters 1226
Returned parameters and values 1226
Notes 1227
Example 1227
Related commands 1228
TEL_GetPrivacy 1228
Description 1228
Constraints 1229
Input parameters 1229
Returned parameters and values 1230
Notes 1230
Example 1230
Related commands 1231
TEL_IsCTHUser 1231
Description 1231
Constraints 1232
Input parameters 1232
- lxxxiv -
Returned parameters and values 1233
Notes 1233
Example 1233
Related commands 1234
EL_UpdateCTHUser 1235
Description 1235
Constraints 1235
Input parameters 1235
Returned parameters and values 1236
Notes 1236
Example 1237
Related commands 1238
TEL_UpdatePrivacy 1238
Description 1238
Constraints 1238
Input parameters 1239
Returned parameters and values 1239
Notes 1240
Example 1240
Related commands 1241
TLD_AddWatchlist 1241
Description 1241
Constraints 1243
Input parameters 1243
Returned parameters and values 1244
Notes 1245
Example 1245
Related commands 1249
TLD_DeleteWatchlist 1249
- lxxxv -
Description 1249
Constraints 1251
Input parameters 1251
Returned parameters and values 1251
Notes 1252
Example 1252
Related commands 1254
TLD_GetTLD 1254
Description 1254
Constraints 1255
Input parameters 1255
Returned parameters and values 1256
Notes 1256
Example 1257
Related commands 1258
TLD_GetWatchlist 1258
Description 1258
Constraints 1259
Input parameters 1259
Returned parameters and values 1261
Notes 1262
Example 1262
Related commands 1265
TLD_GetWatchlistTlds 1265
Description 1265
Constraints 1266
Input parameters 1266
Returned parameters and values 1267
Notes 1268
- lxxxvi -
Example 1268
Related commands 1271
TLD_Overview 1271
Description 1271
Constraints 1271
Input parameters 1271
Returned parameters and values 1272
Notes 1273
Example 1273
Related commands 1275
TM_Check 1276
Description 1276
Constraints 1276
Input parameters 1276
Returned parameters and values 1277
Notes 1277
Example 1277
Related commands 1278
TM_GetNotice 1279
Description 1279
Constraints 1279
Input parameters 1279
Returned parameters and values 1280
Notes 1281
Example 1281
Related commands 1283
TM_UpdateCart 1283
Description 1283
Constraints 1284
- lxxxvii -
Input parameters 1284
Returned parameters and values 1284
Notes 1285
Example 1285
Related commands 1286
TP_CancelOrder 1286
Description 1286
Constraints 1287
Input parameters 1287
Returned parameters and values 1288
Notes 1288
Example 1288
Related commands 1289
TP_CreateOrder 1290
Description 1290
Constraints 1291
Input parameters 1291
Returned parameters and values 1295
Notes 1296
Example 1296
Related commands 1298
TP_GetDetailsByDomain 1298
Description 1298
Constraints 1299
Input parameters 1299
Returned parameters and values 1299
Notes 1300
Example 1301
Related commands 1308
- lxxxviii -
TP_GetOrder 1309
Description 1309
Constraints 1309
Input parameters 1309
Returned parameters and values 1310
Notes 1311
Example 1312
Related commands 1313
TP_GetOrderDetail 1314
Description 1314
Constraints 1314
Returned parameters and values 1315
Notes 1315
Example 1317
Related commands 1318
TP_GetOrderReview 1319
Description 1319
Constraints 1319
Input parameters 1319
Returned parameters and values 1320
Notes 1321
Example 1321
Related commands 1323
TP_GetOrdersByDomain 1323
Description 1323
Constraints 1323
Input parameters 1324
Returned parameters and values 1324
Notes 1325
- lxxxix -
Example 1325
Related commands 1326
TP_GetOrderStatuses 1326
Description 1326
Constraints 1327
Input parameters 1327
Returned parameters and values 1328
Notes 1328
Example 1328
Related commands 1330
TP_GetTLDInfo 1330
Description 1330
Constraints 1330
Input parameters 1331
Returned parameters and values 1331
Notes 1332
Example 1332
Related commands 1350
TP_ResendEmail 1350
Description 1350
Constraints 1351
Input parameters 1351
Returned parameters and values 1352
Notes 1352
Example 1352
Related commands 1353
TP_ResubmitLocked 1353
Description 1353
Constraints 1354
- xc -
Input parameters 1354
Returned parameters and values 1355
Notes 1355
Example 1355
Related commands 1356
TP_SubmitOrder 1356
Description 1356
Constraints 1357
Input parameters 1357
Returned parameters and values 1359
Notes 1359
Example 1359
Related commands 1360
TP_UpdateOrderDetail 1361
Description 1361
Constraints 1361
Input parameters 1362
Returned parameters and values 1364
Notes 1365
Example 1365
Related commands 1368
TS_AutoRenew 1368
Description 1368
Constraints 1369
Input parameters 1369
Returned parameters and values 1369
Notes 1370
Example 1370
Related commands 1371
- xci -
TS_Configure 1371
Description 1371
Constraints 1372
Input parameters 1372
Returned parameters and values 1376
Notes 1376
Example 1377
Related commands 1378
TS_GetAccountDetail 1378
Description 1378
Constraints 1379
Input parameters 1379
Returned parameters and values 1379
Notes 1381
Example 1381
Related commands 1383
TS_GetAccounts 1383
Description 1383
Constraints 1384
Input parameters 1384
Returned parameters and values 1385
Notes 1386
Example 1386
Related commands 1391
UpdateAccountInfo 1391
Description 1391
Constraints 1392
Input parameters 1392
Returned parameters and values 1395
- xcii -
Notes 1395
Example 1396
Related commands 1398
UpdateAccountPricing 1398
Description 1398
Constraints 1399
Input parameters 1399
Returned parameters and values 1404
Notes 1404
Example 1404
Related commands 1405
UpdateCart 1406
Description 1406
Constraints 1406
Input parameters 1406
Returned parameters and values 1407
Notes 1408
Example 1408
Related commands 1408
UpdateCusPreferences 1409
Description 1409
Constraints 1409
Input parameters 1410
Returned parameters and values 1413
Notes 1413
Example 1413
Related commands 1414
UpdateDomainFolder 1415
Description 1415
- xciii -
Constraints 1416
Input parameters 1416
Returned parameters and values 1420
Notes 1425
Example 1425
Related commands 1427
UpdateExpiredDomains 1427
Description 1427
Constraints 1428
Input parameters 1428
Returned parameters and values 1429
Notes 1429
Example 1429
Related commands 1430
UpdateHostPackagePricing 1430
Description 1430
Constraints 1431
Input parameters 1431
Returned parameters and values 1432
Notes 1433
Example 1434
Related commands 1436
UpdateMetaTag 1436
Description 1436
Constraints 1437
Input parameters 1437
Returned parameters and values 1438
Notes 1438
Example 1439
- xciv -
Related commands 1440
UpdateNameServer 1440
Description 1440
Constraints 1440
Input parameters 1441
Returned parameters and values 1441
Notes 1442
Example 1442
Related commands 1443
UpdateNotificationAmount 1443
Description 1443
Constraints 1443
Input parameters 1444
Returned parameters and values 1444
Notes 1444
Example 1445
Related commands 1446
UpdatePushList 1446
Description 1446
Constraints 1446
Input parameters 1446
Returned parameters and values 1447
Notes 1447
Example 1447
Related commands 1449
UpdateRenewalSettings 1449
Description 1449
Constraints 1449
Input parameters 1450
- xcv -
Returned parameters and values 1451
Notes 1451
Example 1451
Related commands 1452
ValidatePassword 1452
Description 1452
Constraints 1453
Input parameters 1453
Returned parameters and values 1453
Notes 1454
Example 1454
Related commands 1455
WBLConfigure 1455
Description 1455
Constraints 1456
Input parameters 1456
Returned parameters and values 1459
Notes 1460
Example 1460
Related commands 1461
WBLGetCategories 1461
Description 1461
Constraints 1462
Input parameters 1462
Returned parameters and values 1463
Notes 1463
Example 1463
Related commands 1467
WBLGetFields 1467
- xcvi -
Description 1467
Constraints 1467
Input parameters 1468
Returned parameters and values 1468
Notes 1468
Example 1469
Related commands 1470
WBLGetStatus 1470
Description 1470
Constraints 1471
Input parameters 1471
Returned parameters and values 1471
Notes 1472
Example 1472
Related commands 1474
WebHostCreateDirectory 1474
Description 1474
Constraints 1475
Input parameters 1475
Returned parameters and values 1475
Notes 1476
Example 1476
Related commands 1477
WebHostCreatePOPBox 1477
Description 1477
Constraints 1478
Input parameters 1478
Returned parameters and values 1479
Notes 1479
- xcvii -
Example 1479
Related commands 1480
WebHostDeletePOPBox 1481
Description 1481
Constraints 1481
Input parameters 1481
Returned parameters and values 1482
Notes 1482
Example 1483
Related commands 1483
WebHostGetCartItem 1484
Description 1484
Constraints 1484
Input parameters 1484
Returned parameters and values 1485
Notes 1485
Example 1486
Related commands 1487
WebHostGetOverageOptions 1487
Description 1487
Constraints 1488
Input parameters 1488
Returned parameters and values 1488
Notes 1489
Example 1489
Related commands 1490
WebHostGetOverages 1491
Description 1491
Constraints 1491
- xcviii -
Input parameters 1491
Returned parameters and values 1492
Notes 1493
Example 1493
Related commands 1494
WebHostGetPackageComponentList 1495
Description 1495
Constraints 1495
Input parameters 1495
Returned parameters and values 1496
Notes 1497
Example 1497
Related commands 1499
WebHostGetPackageMinimums 1499
Description 1499
Constraints 1500
Input parameters 1500
Returned parameters and values 1501
Notes 1501
Example 1501
Related commands 1502
WebHostGetPackages 1503
Description 1503
Constraints 1503
Input parameters 1504
Returned parameters and values 1504
Notes 1505
Example 1505
Related commands 1507
- xcix -
WebHostGetPOPBoxes 1507
Description 1507
Constraints 1508
Input parameters 1508
Returned parameters and values 1509
Notes 1509
Example 1509
Related commands 1511
WebHostGetResellerPackages 1511
Description 1511
Constraints 1512
Input parameters 1512
Returned parameters and values 1512
Notes 1513
Example 1513
Related commands 1515
WebHostGetStats 1516
Description 1516
Constraints 1516
Input parameters 1516
Returned parameters and values 1517
Notes 1518
Example 1518
Related commands 1519
WebHostHelpInfo 1519
Description 1519
Constraints 1520
Input parameters 1520
Returned parameters and values 1520
-c-
Notes 1522
Example 1522
Related commands 1524
WebHostSetCustomPackage 1524
Description 1524
Constraints 1524
Input parameters 1525
Returned parameters and values 1526
Notes 1528
Example 1528
Related commands 1529
WebHostSetOverageOptions 1529
Description 1529
Constraints 1530
Input parameters 1530
Returned parameters and values 1531
Notes 1531
Example 1531
Related commands 1532
WebHostUpdatePassword 1533
Description 1533
Constraints 1533
Input parameters 1534
Returned parameters and values 1534
Notes 1535
Example 1535
Related commands 1536
WebHostUpdatePOPPassword 1536
Description 1536
- ci -
Constraints 1537
Input parameters 1537
Returned parameters and values 1538
Notes 1538
Example 1538
Related commands 1539
WSC_GetAccountInfo 1540
Description 1540
Constraints 1540
Input parameters 1540
Returned parameters and values 1541
Notes 1543
Example 1543
Related commands 1546
WSC_GetAllPackages 1546
Description 1546
Constraints 1547
Input parameters 1547
Returned parameters and values 1547
Notes 1549
Example 1550
Related commands 1552
WSC_GetPricing 1552
Description 1552
Constraints 1553
Input parameters 1553
Returned parameters and values 1554
Notes 1555
Example 1555
- cii -
Related commands 1556
WSC_Update_Ops 1556
Description 1556
Constraints 1557
Input parameters 1558
Returned parameters and values 1559
Notes 1559
Example 1559
Related commands 1560
XXX_GetMemberId 1561
Description 1561
Constraints 1561
Input parameters 1561
Returned parameters and values 1562
Notes 1562
Example 1562
Related commands 1564
XXX_RemoveMemberId 1564
Description 1564
Constraints 1565
Input parameters 1565
Returned parameters and values 1566
Notes 1566
Example 1566
Related commands 1568
XXX_SetMemberId 1568
Description 1568
Constraints 1569
Input parameters 1569
- ciii -
Returned parameters and values 1570
Notes 1570
Example 1570
Related commands 1572
- civ -
Overview
This reference covers the entire application programming interface (API) that lets you
user eNom services to buy and sell Internet domains.
In this volume:
l Quick Start Guides
The Quick Start Guides introduce a single topic and walk you through enough of the API com-
mands to get you started.
l Domains and TLDs
This section comprises documents that describe the requirements for buying and selling
domains within specific TLDs.
l API Command Categories
The Big List; here you get into the details of every command implemented in the eNom API.
The main page breaks down the catalog into list by function. Beneath the main page is the full
catalog of API commands.
-1-
Domains and TLDs
In this section:
-2-
Domains and TLDs
Contents
-3-
Domains and TLDs
Reduce the list of TLDs you offer. Or, by removing all TLDs on
RemoveTLD
your list, return to all the TLDs we support.
Retrieve a list of the TLDs you have authorized. You can use
GetTLDList
this command to populate dropdown menus for TLDs.
https://resellertest.enom.com/interface.asp?
command=AuthorizeTLD&uid=resellid&pw=resellpw
-4-
Domains and TLDs
&domainlist=com,net,org,biz,info&responsetype=xml
RemoveTLD
https://resellertest.enom.com/interface.asp?
command=RemoveTLD&uid=resellid&pw=resellpw
&domainlist=com,net,org,biz,info&responsetype=xml
GetTLDList
https://resellertest.enom.com/interface.asp?
command=GetTLDList&uid=resellid&pw=resellpw
&responsetype=xml
-5-
Domains and TLDs
4. Set your customer preferences as you wish. We strongly recommend that you
select the Do not allow names to be transferred check box to reduce the likelihood
of hijacking. Many of our resellers also select the Renew the registration check box
so that their customers do not inadvertently lose their domain names by allowing
them to expire. Many of our resellers also have host record settingseither our
defaults or their own custom settingsthat they use for all domain names.
5. Click save changes.
6. On the default tab, click default dns.
7. Specify your desired default name servers and click save changes.
Checking domain names simply means sending a query to the Registry to see if a spe-
cified domain name is available. You must always do this before registering a domain
name.
Optionally, you can also display variations of the domain name, so that if the original
name is not available, your customer is instantly presented with alternatives that are sim-
ilar.
Checking involves the following API commands:
https://resellertest.enom.com/interface.asp?
command=check&uid=resellid&pw=resellpw
&sld=example&tld=com&responsetype=xml
NameSpinner
-6-
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=NameSpinner&UID=resellid&pw=resellpw
&SLD=example&TLD=com&UseHyphens=true&UseNumbers=true
&MaxResults=10&ResponseType=XML
same query string you submit for the domain registration. We charge per trans-
action, and offer the most robust fraud screening in the industry as part of our ser-
vice.
This guide focuses on the purchase method that most of our resellers use: real-time pur-
chases. The process uses two to five API commands:
Purchase a domain name in real time. If you use our credit card
Purchase
processing, submit credit card information with this command.
-7-
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=GetExtAttributes&uid=resellid
&pw=resellpw&tld=ca&responsetype=xml
Purchase (simple)
https://resellertest.enom.com/interface.asp?
command=Purchase&uid=resellid&pw=resellpw
&sld=resellerdocs104&tld=com&ResponseType=XML
https://resellertest.enom.com/interface.asp?
Command=Purchase&UID=resellid&PW=resellpw
&SLD=resellerdocs103&TLD=ca&cira_legal_type=cco
&cira_whois_display=full&cira_language=en
&cira_agreement_value=Y&cira_agreement_version=2.0
&UseDNS=default&NumYears=1&RegistrantFirstName=John
&Re-
gis-
trantLastName=Doe&RegistrantOrganizationName=Hudson+Bay+Company
&RegistrantAddress1=1150+Douglas+St&RegistrantCity=Victoria
&RegistrantCountry=CA&RegistrantPostalCode=V8W+2C8
&RegistrantStateProvince=BC&RegistrantStateProvinceChoice=P
&RegistrantEmailAddress=john.doe@resellerdocs.com
&RegistrantPhone=%2B1.2503851311&ResponseType=XML
GetDomainStatus
https://resellertest.enom.com/interface.asp?
command=GetDomainStatus&uid=resellid&pw=resellpw
&sld=resellerdocs103&tld=ca&orderid=157930813
&ordertype=purchase&responsetype=xml
-8-
Domains and TLDs
them toward the products and services that best fit their needs.
Basic listing of an accounts domain names and their statuses involves the following
commands:
https://resellertest.enom.com/interface.asp?
command=GetDomains&UID=resellid&PW=resellpw
&ResponseType=XML
GetExpiredDomains
https://resellertest.enom.com/interface.asp?
command=GetExpiredDomains&uid=resellid&pw=resellpw
&responsetype=xml
-9-
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=GetDomainInfo&UID=resellid&PW=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
GetExpiredDomains
https://resellertest.enom.com/interface.asp?
command=GetExpiredDomains&uid=resellid&pw=resellpw
&responsetype=xml
- 10 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=Purchase&UID=resellid&PW=resellpw
&sld=resellerdocs106&tld=com&usedns=default
&RegistrantFirstName=John&RegistrantLastName=Registrant
&RegistrantAddress1=111%20Registrant%20St.
&RegistrantCity=Registranttown&RegistrantStateProvince=wa
&RegistrantPostalCode=98003&RegistrantCountry=US
&RegistrantEmailAddress=john.doe@resellerdocs.com
&RegistrantPhone=%2B1.5555555555&AdminFirstName=AdminyJohn
&AdminLastName=AdminyDoe&AdminAddress1=111%20Admin%20St.
&AdminCity=Admintown&AdminCountry=US
&AdminEmailAddress=john.Admin@resellerdocs.com
&Ad-
minPhone=%2B1.5555555555&AuxBillingFirstName=AuxBillingJohn
&AuxBillingLastName-
e=AuxBillingDoe&AuxBillingAddress1=111%20AuxBilling%20St.
&AuxBillingCity=AuxBillingtown&AuxBillingCountry=US
&AuxBillingEmailAddress=john.AuxBilling@resellerdocs.com
&AuxBillingPhone=%2B1.5555555555&ResponseType=XML
Contacts (for a domain name that does not require extended attributes)
https://resellertest.enom.com/interface.asp?
command=Contacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&RegistrantFirstName=John
&RegistrantLastName=Smith&RegistrantPhone=%2B1.5555555555
&RegistrantAddress1=100%20Main%20St.
&RegistrantCity=Townsville&RegistrantCountry=US
&RegistrantEmailAddress=john@resellerdocs.com
&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=Contacts&uid=resellid&pw=resellpw
&sld=resellerdocs78&tld=ca&RegistrantFirstName=John
&RegistrantLastName=Doe&RegistrantAddress1=1400+W+Pender+St
&RegistrantCity=Vancouver&RegistrantCountry=CA
&RegistrantPostalCode=V6C+1G8&RegistrantStateProvince=BC
&RegistrantStateProvinceChoice=P
- 11 -
Domains and TLDs
&RegistrantEmailAddress=john.doe@resellerdocs.com
&RegistrantPhone=%2B1.6046382525&cira_legal_type=cct
&cira_whois_display=private&cira_language=en
&cira_agreement_value=Y&cira_agreement_version=2.0
&ResponseType=XML
GetContacts
https://resellertest.enom.com/interface.asp?
command=GetContacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
GetWhoisContact
https://resellertest.enom.com/interface.asp?
command=GetWhoisContact&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
Set name servers for a domain name, both in our system and at
the Registry. If you dont specify universal settings through our
ModifyNS Web site or the UpdateCusPreferences command, ModifyNS
is a basic configuration command for each new domain you
register.
- 12 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=UpDateCusPreferences&uid=resellid&pw=resellpw
&usedns=0&dns1=ns1.name-services.com&dns2=ns2.name-ser-
vices.com
&responsetype=xml
GetCusPreferences
https://resellertest.enom.com/interface.asp?
command=GetCusPreferences&uid=resellid
&pw=resellpw&responsetype=xml
ModifyNS
https://resellertest.enom.com/interface.asp?
command=ModifyNS&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&usedns=default&responsetype=xml
GetDNS
https://resellertest.enom.com/interface.asp?
command=GetDNS&UID=resellid&PW=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
- 13 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=UpdateCusPreferences&uid=resellid
&pw=resellpw&useparentdefault=0&RecordType=A,A,A
&address=85.92.87.178,85.92.87.179,85.92.87.180
&hostname=@,*,www&ResponseType=XML
GetCusPreferences
https://resellertest.enom.com/interface.asp?
command=GetCusPreferences&uid=resellid&pw=resellpw
&responsetype=xml
SetHosts
https://resellertest.enom.com/interface.asp?
command=SetHosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&HostName1=@&RecordType1=A
&Address1=66.150.5.189&HostName2=photos
&RecordType2=CNAME&Address2=photos.msn.com.
&HostName3=yahoo&RecordType3=URL&Address3=204.71.200.72
&HostName4-
4=msn&RecordType4=FRAME&Address4=http://www.msn.com
&responsetype=xml
GetHosts
- 14 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=GetHosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=UpdateCusPreferences&-uid=resellid&pw=resellpw
&RegLock=on&ResponseType=XML
GetCusPreferences
https://resellertest.enom.com/interface.asp?
command=GetCusPreferences&uid=resellid&pw=resellpw
&responsetype=xml
SetRegLock
- 15 -
Domains and TLDs
https://resellertest.enom.com/Interface.asp?
command=SetRegLock&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&unlockregistrar=0
&responsetype=xml
GetRegLock
https://resellertest.enom.com/interface.asp?
command=GetRegLock&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
GetRenew Retrieve the current Auto Renew setting for a domain name.
- 16 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=UpdateCusPreferences&uid=resellid&pw=resellpw
&AutoRenew=on&ResponseType=XML
GetCusPreferences
https://resellertest.enom.com/interface.asp?
command=GetCusPreferences&uid=resellid
&pw=resellpw&responsetype=xml
SetRenew
https://resellertest.enom.com/interface.asp?
command=SetRenew&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&renewflag=0&responsetype=xml
GetRenew
https://resellertest.enom.com/interface.asp?
command=GetRenew&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
Extend
https://resellertest.enom.com/interface.asp?
command=Extend&UID=resellid&PW=resellpw
&sld=resellerdocs&tld=com&NumYears=1
&ResponseType=XML
- 17 -
Domains and TLDs
UpdateExpiredDomains
https://resellertest.enom.com/interface.asp?
command=UpdateExpiredDomains&uid=resellid
&pw=resellpw&DomainName=resellerdocs.com
&responsetype=xml
Extend_RGP
https://resellertest.enom.com/interface.asp?
command=Extend_RGP&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=xml
UpdateRenewalSettings
https://resellertest.enom.com/interface.asp?
command=UpdateRenewalSettings&uid=resellid
&pw=resellpw&RenewalSetting=1&RenewalBCC=1
&AcceptTerms=1&URL=www.resellerdocs.com&ResponseType=XML
- 18 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=PurchaseServices&uid=resellid&pw=resellpw
&Service=DNSHosting&sld=DomainNameToBeHosted
&tld=com&NumYears=1&responsetype=xml
GetDomains
https://resellertest.enom.com/interface.asp?
command=GetDomains&UID=resellid&PW=resellpw
&Display=10&Start=321&ResponseType=XML
GetDomainInfo
https://resellertest.enom.com/interface.asp?
command=GetDomainInfo&UID=resellid&PW=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
ExtendDomainDNS
https://resellertest.enom.com/interface.asp?
command=ExtenddomainDNS&uid=resellid&pw=resellpw
&sld=DomainNameToBeHosted&tld=com&numyears=1
&responsetype=xml
- 19 -
Domains and TLDs
Update information in a transfer order that has not yet been sub-
TP_UpdateOrderDetail
mitted.
https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder&uid=resellid&pw=resellpw
&orderType=AutoVerification&sld1=resellerdocs16
&tld1=com&AuthInfo1=11111&sld2=resellerdocs16
&tld2=net&AuthInfo2=22222&domaincount=2&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder&uid=resellid&pw=resellpw
&orderType=AutoVerification&sld1=resellerdocs17
&tld1=com&AuthInfo1=11111&sld2=resellerdocs17
&tld2=net&AuthInfo2=22222&domaincount=2&Preconfig=1
&responsetype=xml
TP_GetOrderDetail
https://resellertest.enom.com/interface.asp?
command=TP_GetOrderDetail&uid=resellid&pw=resellpw
&TransferOrderDetailID=77289251&responsetype=xml
- 20 -
Domains and TLDs
TP_UpdateOrderDetail
https://resellertest.enom.com/interface.asp?
command=TP_UpdateOrderDetail&uid=resellid&pw=resellpw
&TransferOrderDetailID=77289251&Lock=On&Renew=On
&RegistrantUseContact=none&TechUseContact=none
&AuxBillingUseContact=none&responsetype=xml
TP_SubmitOrder
https://resellertest.enom.com/interface.asp?
command=TP_SUBMITORDER&uid=resellid&pw=resellpw
&TransferOrderID=175586738&responsetype=xml
TP_GetOrderReview
https://resellertest.enom.com/interface.asp?
command=TP_GetOrderReview&uid=resellid&pw=resellpw
&TransferOrderID=175586738&OrderType=Transfer
&responsetype=xml
TP_GetOrdersByDomain
https://resellertest.enom.com/interface.asp?
command=TP_GetOrdersByDomain&uid=resellid
&pw=resellpw&sld=resellerdocs16&tld=com
&responsetype=xml
TP_GetOrder
https://resellertest.enom.com/interface.asp?
command=TP_GetOrder&uid=resellid&pw=resellpw
&TransferOrderID=175586738&responsetype=xml
TP_GetOrderStatuses
https://resellertest.enom.com/interface.asp?
command=TP_GetOrder-
Statuses&uid=resellid&pw=resellpw&responsetype=xml
- 21 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=getcontacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
Contacts
https://resellertest.enom.com/interface.asp?
command=contacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&RegistrantFirstName=John
- 22 -
Domains and TLDs
&Re-
gistrantLastName=Smith&Registrantaddress1=100%20Main%20St.
&RegistrantCity=Townsville&RegistrantCountry=US
&RegistrantEmailAddress=john@resellerdocs.com
&RegistrantPhone=%2B1.5555555555&responsetype=xml
SynchAuthInfo
https://resellertest.enom.com/interface.asp?
Command=SynchAuthInfo&UID=resellid&PW=resellpw
&SLD=resellerdocs&TLD=com&EmailEPP=True
&RunSynchAutoInfo=True&ResponseType=XML
GetRegLock
https://resellertest.enom.com/interface.asp?
command=getreglock&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
SetRegLock
https://resellertest.enom.com/Interface.asp?
command=setreglock&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&unlockregistrar=1
&responsetype=xml
Usage
Get the list of all available new TLDs in our system.
TLD_GetTLD
https://resellertest.enom.com/interface.asp?
command=TLD_GetTLD&UID=ResellID&PW=resellpw
- 23 -
Domains and TLDs
&ResponseType=XML
Get the list of all categories. The new TLDs are arranged in one or more categories.
TLD_GetCategory
https://resellertest.enom.com/interface.asp?
command=TLD_GetCategory&UID=ResellID&PW=resellpw
&ResponseType=XML
LIST
You can create LIST(s) for organizing or managing watchlist domain names. Each LIST
consists of a ListID, ListName and ListEmail.
Each account has a default LIST (ListID=0 ), containing domains to watch. Domains can
appear in multiple LISTS. The default LIST cannot be deleted and email address cannot
be changed.
Example:
- 24 -
Domains and TLDs
TLD_AddWatchlist
https://resellertest.enom.com/interface.asp?
command=TLD_AddWatchlist&UID=ResellID&PW=resellpw
&ResponseType=XML
&domainlist=blogging.ninja,*.ninja,blogging.*
&ListID=16&ListName=&ListEmail=
https://resellertest.enom.com/interface.asp?
command=tld_getwatchlist&uid=ResellID&pw=resellpw
&responsetype=xml&pagingpagesize=2
&tld=xn--nqv7f&ListID=0&Action=
https://resellertest.enom.com/interface.asp?
command=TLD_DeleteWatchlist&UID=ResellID&PW=resellpw
&ResponseType=XML&Action=DeleteListItem
- 25 -
Domains and TLDs
&WatchlistIDList=73995&ListID=23
Agreement Page
Retrieve the up-to-date Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID&PW=resellpw
&ResponseType=XML&Page=watchlist
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
- 26 -
Domains and TLDs
&Command=Queue_GetInfo&Category=Novelty
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetExtAttributes&QIDList=53
https://resellertest.enom.com?
UID=resellid&PW=resellpw&ResponseType=xml
&Command=Queue_DomainPurchase&Amount=50
&ItemList=qname%3dsunrise%7csld%3dmydomain
%7ctld%3dninja%7csigned_mark_data%3d
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetDomains&DisplayDomains=true
- 27 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetOrders
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetOrderDetail&OrderID=157896057
Agreement Page
Retrieve the up-to-date Queue Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID
&PW=resellpw&ResponseType=XML&Page=queue
NOTE: The changes are backward compatible, so will not cause errors on your Web
site. However, they benefit your customers by providing greater flexibility in meeting
.ASIA eligibility requirements.
- 28 -
Domains and TLDs
Registrations of .ASIA domains must now satisfy at least one of the following eligibility
requirements:
l The Registrant contact information must include the same extended attributes as
currently, or
l The Administrative contact address must have a postal address within the DotAsia
Community.
The purpose of this document is to provide you an overview of the affected API com-
mands, and a list of countries and country codes that satisfy the DotAsia Community eli-
gibility criteria.
- 29 -
Domains and TLDs
.ASIA-approved countries
The following table lists countries approved by the .ASIA registry.
If the domain name registration or contact update does not include preconfiguration with
extended attributes for the Registrant, the Administrative contact must have a mailing
address in one of the following countries:
af Afghanistan
am Armenia
aq Antarctica
au Australia
az Azerbaijan
bd Bangladesh
bh Bahrain
bn Brunei Darussalam
bt Bhutan
cc Cocos (Keeling)
ck Cook Islands
cn China
cx Christmas Island
cy Cyprus
fj Fiji
fm Micronesia, Federated
ge Georgia
hk Hong Kong
hm Heard
id Indonesia
il Israel
- 30 -
Domains and TLDs
iq Iraq
jo Jordan
jp Japan
kg Kyrgyzstan
kh Cambodia
ki Kiribati
kr Korea, Republic of
kw Kuwait
kz Kazakhstan
lb Lebanon
lk Sri Lanka
mh Marshall Islands
mm Myanmar
mn Mongolia
mo Macao
mv Maldives
my Malaysia
nf Norfolk Island
np Nepal
nr Nauru
nu Niue
nz New Zealand
om Oman
ph Philippines
pk Pakistan
- 31 -
Domains and TLDs
pw Palau
qa Qatar
sa Saudi Arabia
sb Solomon Islands
sg Singapore
th Thailand
tj Tajikistan
tk Tokelau
tl Timor-Leste
tm Turkmenistan
to Tonga
tr Turkey
tv Tuvalu
tw Taiwan
uz Uzbekistan
vn Viet Nam
vu Vanuatu
ws Samoa
ye Yemen
- 32 -
Domains and TLDs
TLD Settings
.PE
.ES
.com.AU .com.PE
.com.ES
.net.AU .net.PE
.nom.ES
.org.AU .nom.PE
.org.ES
.org.PE
Min Registration 2 yrs 1 yr 1 yr
https://resellertest.enom.com/interface.asp?
command=GetExtAttributes&uid=ResellID
&pw=resellpw&responsetype=xml&tld=es
Step 2 - Purchase
Purchase domain(s) in our system.
Real-time
Purchase
https://resellertest.enom.com/interface.asp?
Command=Purchase&UID=ResellID&PW=resellpw&SLD=domaintest
&TLD=es&es_registrantid=ES123456789&es_registrantidtype=0
&NumYears=1&EndUserIP=123.123.123.123&ResponseType=XML
- 33 -
Domains and TLDs
Shopping cart
AddToCart
https://resellertest.enom.com/interface.asp?
Com-
mand-
d=AddToCart&UID=ResellID&PW=resellpw&ProductType=Register
&SLD=domaintest&TLD=es&Quantity=1
&EndUserIP=123.123.123.123&ResponseType=XML
PreConfigure
https://resellertest.enom.com/interface.asp?
Command=PreConfigure&UID=ResellID&PW=resellpw
&load=2&autorenew=1&preconfigdns=default&usehostrecords=0
&listcount=1&cartitemid0=910168&updatelist=1
&optadministrative=UseBilling
&opttechnical=UseBilling&optcontactaux=UseBilling
&optcontactreg=1&es_registrantid=ES123456789
&es_registrantidtype=0&EndUserIP=123.123.123.123
&ResponseType=XML
InsertNewOrder
https://resellertest.enom.com/interface.asp?
Command=InsertNewOrder&UID=ResellID&PW=resellpw
&EndUserIP=123.123.123.123&ResponseType=XML
Agreement Pages
Retrieve the up-to-date Registration Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID&PW=resellpw
&ResponseType=XML&Page=au
- 34 -
Domains and TLDs
Audience
This document is intended for our API users who offer .ca domain names.
- 35 -
Domains and TLDs
For detailed information on each of these contact types, see Registrant legal types-defin-
itions and valid formats
- 36 -
Domains and TLDs
- 37 -
Domains and TLDs
The information in this document applies to API commands that use extended attributes
or registrant contact information. The primary commands affected:
l The Registrant name must be the full legal name of the corporation and must be fol-
lowed by the jurisdiction of incorporation (i.e. Canada, Ontario, NWT.), unless it
is obvious from the corporation's name. Canadian Internet Registration Authority
(Canada)
l For Charities - the NFP should be included in the organization name - if it is a not-
for-profit organization - you are also required to submit the registration number (i.e.
123456789 RR0001)
Examples of valid and invalid Registrant names for the legal type 'Corporation'
Valid Registrant name Invalid Registrant name
The Foundation of Rosa (NFP) Smiths
Canadian citizen
A Canadian citizen of the age of majority under the laws of the province or territory in
Canada in which he or she resides or last resided.
Registrant name format requirements
l The Registrant's name must be the full legal name of the Canadian Citizen who
will hold the domain name registration as the name would appear on a passport,
driver's license or other identification document issued by a government.
l The full legal name may be followed by a space and o/a xxxx where o/a stands
for Operating As and xxxx can be any alpha-numeric string designated by the
applicant and subject to applicable rules and length restrictions (e.g. John Doe o/a
Doe Consulting Group). The name may also be followed by a space and a degree
granted to the Registrant by a recognized degree granting institution or a recog-
nized professional designation which the Registrant has the right to use (i.e., PhD,
MD, and DDS.)
l Full legal names of individuals may only consist of alphabetic characters and the
special characters: single quote mark('), hyphen(-), period(.).
- 38 -
Domains and TLDs
Examples of valid and invalid Registrant names for the legal type 'Permanent resident of
Canada'
Valid Registrant name Invalid Registrant name
John Smith John
(blank)
Cool Gal
Domain Administrator
St-James Services
l The Registrant's name must be the full legal name of the Permanent Resident who
will hold the domain name registration as the name would appear on a driver's
license or other identification document issued by a government.
l The name may be followed by a space and o/a xxxx where o/a stands for Oper-
ating As and xxxx can be any alpha-numeric string designated by the applicant
and subject to applicable rules and length restrictions (e.g. John Doe o/a Doe Con-
sulting Group). The name may also be followed by a space and a degree granted
to the Registrant by a recognized degree granting institution or a recognized pro-
fessional designation which the Registrant has the right to use (i.e., PhD, MD, and
DDS.)
l Full legal names of individuals may only consist of alphabetic characters and the
special characters: single quote mark('), hyphen(-), period(.).
- 39 -
Domains and TLDs
Examples of valid and invalid Registrant names for the legal type 'Permanent resident of
Canada'
Valid Registrant name Invalid Registrant name
John Smith John
St-James Services
l The Registrant's name must be the complete official name of the entity that will
hold the domain name registration, without any abbreviations. (A common abbre-
viation may follow the official name in parentheses).
l If the Registrant is not a government, the Registrant's name must be followed by
the name of the jurisdiction (i.e. Canada, province, territory, municipality, etc) to
which the Registrant is related.
Examples of valid and invalid Registrant names for the legal type 'Government or gov-
ernment entity in Canada'
Valid Registrant name Invalid Registrant name
Government of Alberta Toronto Sales Are Us Inc.
City of Toronto
- 40 -
Domains and TLDs
or territory of Canada; or
2. A college, post-secondary school, vocational school, secondary school, pre-school
or other school or educational institution which is located in Canada and which is
recognized by the educational authorities of a province or territory of Canada or
licensed under or maintained by an Act of Parliament of Canada or of the legis-
lature of a province or territory of Canada
Registrant name format requirements
l The Registrant's name must be the complete official name of the institution that will
hold the domain name registration, without any abbreviations.
l A common abbreviation may follow the official name in parentheses.
l The Registrant name must be followed by the jurisdiction (e.g. name of province,
municipality) in which the institution is accredited if not obvious from the Regis-
trant's name.
Examples of valid and invalid Registrant name for the legal type 'Canadian educational
institution'
Valid Registrant name Invalid Registrant name
L' cole de la ville (Ottawa) Sandhill Secondary School
Joe Smith
- 41 -
Domains and TLDs
l The Registrant's name must be the complete name of the association that will hold
the domain name registration, without any abbreviations. (A common abbreviation
may follow the complete name in parentheses).
Examples of valid and invalid Registrant names for the legal type
'Canadian unincorporated association'
Valid Registrant name Invalid Registrant name
St-Alban's Reformed Church of Victoria ACDEN
Canadian hospital
A hospital which is located in Canada and which is licensed, authorized or approved to
operate as a hospital under an Act of the legislature of a province or territory of Canada.
Registrant name format requirements
l The Registrant's name must be the complete official name of the hospital that will
hold the domain name registration, without any abbreviations. (A common abbre-
viation may follow the complete name in parentheses.) The Registrant's name
must be followed by the jurisdiction (i.e. name of province) which accredited the
hospital if not obvious from the Registrant's name.
Examples of valid and invalid Registrant names for the legal type 'Canadian hospital'
Valid Registrant name Invalid Registrant name
Royal Victoria Hospital - Qubec The dog hospital
- 42 -
Domains and TLDs
SHUL
l The Registrant's name must be the registered name of the partnership that will
hold the domain name registration.
l The Registrant name must be followed by the jurisdiction of registration (i.e.,
Alberta) and the registration number.
Examples of valid and invalid Registrant names for the legal type
'Partnership registered in Canada'
Valid Registrant name Invalid Registrant name
John Doe, LLP (Ontario) Mybusiness Inc.
- 43 -
Domains and TLDs
NOTE: This legal type is only intended for Registrants which do not meet the require-
ments associated with any other legal type but which have a trade-mark registered in
Canada. (Trademarks subject of trade-mark applications and trade-marks registered in
other jurisdictions, such as the United States, do not qualify.) The domain name to be
registered must include the trademark. (i.e., If the trade-mark is AVEA this type of Regis-
trant can register avea.ca or aveaisus.ca but not xyz.ca)
l The Registrant's name must be the complete legal name of the trade-mark owner
(not the trademark agent) holding the domain name registration without any abbre-
viations. (A common abbreviation may follow the complete name in parentheses.)
l The applicant must also insert the Canadian registration number of the trade-mark
following the Registrant name.
Examples of valid and invalid Registrant names for the legal type
'Trade-mark registered in Canada by non-Canadian owner'
Valid Registrant name Invalid Registrant name
Arcuros SPA - TMA1762466 Arcuros SPA
l The Registrant's name must be the complete official name of the trade union that
will hold the domain name registration, without abbreviations. (A common abbre-
viation may follow the official name in parentheses.)
l The Registrant name must be followed by the jurisdiction in Canada which recog-
nizes it (if it is not obvious from the Registrant's name.)
Examples of valid and invalid Registrant names for the legal type 'Canadian trade union'
Valid Registrant name Invalid Registrant name
Confdration des syndicats nationaux (CSN) - Qubec ZZCEUL local 237
- 44 -
Domains and TLDs
l The Registrant's name must be the complete official name of the political party
holding the domain name registration, without abbreviations. (A common abbre-
viation may follow the official name in parentheses.)
l The Registrant name must also by followed by the jurisdiction in Canada in which
it is registered (if it is not obvious from the official name).
Examples of valid and invalid Registrant names for the legal type 'Canadian political
party'
Valid Registrant name Invalid Registrant name
Progressive Conservative Party of Canada (PC) John Doe
ACCULD Ontario
l The Registrant's name must be the complete legal name of the institution which
will hold the domain name registration without abbreviations. (A common abbre-
viation may follow the complete name in parentheses.)
- 45 -
Domains and TLDs
Examples of valid and invalid Registrant names for the legal type
'Canadian library, archive or museum'
Valid Registrant name Invalid Registrant name
Royal Ontario Museum John Doe
My site
Domain Administrator
l The Registrant's name must be the complete official name of the trust, without any
abbreviations. (A common abbreviation may follow the official name in par-
entheses.)
l The Registrant name must also indicate the total percentage of the trustees that
meet one or more of the following requirements: Canadian citizen, permanent res-
ident, Canadian corporation, legal representative.
- 46 -
Domains and TLDs
l The Registrant's name must be the full legal name of the Aboriginal Person apply-
ing for the Registration as it would appear on a driver's license or other iden-
tification document issued by government.
l The Registrant may enter its full legal name followed by a space and o/a xxxx
where o/a stands for Operating As and xxxx can be any alpha-numeric string
designated by the applicant and subject to applicable rules and length restrictions
(e.g. John Doe o/a Doe Consulting Group).
l The name may also be followed by a space and a degree granted to the Registrant
by a recognized degree granting institution or a recognized professional des-
ignation which the Registrant has the right to use (i.e., PhD, MD, and DDS.)
l Full legal names of individuals may only consist of alphabetic characters and the
special characters: single quote mark('), hyphen(-), period(.).
Examples of valid and invalid Registrant names for the legal type
'Aboriginal Peoples (individuals) indigenous to Canada'
Valid Registrant name Invalid Registrant name
John Smith John
(blank)
Domain Administrator
l The Registrant's name must be the complete official name of the indigenous
people a collectivity of Aboriginal Persons or, if there is no official name, the name
by which the collectivity is commonly known.
- 47 -
Domains and TLDs
Examples of valid and invalid Registrant names for the legal type
'Aboriginal Peoples (individuals) indigenous to Canada'
Valid Registrant name Invalid Registrant name
Carrier Sekani Tribal Council Acme Sales Inc.
John Jones
l The name of Registrant must be the Indian Band Name as registered with the
Department of Indian and Northern Affairs, Canada.
Examples of valid and invalid Registrant names for the legal type 'Indian Band recog-
nized by the Indian Act of Canada'
Valid Registrant name Invalid Registrant name
Lac la Ronge Indian Band Mohawk Motors
John Smith
- 48 -
Domains and TLDs
l The Registrant's name must be the full legal name of the Canadian Citizen or Per-
manent Resident of Canada who is being represented as it would appear on a
passport, driver's license or other government identification document. This must
be followed by the full legal name and capacity of at least one of the official rep-
resentatives.
l Full legal names of individuals may only consist of alphabetic characters and the
Examples of valid and invalid Registrant names for the legal type
'Legal representative of a Canadian citizen or permanent resident'
Valid Registrant name Invalid Registrant name
John Smith (Jayne Smith, executor) Sales Are Us Inc.
Arlenza SP
Shingle LLP
l The Registrant's name must be the complete official name of the entity holding the
domain name registration without any abbreviations. (A common abbreviation may
follow the complete name in parentheses.) The registration number of the official
mark must follow the Registrant Name.
- 49 -
Domains and TLDs
Examples of valid and invalid Registrant names for the legal type
'Official marks registered in Canada'
Valid Registrant name Invalid Registrant name
The United Nations Educational, Scientific and Cul-
John Doe Inc.
tural Organization (UNESCO) - 0970388
Arcuros SPA
l The Registrant's name must be that of Her Majesty the Queen or, after a suc-
cession, the name of her successor.
- 50 -
Domains and TLDs
l cooperative
l cooprix
l corp
l corp.
l corporation
l credit union
l federation de societes mutuelles d'assurance
l federation of mutual insurance associations
l fideicommis
l fiducie
l inc
l inc.
l incorporated
l incorporee
l limited
l limited liability company
l limited liability partnership
l limitee
l llc
l llp
l ltd
l ltd.
l lte
l lte.
l ltee
l ltee.
l mutual benefit association
l s.a.
l s.a.r.f.
l s.c.c.
l s.r.l.
l sarl
l savings union
l socit responsabilit limite
l societe commerciale canadienne
l societe d'entraide economique
l societe d'epargne
l societe de fiducie
l societe de secours mutuels
l societe mutuelle d'assurance
l societe par actions
l societe par actions a responsabilite limitee
l trust
l ulc
l ulc.
- 51 -
Domains and TLDs
band bc breakfast
- 52 -
Domains and TLDs
- 53 -
Domains and TLDs
mb mechanic mechanics
motors nb network
ns of office
rural sa sask.
- 54 -
Domains and TLDs
tm toronto treats
NOTE: Note: A Contact that is an individual cannot use invalid contact names for Admin-
istrative Contact and Technical Contact information
Authorization Information
The registration of domain names and other operations around the registered domain
name are carried out only if the registrar is authorized for the change. An authorization
password is usually associated with the domain. Information is returned in a response
only when:
l The querying Registrar is the current sponsoring Registrar, or
l The Registrar has supplied valid authorization information with the request
For example, CIRA regards any changes to the contact name information a critical
change and requires authorization information. In this case, the request must include the
- 55 -
Domains and TLDs
authorization information for the domain. The Registrar must provide valid contact IDs for
Registrant and administrative contact, and, if applicable, technical contacts. These con-
tacts must be sponsored by the Registrar.
In the case of a domain name transfer, The Registrar must have the authorization inform-
ation, (a password) from the Registrant before the domain name can be transferred.
Email Addresses
The following lists email valid format and values.
l Length is 6 - 320 characters
l Format: email@domain.tld
IP Addresses
The Registry supports both IPv4 and IPv6 address types. An IPv4 address is a 32-bit
identifier that consists of a set of four numbers, each in the range of 0 to 255, separated
by periods. For example, 64.230.164.58. An IPv6 address is a 128-bit identifier. IPv6
notation consists of eight groups of four hexadecimal digits, separated by colons. For
example, 2001:db8:0000:0000:0000:0000:0000:5b0f. CIRA supports entering IPV6 IP
addresses in standard shorthand notations such as:
l Removing the leading zeros in a group
l Replacing one or more consecutive groups that consist entirely of zero values with
two colons (::). This can only be done once in an address
Postal Codes
When the country code is CA, the postal code format is XNX NXN. Where X is a letter
and N is a number, the space separating the first three characters from the second three
characters, is optional.
- 56 -
Domains and TLDs
When the country code is US, the zip code format is NNNNN or NNNNN-NNNN. Where
N is a numeric character, the hyphen character is used to separate the first five char-
acters from the following four characters, if the 'zip plus four' format is used.
Country Code
Afghanistan AF
Aland Islands AX
Albania AL
Algeria DZ
American Samoa AS
Andorra AD
Angola AO
Anguilla AI
Antarctica AQ
Argentina AR
Armenia AM
- 57 -
Domains and TLDs
Country Code
Aruba AW
Ascension Island AC
Australia AU
Austria AT
Azerbaijan AZ
Bahamas BS
Bahrain BH
Bangladesh BD
Barbados BB
Belarus BY
Belgium BE
Belize BZ
Benin BJ
Bermuda BM
Bhutan BT
Bolivia BO
Botswana BW
Bouvet Island BV
Brazil BR
Brunei Darussalam BN
Bulgaria BG
Burkina Faso BF
Burundi BI
Cambodia KH
Cameroon CM
Canada CA
- 58 -
Domains and TLDs
Country Code
Cape Verde CV
Cayman Islands KY
Chad TD
Chile CL
China CN
Christmas Island CX
Colombia CO
Comoros KM
Congo CG
Cook Islands CK
Costa Rica CR
Croatia HR
Cuba CU
Cyprus CY
Czech Republic CZ
Denmark DK
Djibouti DJ
Dominica DM
Dominican Republic DO
Ecuador EC
Egypt EG
El Salvador SV
Equatorial Guinea GQ
Eritrea ER
- 59 -
Domains and TLDs
Country Code
Estonia EE
Ethiopia ET
Faroe Islands FO
Fiji FJ
Finland FI
France FR
French Guiana GF
French Polynesia PF
Gabon GA
Gambia GM
Georgia GE
Germany DE
Ghana GH
Gibraltar GI
Greece GR
Greenland GL
Grenada GD
Guadeloupe GP
Guam GU
Guatemala GT
Guernsey GG
Guinea GN
Guinea-Bissau GW
Guyana GY
Haiti HT
- 60 -
Domains and TLDs
Country Code
Heard & McDonald Islands HM
Honduras HN
Hong Kong HK
Hungary HU
Iceland IS
India IN
Indonesia ID
Iran IR
Iraq IQ
Ireland IE
Isle of Man IM
Israel IL
Italy IT
Jamaica JM
Japan JP
Jersey JE
Jordan JO
Kazakhstan KZ
Kenya KE
Kiribati KI
Kuwait KW
Kyrgyzstan KG
Latvia LV
- 61 -
Domains and TLDs
Country Code
Lebanon LB
Lesotho LS
Liberia LR
Liechtenstein LI
Lithuania LT
Luxembourg LU
Macao MO
Madagascar MG
Malawi MW
Malaysia MY
Maldives MV
Mali ML
Malta MT
Marshall Islands MH
Martinique MQ
Mauritania MR
Mauritius MU
Mayotte YT
Mexico MX
Moldova MD
Monaco MC
Mongolia MN
Montenegro ME
Montserrat MS
- 62 -
Domains and TLDs
Country Code
Morocco MA
Mozambique MZ
Myanmar MM
Namibia NA
Nauru NR
Nepal NP
Netherlands NL
Netherlands Antilles AN
New Caledonia NC
New Zealand NZ
Nicaragua NI
Niger NE
Nigeria NG
Niue NU
Norfolk Island NF
Norway NO
Oman OM
Pakistan PK
Palau PW
Panama PA
Paraguay PY
Peru PE
Philippines PH
Pitcairn Islands PN
- 63 -
Domains and TLDs
Country Code
Poland PL
Portugal PT
Puerto Rico PR
Qatar QA
Runion RE
Romania RO
Russia RU
Rwanda RW
Saint Barthelemy BL
Saint Helena SH
Saint Lucia LC
Saint Martin MF
Samoa WS
San Marino SM
Saudi Arabia SA
Senegal SN
Serbia RS
Seychelles SC
Sierra Leone SL
Singapore SG
Slovakia SK
Slovenia SI
Solomon Islands SB
Somalia SO
- 64 -
Domains and TLDs
Country Code
South Africa ZA
Spain ES
Sri Lanka LK
Sudan SD
Suriname SR
Swaziland SZ
Switzerland CH
Sweden SE
Taiwan TW
Tajikistan TJ
Tanzania TZ
Thailand TH
Timor-Leste TL
Togo TG
Tokelau TK
Tonga TO
Tunisia TN
Turkey TR
Turkmenistan TM
Tuvalu TV
Uganda UG
Ukraine UA
- 65 -
Domains and TLDs
Country Code
United Kingdom (Great Britain) GB
United States US
Uruguay UY
Uzbekistan UZ
Vanuatu VU
Venezuela VE
Vietnam VN
Western Sahara EH
Yemen YE
Zambia ZM
Zimbabwe ZW
British Columbia BC
Manitoba MB
New Brunswick NB
Northwest Territories NT
Nova Scotia NS
Nunavut NU
- 66 -
Domains and TLDs
Quebec QC
Saskatchewan SK
Yukon YK
Alaska AK
Alabama AL
American Samoa AS
Arizona AZ
Arkansas AR
California CA
Colorado CO
Connecticut CT
Delaware DE
District of Columbia DC
Florida FL
Georgia GA
Guam GU
- 67 -
Domains and TLDs
Idaho ID
Illinois IL
Indiana IN
Iowa IA
Kansas KS
Kentucky KY
Louisiana LA
Maine ME
Marshall Islands MH
Maryland MD
Massachusetts MA
Michigan MI
Minnesota MN
Mississippi MS
Missouri MO
Montana MT
Nebraska NE
Nevada NV
New Hampshire NH
New Jersey NJ
New Mexico NM
New York NY
North Carolina NC
North Dakota ND
Ohio OH
- 68 -
Domains and TLDs
Oregon OR
Palau PW
Pennsylvania PA
Puerto Rico PR
Rhode Island RI
South Carolina SC
South Dakota SD
Tennessee TN
Texas TX
Utah UT
Vermont VT
Virgin Islands VI
Virginia VA
Washington WA
West Virginia WV
Wisconsin WI
Wyoming WY
- 69 -
Domains and TLDs
TLD Settings
.PE
.ES
.com.AU .com.PE
.com.ES
.net.AU .net.PE
.nom.ES
.org.AU .nom.PE
.org.ES
.org.PE
Min Registration 2 yrs 1 yr 1 yr
https://resellertest.enom.com/interface.asp?
command=GetExtAttributes&uid=ResellID
&pw=resellpw&responsetype=xml&tld=es
Step 2 - Purchase
Purchase domain(s) in our system.
Real-time
Purchase
https://resellertest.enom.com/interface.asp?
Command=Purchase&UID=ResellID&PW=resellpw&SLD=domaintest
&TLD=es&es_registrantid=ES123456789&es_registrantidtype=0
&NumYears=1&EndUserIP=123.123.123.123&ResponseType=XML
- 70 -
Domains and TLDs
Shopping cart
AddToCart
https://resellertest.enom.com/interface.asp?
Com-
mand-
d=AddToCart&UID=ResellID&PW=resellpw&ProductType=Register
&SLD=domaintest&TLD=es&Quantity=1
&EndUserIP=123.123.123.123&ResponseType=XML
PreConfigure
https://resellertest.enom.com/interface.asp?
Command=PreConfigure&UID=ResellID&PW=resellpw
&load=2&autorenew=1&preconfigdns=default&usehostrecords=0
&listcount=1&cartitemid0=910168&updatelist=1
&optadministrative=UseBilling
&opttechnical=UseBilling&optcontactaux=UseBilling
&optcontactreg=1&es_registrantid=ES123456789
&es_registrantidtype=0&EndUserIP=123.123.123.123
&ResponseType=XML
InsertNewOrder
https://resellertest.enom.com/interface.asp?
Command=InsertNewOrder&UID=ResellID&PW=resellpw
&EndUserIP=123.123.123.123&ResponseType=XML
Agreement Pages
Retrieve the up-to-date Registration Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID&PW=resellpw
&ResponseType=XML&Page=au
- 71 -
Domains and TLDs
.EU Transfer
The .EU Registry (EURid) will be updating their transfer and trade system to bring it
more inline with general TLDs. This document outlines the key elements affecting the
eNom transfer and trade system.
Schedule
Production : November 21st, 2012
ResellerTest : November 1st, 2012
Changes
l Trade is no longer required for contact update
l Authorization Code is now required for transfer
SINGLE CALL
Use this method (preconfig=0) when all required information is ready and there is no
need to modify anything. The fully configured TP_CreateOrder command will CREATE
and SUBMIT the transfer request immediately.
TP_CreateOrder
https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder-
&uid=resellid&pw=resellpw&domaincount=1
&order-
type=Autoverification&responsetype=xml&sld1=TestDomain
&tld1=eu&authinfo1=123ABC&EU_WhoisPolicy=I Agree&-
preconfig=0
MULTIPLE CALLS
Use this method (preconfig=1) for websites with multiple sequential pages in the transfer
and/or trade process, such as those found in a step-by-step entry or wizard, or those with
a "save for later" feature.
TP_CreateOrder
- 72 -
Domains and TLDs
https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder-
&uid=resellid&pw=resellpw&domaincount=1
&order-
type=Autoverification&responsetype=xml&sld1=TestDomain
&tld1=eu&authinfo1=123ABC&EU_WhoisPolicy=I Agree&-
preconfig=1
TP_UpdateOrderDetail
https://resellertest.enom.com/interface.asp?
Command=TP_UpdateOrderDetail&uid=resellid&pw=resellpw
&responsetype=xml&transferorderid=175584569
&addroid=yes&contacttype=registrant
&firstname=FirstName&lastname=LastName
&organizationname=MyOrganization
&jobtitle=TitleOfMyJob&address1=Address1&city=CityOfAPI
&stateprovince=Whereever&stateprovincechoice=P&country=UK
&postalcode=123ABC&phone=+44.383838383
&emailaddress=myemail@domain.com&EU_WhoisPolicy=I Agree
TP_SubmitOrder
https://resellertest.enom.com/interface.asp?
Command=TP_SubmitOrder&uid=resellid&pw=resellpw
&responsetype=xml&transferorderid=175584569
- 73 -
Domains and TLDs
l Swedish Resident: Registrants who are resident of Sweden should provide a valid
l Personal Identification Number, if registrant is an individual.
registered in Sweden.
l VAT/Tax ID Number: If the registrant is a corporation, in addition to Cor-
Country
Personal/Organization
iis_orgno required required n/a n/a
ID Number
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=GetExtAttributes&TLD=NU
- 74 -
Domains and TLDs
Step 2 - Purchase
Purchase domain(s) in our system.
Real-time
Purchase
https://resellertest.enom.com/interface.asp?
Command=Purchase&EndUserIP=123.123.123.123
&ResponseType=XML&UID=ResellID&PW=resellpw
&SLD-
=domaintest&TL-
LD=nu&NumYears=2&RegistrantOrganizationName=Bank
&RegistrantJobTitle=Manager&RegistrantFirstName=John
&RegistrantLastName=Smith&RegistrantAddress1=1st Ave
&RegistrantCity=Stockholm&RegistrantPostalCode=104 65
&RegistrantStateProvince=Stockholm
&RegistrantStateProvinceChoice=P&RegistrantCountry=SE
&RegistrantPhone=+46.1234567890
&RegistrantEmailAddress=admin@mydomain.com
&iis_orgno=690720-2017&iis_vatno=SE999999999901
Shopping cart
AddToCart
https://resellertest.enom.com/interface.asp?
Command=AddToCart&UID=ResellID&PW=resellpw
&ProductType=Register&SLD=domaintest&TLD=nu
&Quantity=2&EndUserIP=123.123.123.123&ResponseType=XML
PreConfigure
https://resellertest.enom.com/interface.asp?
Command=PreConfigure&UID=ResellID&PW=resellpw
&load=2&autorenew=1&preconfigdns=default&usehostrecords=0
&listcount=1&cartitemid0=910168&updatelist=1
&optadministrative=UseBilling&opttechnical=UseBilling
&optcontactaux=UseBilling&optcontactreg=1&iis_orgno=690720-
- 75 -
Domains and TLDs
2017
&iis_vatno=SE999999999901&EndUserIP=123.123.123.123
&ResponseType=XML
InsertNewOrder
https://resellertest.enom.com/interface.asp?
Command=InsertNewOrder&UID=ResellID&PW=resellpw
&EndUserIP=123.123.123.123&ResponseType=XML
Agreement Pages
Retrieve the up-to-date Registration Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID&PW=resellpw
&ResponseType=XML&Page=nu
Related commands
l Contacts
l PreConfigure
l Purchase
- 76 -
Domains and TLDs
TLD Settings
.PE
.ES
.com.AU .com.PE
.com.ES
.net.AU .net.PE
.nom.ES
.org.AU .nom.PE
.org.ES
.org.PE
Min Registration 2 yrs 1 yr 1 yr
https://resellertest.enom.com/interface.asp?
command=GetExtAttributes&uid=ResellID
&pw=resellpw&responsetype=xml&tld=es
Step 2 - Purchase
Purchase domain(s) in our system.
Real-time
Purchase
https://resellertest.enom.com/interface.asp?
Command=Purchase&UID=ResellID&PW=resellpw&SLD=domaintest
&TLD=es&es_registrantid=ES123456789&es_registrantidtype=0
&NumYears=1&EndUserIP=123.123.123.123&ResponseType=XML
- 77 -
Domains and TLDs
Shopping cart
AddToCart
https://resellertest.enom.com/interface.asp?
Com-
mand-
d=AddToCart&UID=ResellID&PW=resellpw&ProductType=Register
&SLD=domaintest&TLD=es&Quantity=1
&EndUserIP=123.123.123.123&ResponseType=XML
PreConfigure
https://resellertest.enom.com/interface.asp?
Command=PreConfigure&UID=ResellID&PW=resellpw
&load=2&autorenew=1&preconfigdns=default&usehostrecords=0
&listcount=1&cartitemid0=910168&updatelist=1
&optadministrative=UseBilling
&opttechnical=UseBilling&optcontactaux=UseBilling
&optcontactreg=1&es_registrantid=ES123456789
&es_registrantidtype=0&EndUserIP=123.123.123.123
&ResponseType=XML
InsertNewOrder
https://resellertest.enom.com/interface.asp?
Command=InsertNewOrder&UID=ResellID&PW=resellpw
&EndUserIP=123.123.123.123&ResponseType=XML
Agreement Pages
Retrieve the up-to-date Registration Agreement.
GetAgreementPage
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&UID=ResellID&PW=resellpw
&ResponseType=XML&Page=au
- 78 -
Domains and TLDs
Definition
This document is designed to provide resellers with technical details about the changes
to the .UK name space. Nominet, the .UK Registry, has updated their Registry system to
support the ability for Resellers to register and renew .UK domain names for single or
multi-year terms.
Usage
Use this sample command to purchase a real-time domain registration (single or multi-
year terms).
Current Behavior
eNom's API requires all new .UK registrations and .UK renewals to be executed at a
two-year minimum.
New Behavior
lRegistrations: multi-year (1-10)
lRenewals: multi-year (1-10)
l Renewals availability: any time (no longer restricted to 6 months prior to expiration
date)
Required or Optional
This change is optional. Resellers do not have to update their systems for this change.
Our API will remain backwards compatible.
Dates
l ResellerTest Server : April 4th, 2012
l Live Server : May 1st, 2012
Real-Time Response
- 79 -
Domains and TLDs
Current Behavior
eNom's API currently operates in a non-real time manner for .UK. Our system centers on
a 1300 Response Code (RRPCode) for .UK registrations. Resellers send in their .UK
registration commands and expect to receive a 1300 Response Code. This code sig-
nifies that the registration is not real-time and thus the Reseller must "poll" the domain
and/or Order to confirm it has been processed by the Registry.
New Behavior
eNom will be eliminating the use of the 1300 Response Code for .UK registrations. We
will be updating our API to work in real-time with the .UK registry. Once we make this
change, our API will return a 200 Response Code (RRPCode). The 200 Response
Code indicates that the order was processed immediately. To be clear, we will no longer
return a 1300 Response Code for .UK after this change.
Required or Optional
This change is required. Once we go live with this change, any Resellers who have not
made this update will see failures in processing UK registrations. To ensure this does
not happen, we are giving Resellers a 60 Day Notice to accommodate this change.
Dates
l ResellerTest Server : April 4th, 2012
l Live Server : June 1st, 2012
Extended Attributes are required for all .UK domain name. Please use GetExtAttributes
command to get detailed information for the required parameters below.
Registered_For: legal type of registrant contact
UK_Legal_Type: company or person domain is registered for (this must be accurate and
CANNOT BE CHANGED)
UK_Reg_Opt_Out: hide registrant data in Nominet WHOIS
Query
- 80 -
Domains and TLDs
http://resellertest.enom.com/interface.asp?
UID=resellid&PW=resellpw&ResponseType=XML&Command=PURCHASE
&EndUserIP=123.123.123.123&UseDNS=default&NumYears=1
&Registered_For=MyName&UK_Legal_Type=IND&UK_Reg_Opt_Out=no
&TLD=co.uk&SLD=mydomain
Output
Old version:
New version:
- 81 -
Domains and TLDs
<interface-response>
<OrderID>157804547</OrderID>
<TotalCharged>50.99</TotalCharged>
<RegistrantPartyID>{39AAA8C0-D019-
4690-1199-FD632BC123AA}
</RegistrantPartyID>
<RRPCode>200</RRPCode>
<RRPText>Command completed
successfully - 157804547
</RRPText>
<Command>PURCHASE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+00.00
</TimeDifference>
<ExecTime>1.021</ExecTime>
<Done>true</Done>
<RequestDateTime>3/26/2012 2:10:31
PM</RequestDateTime>
</interface-response>
http://resellertest.enom.com/interface.asp?
Command=GetExtAttributes&UID=resellid&PW=resellerpw
- 82 -
Domains and TLDs
&ResponseType=XML&TLD=co.uk
Output
<interface-response>
<?xml version="1.0" ?>
<interface-response>
<Attributes>
<Attribute>
<ID>6</ID>
<Name>uk_legal_type</Name>
<Application>2</Application>
<UserDefined>False</UserDefined>
<Required>1</Required>
<Description>Legal type of registrant contact</Description>
<IsChild>0</IsChild>
+ <Options>
......... <cut> .........
</Attribute>
</Attributes>
<Command>GETEXTATTRIBUTES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+00.00</TimeDifference>
<ExecTime>0.641</ExecTime>
<Done>true</Done>
<RequestDateTime>3/26/2012 2:35:43 PM</RequestDateTime>
</interface-response>
.xxx
This document is designed to provide resellers with technical details about the pro-
cesses for registering .XXX domain names.
- 83 -
Domains and TLDs
Purchase
Definition
Purchase a domain name in real time.
Base parameters
* Required:
sld: second level domain name
tld: top level domain name
* Optional: xxx_memberid: membership authorization token provided by ICM Registry. If
you do not have it yet, leave this blank and the ICM Registry will send an email to the
registrant contact email address with enrollment instructions. The domain will not
resolve until a valid token is submitted, but the domain can be registered. The domain
can be updated after registration with the token and will then resolve.
NOTE: If the registrant email address is already recognized by the registry as enrolled
in the sponsored community, the registry will not send another email to the registrant con-
tact. The registrant must get their token from www.icmregistry.com if they do not know it.
MemberID must be valid. Otherwise registry will reject the domain registration with
Contact error as follow:
<RRPCode>545</RRPCode>
<RRPText>Object does not exist; Failed Finding: Contact
(IXXKCQ8Q2WEE;membership)</RRPText>
<Command>PURCHASE</Command>
xxx_resolving: allowed values are 0 and 1(default). Setting this value to 0 will set the
domain to not resolving after successful registration. ICM Registry will not send a com-
munity membership enrollment email to registrant email address if it is set to 0.
Query
https://resellertest.enom.com/interface.asp?
command=PURCHASE&uid=resellid&pw=resellpw&responsetype=XML
&SLD=mydomain&TLD=xxx&NumYears=1&xxx_mem-
berid=IXSEFK023FFPZVA
&xxx_resolving=1
Output
- 84 -
Domains and TLDs
<interface-response>
<OrderID>157778008</OrderID>
<TotalCharged>80</TotalCharged>
<RegistrantPartyID>{39AE68C0-D019-4690-9999-FD632BC1AFAA}
</RegistrantPartyID>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully -
157778008</RRPText>
<Command>PURCHASE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>3.828</ExecTime>
<Done>true</Done>
<RequestDateTime>11/11/2011 9:31:49 AM</RequestDateTime>
</interface-response>
Preconfigure
Definition
Supply optional and required parameters at time of registration pertaining to the domain
name.
Base parameters (optional):
xxx_memberid: membership authorization token provided by ICM Registry. If you do not
have it yet, leave this blank and the ICM Registry will send an email to the registrant con-
tact email address with enrollment instructions. The domain will not resolve until a valid
token is submitted, but the domain can be registered. The domain can be updated after
registration with the token and will then resolve.
NOTE: If the registrant email address is already recognized by the registry as enrolled
in the sponsored community, the registry will not send another email to the registrant con-
tact. The registrant must get their token from www.icmregistry.com if they do not know it.
- 85 -
Domains and TLDs
xxx_resolving: allowed values are 0 and 1(default). Setting this value to 0 will set the
domain to not resolving after successful registration. ICM Registry will not send Com-
munity Membership email to registrant email address if it set to 0.
Query
https://resellertest.enom.com/interface.asp?
Command=PRECONFIGURE&opttechnical= UseBilling&uid=resellid
&pw=resellpw&responsetype=xml&load=2&preconfigdns=default
&listcount=1&optadministrative=UseBilling
&optcontactaux=UseBilling&optcontactreg=1
&cartitemid0=885655&xxx_memberid=IXSEFK023FFPZVA
&xxx_resolving=1
Output
<interface-response>
<PreConfigBillingInfo>
<BillingOrganizationName>A Team</BillingOrganizationName>
<BillingJobTitle>Tester</BillingJobTitle>
<BillingFirstName>First</BillingFirstName>
<BillingLastName>Last</BillingLastName>
<BillingAddress1>5808 Lake Washington Blvd.</BillingAd-
dress1>
<BillingAddress2 />
<BillingCity>Kirkland</BillingCity>
<BillingStateProvince>WA</BillingStateProvince>
<BillingStateProvinceChoice>S</BillingStateProvinceChoice>
<BillingPostalCode>98033</BillingPostalCode>
<BillingCountry>US</BillingCountry>
<BillingPhone>+1.42500000000</BillingPhone>
<BillingFax />
<BillingE-
mailAddress>someone@domain.com</BillingEmailAddress>
</PreConfigBillingInfo>
<NoService>False</NoService>
<PreConfigSuccess>1</PreConfigSuccess>
<UseOurDNS>True</UseOurDNS>
<NameServers></NameServers>
<defaulthostrecords></defaulthostrecords>
<defaulthostrecordown>False</defaulthostrecordown>
<PreConfigDNS>default</PreConfigDNS>
<AutoRenew>0</AutoRenew>
- 86 -
Domains and TLDs
<RegLock>1</RegLock>
<UseBilling>1</UseBilling>
<PreConfigDNS>default</PreConfigDNS>
<UseTech-Billing>1</UseTech-Billing>
<UseAdmin-Billing>1</UseAdmin-Billing>
<Registrant></Registrant>
<AdminBilling></AdminBilling>
<TechBilling></TechBilling>
<AuxBilling></AuxBilling>
<AccessPassword></AccessPassword>
<TLDS>
<TLD>
<TLD>xxx</TLD>
<TLDID>255</TLDID>
<Attributes>
<Attribute>
</Attributes>
</TLD>
<Count>1</Count>
</TLDS>
<Domains>
<Domain>
<SLD>mydomain</SLD>
<TLD>xxx</TLD>
<DomainID>152931321</DomainID>
<EncodingID />
<ItemID>886894</ItemID>
</Domain>
<Count>1</Count>
<IDNCount>0</IDNCount>
</Domains>
<PreviousContacts>
<Contact>
<TLD>xxx</TLD>
<ExtAttributes />
</Contact>
</PreviousContacts>
<Command>PRECONFIGURE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
- 87 -
Domains and TLDs
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.797</ExecTime>
<Done>true</Done>
<RequestDateTime>11/11/2011 11:21:18 AM</RequestDateTime>
</interface-response>
https://resellertest.enom.com/interface.asp?
Command=GetExtAttributes& UID=resellid&PW=resellerpw
&ResponseType=XML&TLD=xxxOutput:
Output
<interface-response>
<Attributes>
<Attribute>
<ID>191</ID>
<Name>xxx_memberid</Name>
<Application>2</Application>
<UserDefined>True</UserDefined>
<Required>0</Required>
<Description>Association MemberID used by xxx registry</De-
scription>
<IsChild>0</IsChild>
<Options />
</Attribute>
- 88 -
Domains and TLDs
<Attribute>
<ID>192</ID>
<Name>xxx_resolving</Name>
<Application>2</Application>
<UserDefined>False</UserDefined>
<Required>0</Required>
<Description>Do nameservers resolve at root?</Description>
<IsChild>0</IsChild>
<Options>
<Option>
<ID>1528</ID>
<Value>1</Value>
<Title>NameServers resolve at root</Title>
<Description>NameServers resolve</Description>
</Option>
<Option>
<ID>1529</ID>
<Value>nonResolver</Value>
<Title>Unresolving NameServers</Title>
<Description>NameServers do not resolve at root</De-
scription>
</Option>
</Options>
</Attribute>
</Attributes>
<Command>GETEXTATTRIBUTES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.172</ExecTime>
<Done>true</Done>
<RequestDateTime>11/29/2011 9:36:07 AM</RequestDateTime>
</interface-response>
Membership
Definition
- 89 -
Domains and TLDs
https:resellertest.enom.com/interface.asp?
Command=XXX_GETMEMBERID&UID=resellid&PW=resellerpw
&ResponseType=XML&sld=mydomain&tld=xxx
https:resellertest.enom.com/interface.asp?
Command=XXX_REMOVEMEMBERID&UID=resellid
&PW=resellerpw&ResponseType=XML&memberid=IXAE1234BDUP22FAUG
&sld=mydomain&tld=xxx
https:resellertest.enom.com/interface.asp?
Command=XXX_SETMEMBERID&UID=resellid&PW=resellerpw
&ResponseType=XML&memberid=IXAE1234BDUP22FAUG
&sld=mydomain&tld=xxx
Output
- 90 -
Domains and TLDs
<Command><![CDATA[ XXX_GETMEMBERID]]></Command>
<Language><![CDATA[ eng]]</Language>
<ErrCount><![CDATA[ 0]]></ErrCount>
<ResponseCount><![CDATA[ 0]]></ResponseCount>
<MinPeriod><![CDATA[ 1]]></MinPeriod>
<MaxPeriod><![CDATA[ 10]]></MaxPeriod>
<Server><![CDATA[ RESELLERTEST]]></Server>
<Site><![CDATA[ eNom]]></Site>
<IsLockable><![CDATA[ True ]]> </IsLockable>
<IsRealTimeTLD><![CDATA[ True]]> </IsRealTimeTLD>
<TimeDifference><![CDATA[ +3.00]]></TimeDifference>
<ExecTime><![CDATA[ 0.063]]> </ExecTime>
<Done><![CDATA[ true]]></Done>
</interface-response>
.XXX Transfer
Description
Definition
This document is designed to provide resellers with a quick guide about the processes
for transferring .XXX domain names.
Usage
Use this command to create an order to transfer domains from another registrar to eNom
or one of its resellers. There are two methods of transfers. First method, create and sub-
mit a transfer order in one command (quick transfer). Second method consist of few
steps: create, configure and submit.
Quick transfer
Definition
Create and submit domain(s) transfer in one command.
Base parameters
* Required:
SLDx: second level domain name (X=1 to DomainCount)
TLDx: top level domain name (X=1 to DomainCount)
- 91 -
Domains and TLDs
http://resellertest.enom.com/interface.asp?
UID=resellid&pw=resellpw&SLD1=mydomain&TLD1=xxx
&AuthInfo1=1234ABCD&XXX_Mem-
berID1=IXA12S3UPFA2&SLD2=yourdomain
&TLD2=xxx &AuthInfo2=ABCD1234&XXX_MemberID2=IX22WDDPHMY21TZ
&DomainCount=2&ResponseType=XML&UseContacts=1
&Command=TP_CreateOrder&OrderType=Autoverification
Output
<interface-response>
<?xml version="1.0" ?>
<interface-response>
<success>True</success>
<transferorder>
<transferorderid>175625387</transferorderid>
<orderdate>1/1/2012 11:11:11 AM</orderdate>
<ordertypeid>1</ordertypeid>
<ordertypedesc>Auto Verification</ordertypedesc>
<statusid>9</statusid>
<statusdesc>Processing</statusdesc>
<authamount>400</authamount>
<version>1</version>
<transferorderdetail>
<transferorderdetailid>77458527</transferorderdetailid>
<sld>mydomain</sld>
<tld>xxx</tld>
<statusid>9</statusid>
- 92 -
Domains and TLDs
Pre-Configuration method
Definition
Create, configure and submit domain(s) transfer. This method is used to support step-by-
step domain(s) transfer configuration.
- 93 -
Domains and TLDs
1. TP_CreateOrder
Base parameters
* Required:
SLDx: second level domain name (X=1 to DomainCount)
TLDx: top level domain name (X=1 to DomainCount)
AuthInfox: current (losing) registrar's authorization key
OrderType: permitted values are Autoverification or Fax
PreConfig: set PreConfig=1 allows you to use TP_UpdateOrderDetail to modify
DomainPassword, Lock, Renew, Contacts, and extended attributes before submitting
the order. When you are ready to submit the order, call TP_SubmitOrder.
Query
http://resellertest.enom.com/interface.asp?
command=TP_CreateOrder&TLD1=xxx&SLD1=mydomain&DomainCount=1
&Order-
Type=Autoverification&AuthInfo1=123ABCD&responsetype=xml
&UID=resellid&PW=resellepw&preconfig=1
Output
<interface-response>
<?xml version="1.0" ?>
<transferorder>
<transferorderid>175625417</transferorderid>
<orderdate>1/11/2012 1:1:11 PM</orderdate>
<ordertypeid>1</ordertypeid>
<ordertypedesc>Auto Verification</ordertypedesc>
<statusid>5</statusid>
<statusdesc>Order not submitted</statusdesc>
<authamount>100</authamount>
<version>1</version>
<transferorderdetail>
<transferorderdetailid>77458539</transferorderdetailid>
<sld>mydomain</sld>
<tld>xxx</tld>
<statusid>35</statusid>
<statusdesc>Transfer request not yet submitted</statusdesc>
- 94 -
Domains and TLDs
<price>80</price>
<usecontacts>0</usecontacts>
</transferorderdetail>
<transferorderdetailcount>1</transferorderdetailcount>
</transferorder>
<Command>TP_CREATEORDER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.547</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 1:1:11 PM </RequestDateTime>
</interface-response>
2. TP_UpdateOrderDetail
You can use this command to update multiple domain names. Each item must be in
comma delimited format and the total item of each category must be matched. If you
need to update other parameters such as Registrar Lock, Auto-Renew and so on, please
refer to TP_UpdateOrderDetail detailed information in the API Catalog.
Here are few combinations:
VALID:
lTransferOrderDetailID=175625417&xxx_memberid=
l TransferOrderDetailID=175625417&xxx_memberid=1111
l TransferOrderDetailID=175625417,175625418&xxx_memberid=1111,
l TransferOrderDetailID=175625417,175625418,175625419&xxx_mem-
berid=1111,,
l TransferOrderDetailID=175625417,175625418,175625419&xxx_mem-
berid=1111,,3333
l TransferOrderDetailID=175625417,175625418,175625419&xxx_mem-
berid=,,3333
NOT VALID:
- 95 -
Domains and TLDs
lTransferOrderDetailID=175625417,175625418&xxx_memberid=1111
l TransferOrderDetailID=175625417,175625418,175625419&xxx_mem-
berid=1111,2222
Base parameters
* Required:
Update: type of update for this command. In this case, Update=XXX_MemberID
TransferOrderDetailID: transfer order ID number. Use the TP_GetOrder command to
retrieve this value
* Optional:
xxx_memberid: membership authorization token provided by ICM Registry
Query
http://resellertest.enom.com/interface.asp?
UID=resellid&PW=resellpw&ResponseType=xml
&Command=TP_UpdateOrderDetail&update=xxx_memberid
&TransferOrderDetailID=175625417,175625418&xxx_mem-
berid=,2222
Output
<interface-response>
<?xml version="1.0" ?>
<interface-response>
<TransferOrders>
<TransferOrder>
<OrderDetailID>175625417</OrderDetailID>
<XXX_MemberID />
<UpdateSuccess>True</UpdateSuccess>
</TransferOrder>
<TransferOrder>
<OrderDetailID>175625418</OrderDetailID>
<XXX_MemberID>2222</XXX_MemberID>
<UpdateSuccess>True</UpdateSuccess>
</TransferOrder>
</TransferOrders>
<success>True</success>
<Command>TP_UPDATEORDERDETAIL</Command>
<Language>eng</Language>
- 96 -
Domains and TLDs
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.234</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 1:11:11 PM</RequestDateTime>
</interface-response>
3. TP_SubmitOrder
Base parameters
* Required:
TransferOrderID: transfer order ID number. To retrieve this value, use the TP_GetOrder-
Statuses command
Query
http://resellertest.enom.com/interface.asp?
Command=TP_SubmitOrder&uid=resellid&pw=resellpw
&responsetype=xml&transferorderid=175625417
Output
<interface-response>
<?xml version="1.0" ?>
<interface-response>
<success>True</success>
<Command>TP_SUBMITORDER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
- 97 -
Domains and TLDs
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 1:11:11 PM</RequestDateTime>
</interface-response>
- 98 -
API Command Categories
These categories separate the API commands into groups based on functionality. Click
on any link to be redirected to the reference page for that command.
Domain Registration
l AddBulkDomains
l Check
l DeleteRegistration
l GetAgreementPage
l GetConfirmationSettings
l GetExtAttributes
l GetTLDList
l NameSpinner
l Preconfigure
l Purchase
- 99 -
API Command Categories
l GetRegHosts
l GetSPFHosts
l SetDomainSRVHosts
l SetHosts
l SetSPFHosts
l UpdateMetaTag
Domain ManagementContacts
l Contacts
l GetContacts
l GetExtAttributes
l GetWhoisContact
l GetWPPSInfo
Domain ManagementGeneral
l AdvancedDomainSearch
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomainNameID
l GetDomains
l GetDomainSLDTLD
l GetDomainStatus
l GetExpiredDomains
l GetExtendInfo
l GetHomeDomainList
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
- 100 -
API Command Categories
l GetRenew
l GetSubAccountPassword
l ParseDomain
l RPT_GetReport
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
Domain Management.tel
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_IsCTHUser
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
Domain ManagementWatchlist
l TLD_AddWatchlist
l TLD_DeleteWatchlist
l TLD_GetTLD
l TLD_GetWatchlist
Domain Management.xxx
l XXX_GetMemberID
l XXX_RemoveMemberID
l XXX_SetMemberID
- 101 -
API Command Categories
Domain Renewal
l Extend
l Extend_RGP
l GetDomainExp
l GetExtendInfo
l GetRenew
l InsertNewOrder
l SetRenew
l UpdateExpiredDomains
l UpdateRenewalSettings
Domain Transfer
l PE_GetTLDID
l PE_SetPricing
l PushDomain
l RefillAccount
l SetResellerServicesPricing
l SetResellerTLDPricing
l SynchAuthInfo
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_GetTLDInfo
l TP_ResendEmail
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdateAccountPricing
l UpdatePushList
DNS Hosting
l DeleteHostedDomain
l ExtendDomainDNS
l PurchaseHosting
l SetDNSHost
- 102 -
API Command Categories
Domain Services
l DisableServices
l EnableServices
l GetDomainServices
l GetHomeDomainList
l GetIPResolver
l PurchaseServices
l RenewServices
l ServiceSelect
l SetIPResolver
- 103 -
API Command Categories
Service ManagementSiteLock
l GetProductSelectionList
l SL_AutoRenew
l SL_Configure
l SL_GetAccountDetail
l SL_GetAccounts
Service ManagementRichContent
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
- 104 -
API Command Categories
Service ManagementgoMobi
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
- 105 -
API Command Categories
Account
l AddContact
l AuthorizeTLD
l CheckLogin
l CreateAccount
l CreateSubAccount
l DeleteContact
l DeleteSubaccount
l GetAccountInfo
l GetAccountPassword
l GetAccountValidation
l GetAddressBook
l GetAllAccountInfo
l GetCusPreferences
l GetCustomerPaymentInfo
l GetGlobalChangeStatus
l GetGlobalChangeStatusDetail
l GetOrderDetail
l GetOrderList
l GetReport
l GetResellerInfo
l GetServiceContact
l GetSubAccountDetails
l GetSubAccounts
l GetSubaccountsDetailList
l GetTLDList
l GetTransHistory
l GetWebHostingAll
l RemoveTLD
l RPT_GetReport
l SendAccountEmail
l SubAccountDomains
l UpdateAccountInfo
l UpdateCusPreferences
l UpdateRenewalSettings
Accounting
l CommissionAccount
l GetBalance
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
- 106 -
API Command Categories
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l RefillAccount
l UpdateNotificationAmount
Shopping Cart
l AddBulkDomains
l AddToCart
l DeleteFromCart
l GetCartContent
l InsertNewOrder
l PurchasePreview
l UpdateCart
Real-Time Purchase
l Extend
l Extend_RGP
l Purchase
l PurchaseHosting
l PurchasePOPBundle
l PurchaseServices
l RenewPOPBundle
l RenewServices
l TP_CreateOrder
l TP_ResubmitLocked
l TP_SubmitOrder
l UpdateExpiredDomains
Reporting commands
l DeleteCustomerDefinedData
l GetCustomerDefinedData
l GetOrderDetail
l GetOrderList
l GetReport
l GetTLDList
l GetTransHistory
l RPT_GetReport
l SetCustomerDefinedData
- 107 -
API Command Categories
Customer Support
l DeleteCustomerDefinedData
l GetCustomerDefinedData
l GetServiceContact
l SetCustomerDefinedData
- 108 -
API Command Categories
l WebHostSetOverageOptions
l WebHostUpdatePassword
Domain Headers
Associating a domain name with a Web hosting account
l AddDomainHeader
l DeleteDomainHeader
l GetDomainHeader
l ListDomainHeaders
l ModifyDomainHeader
Host Headers
l AddHostHeader
l DeleteHostHeader
l GetHostHeader
l ListHostHeaders
l ModifyHostHeader
IIS Applications
l DisableFolderApp
l EnableFolderApp
l IsFolderEnabled
l MetaBaseGetValue
l MetaBaseSetValue
- 109 -
API Command Categories
SQL Database
l MySQL_GetDBInfo
AddBulkDomains
Description
Definition
Add a list of items to the shopping cart.
Usage
Use this command when you want to add multiple items to the shopping cart.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/ListRegister.asp
On the Batch register page, the add to cart button calls the AddBulkDomains command.
Constraints
The domain names in your list must meet the following requirements:
The domain names must be valid (see the domain-name constraints under Check).
The domain names must use a supported top-level domain.
The number of SLDs must match the number of TLDs.
Input parameters
- 110 -
API Command Categories
numyearsX
Optional Number of years to renew 1
(X=1 to listcount)
- 111 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds resellerdocs.com, resellerdocs2.net, and resellerdocs3.info to
the shopping cart of account resellid, and sends the response in XML format:
Query
https://re-
sellertest.enom.com/interface.asp?command=addbulkdomains&
uid=resellid&pw=resellpw&producttype=register&listcount=3&
sld1=resellerdocs&tld1=com&sld2=resellerdocs2&tld2=net&
sld3=resellerdocs3&tld3=info&responsetype=xml
- 112 -
API Command Categories
<interface-response>
<AddBulkDomains>
<Item>
<WscAccountOverride>False</WscAccountOverride>
<ItemName>resellerdocs1314.com</ItemName>
<ItemId>889487</ItemId>
<Price>8.95</Price>
<ICANNFees>0.20</ICANNFees>
<CartItemID>889487</CartItemID>
<NewDomainNameID>152933101</NewDomainNameID>
<ItemAdded>True</ItemAdded>
<DomainName>resellerdocs1314.com</DomainName>
</Item>
<Item>
<WscAccountOverride>False</WscAccountOverride>
<ItemName>resellerdocs465442.net</ItemName>
<ItemId>889488</ItemId>
<Price>8.95</Price>
<ICANNFees>0.20</ICANNFees>
<CartItemID>889488</CartItemID>
<NewDomainNameID>152933102</NewDomainNameID>
<ItemAdded>True</ItemAdded>
<DomainName>resellerdocs465442.net</DomainName>
</Item>
<Item>
<WscAccountOverride>False</WscAccountOverride>
<ItemName>resellerdoc213131s3.info</ItemName>
<ItemId>889489</ItemId>
<Price>8.95</Price>
<ICANNFees>0.20</ICANNFees>
<CartItemID>889489</CartItemID>
<NewDomainNameID>152933103</NewDomainNameID>
<ItemAdded>True</ItemAdded>
<DomainName>resellerdoc213131s3.info</DomainName>
</Item>
<ListCount>3</ListCount>
<CartErrors>0</CartErrors>
<AllItemsSuccessful>True</AllItemsSuccessful>
<CartItems>6</CartItems>
</AddBulkDomains>
<Success>True</Success>
<UseCart>True</UseCart>
- 113 -
API Command Categories
<Command>ADDBULKDOMAINS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>845c0d1a-608a-49b4-bc5e-6694d-
b329877</TrackingKey>
<RequestDateTime>12/12/2011 12:59:58 AM</RequestDateTime>
</interface-response>
Related commands
l AddToCart
l Check
l DeleteFromCart
l GetCartContent
l InsertNewOrder
l Purchase
l PurchasePreview
l UpdateCart
AddContact
Description
Definition
Add a contact to the address book for an account.
Usage
Use this command to add a contact to the address book for an account.
To retrieve the contacts in an address book, use the GetAddressBook command.
- 114 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://re-
sellertest.enom.com/interface.asp?command=nameofcommand&uid=
yourloginid&pw=yourpassword¶mname=
paramvalue&nextparamname=nextparamvalue
- 115 -
API Command Categories
Notes
- 116 -
API Command Categories
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds a party to the address book for account resellid and sends the
response in XML format:
Query
https://re-
sellertest.enom.com/interface.asp?command=addcontact&
uid=resellid&pw=resellpw&RegistrantFirstName=john
&Re-
gistrantLastName=doe&RegistrantAddress1=111%20Main%20Street
&RegistrantAddress2=Suite%20100&
RegistrantCity=Hometown&RegistrantStateProvince=WA
&Re-
gis-
trantStateProvinceChoice=state&RegistrantPostalCode=99999
&RegistrantCountry=us&RegistrantPhone=+800.5554444&
RegistrantFax=+800.5554445&RegistrantEmailAddress=
john.doe@resellerdocs.com&responsetype=xml
In the response, a Party ID and an ErrCount value of 0 confirm that the query was suc-
cessful:
Output
<interface-response>
<Contact>
<RegistrantPartyID>{2B3CFB2C-7125-E111-A3F0-005056BC7747}
</RegistrantPartyID>
</Contact>
<Command>ADDCONTACT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
- 117 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.625</ExecTime>
<Done>true</Done>
<RequestDateTime>12/13/2011 1:59:43 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l Contacts
l GetAddressBook
l GetContacts
l GetExtAttributes
l GetResellerInfo
l GetServiceContact
l GetWhoisContact
l Preconfigure
AddDomainFolder
Description
Definition
Create a folder for organizing or managing your domain names.
Usage
Use this command to create either a Standard folder that simply lets you organize your
domains, or a Magic folder that allows you to apply the same settings to all the domains
in the folder.
This command creates folders; another command, UpdateDomainFolder, configures
their settings. Settings that can be managed via a Magic folder include the following, in
any combination:
- 118 -
API Command Categories
l Auto-renew
l Registrar lock
l Access password
l DNS servers
l Host records
Billing, Technical)
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Manager.aspx?tab=folder&start=1
In the Create a new folder section, the GO button calls the AddDomainFolder command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://re-
sellertest.enom.com/interface.asp?command=nameofcommand&
uid=yourloginid&pw=yourpassword¶mname=
paramvalue&nextparamname=nextparamvalue
- 119 -
API Command Categories
- 120 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a new folder and sends the response in XML format:
Query
https://re-
sellertest.enom.com/interface.asp?command=AddDomainFolder&
uid=resellid&pw=resellpw&FolderName=Favorites&
FolderDescription=FolderForMyFavoriteNames&FolderType=1&
CopyFolder-
Name=Subfavorites&CopyDomainName=resellerdocs.com&
responsetype=XML
In the response, the presence of your input values and an ErrCount value 0 indicate that
the query was successful:
Output
<interface-response>
<WscAccountOverride>False</WscAccountOverride>
<ItemName>resellerdocs1.com</ItemName>
<ItemId/>
<Price>8.95</Price>
<ICANNFees>0.20</ICANNFees>
<CartItemID>889049</CartItemID>
<NewDomainNameID>152932786</NewDomainNameID>
<ItemAdded>True</ItemAdded>
<Command>ADDTOCART</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
- 121 -
API Command Categories
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.688</ExecTime>
<Done>true</Done>
<RequestDateTime>12/6/2011 11:51:55 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AdvancedDomainSearch
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l RemoveUnsyncedDomains
l UpdateDomainFolder
AddDomainHeader
Description
Definition
Associate a domain name with a Web hosting account.
Usage
You must create at least one domain header to publish a Web site for the domain name.
You may create additional domain headers if you want more than one domain name in
your Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingdomains.asp?HostAccount=resellwebid
- 122 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
l The domain header must not already exist.
l The domain designated by the SLD and TLD parameters must be hosted by us.
l If we are the registrar for this domain, it must be in this account.
l This command does not create a directory, and allows you to point to a directory
that does not exist.
Input parameters
Build the query string using this syntax:
https://re-
sellertest.enom.com/interface.asp?command=nameofcommand&
uid=yourloginid&pw=yourpassword& par-
amname=paramvalue&nextparamname=nextparamvalue
- 123 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a new domain header for Web hosting account resellwebid,
designating that the @ host record for domain resellerdocs2.net points at directory ser-
vice. Finally, the query string instructs that the
response be in XML format:
Query
https://re-
sellertest.enom.com/interface.asp?command=AddDomainHeader&
uid=resellid&pw=resellpw&sld=resellerdocs2&tld=net&
hostaccount=resellwebid&directory=\service&responsetype=xml
- 124 -
API Command Categories
In the response, the Successful value True indicates that the query was successful:
Output
Related commands
l AddHostHeader
l CreateHostAccount
l DeleteDomainHeader
l GetDomainHeader
l ListDomainHeaders
AddHostHeader
Description
Definition
Create a host header (a pointer for a third-level domain name) in your Web hosting
account.
Usage
Use this command to add a host header to your Web hosting account.
- 125 -
API Command Categories
Use this command to set the www host header for your account if you want www.y-
ourdomainname.com to resolve to a location other than the root directory of your Web
hosting account.
Another common use for this command is to branch a domain name, for example, so
that sales.example.com and service.example.com resolve to different pages.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingteLog on to webhostingtest.ehost-services.com with Login ID resell-
webid, password resellwebpw.
http://webhostingtest.ehost-services.com/websites/hostheader.asp?d=resellerdocs.com
The SAVE HOST HEADER SETTINGS button calls the AddHostHeader command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The domain header must already exist.
Input parameters
Build the query string using this syntax:
https://re-
sellertest.enom.com/interface.asp?command=nameofcommand&
uid=yourloginid&pw=yourpassword& par-
amname=paramvalue&nextparamname=nextparamvalue
- 126 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds a host header servicedept to domain header resellerdocs.com.
Note that the query string specifies, but does not create, a directory path for the host
header. You can create a directory structure using the WebHostCreateDirectory com-
mand.
- 127 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=addhostheader&uid=resellid&pw=
resellpw&SLD=resellerdocs&TLD=com
&hostaccount=resellwebid&FilePath=
service/service2/service3&HostName=servicedept&
responsetype=xml
In the response, the success value of True confirms that the query was successful:
Output
Related commands
l AddDomainHeader
l CreateHostAccount
l DeleteDomainHeader
l DeleteHostHeader
l GetAllHostAccounts
l GetDomainHeader
l GetHostAccount
l GetHostHeader
l ListDomainHeaders
l ListHostHeaders
l ModifyHostHeader
- 128 -
API Command Categories
AddToCart
Description
Definition
Add an item to the shopping cart.
Usage
Add an item to the shopping cart.
To purchase items once they are in the shopping cart, use the InsertNewOrder com-
mand.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domainsearch/default.aspx
Type a domain name and click Search. On the Search Results page, the Proceed to
Cart button calls the AddToCart command. If the user selects multiple items, clicking the
Proceed to Cart button calls the AddToCart command once for each item.
Constraints
The query must meet the following requirements:
l If the item is a domain name, use the Check command to confirm that the name is
available.
l The domain names must be valid (see the domain-name constraints under Check).
l The domain names must use a top-level domain supported by this registrar.
l The number of SLDs must match the number of TLDs.
l There is a limit of 200 items (active plus inactive) in the cart.
Input parameters
Click the links below to go directly to specific products:
Input parameters for domains
Input parameters for dot-name
Input parameters for ID Protect
- 129 -
API Command Categories
- 130 -
API Command Categories
l Required for
l Register
l Renew
l RGP
l Extended Second-level domain name (for
SLD 63
l RGP example, enom in enom.com)
l Host
l Host
l Renew Premi-
umDomain
Required for:
l Register
l Renew
l RGP
Extended Top-level domain name (exten-
TLD l
15
l RGP sion)
l Host
l Host
l Renew Premi-
umDomain
Optional for
l Register Permitted values are 1 through
l Renew 10 for most domains; some
l Host TLDs vary. Registration can-
Quantity l Host Renew not extend beyond 10 years 2
l PremiumDomain; from today for any TLD. Per-
default is duration you mitted value for Premi-
set in UpdateCusPrefer- umDomain is 1
ences Number of
years.
- 131 -
API Command Categories
- 132 -
API Command Categories
Required for:
DotNameBundle Second-level domain name (for
SLD 63
example, enom in enom.com)
DotNameForwarding
Required for:
TLD DotNameBundle Top-level domain name (extension) 15
DotNameForwarding
- 133 -
API Command Categories
Required for
Second-level domain name (for example,
SLD IDProtect 63
enom in enom.com)
IDProtectRenewal
Required for
TLD IDProtect Top-level domain name (extension) 15
IDProtectRenewal
Optional;
Quantity Number of years. 2
default is 1
- 134 -
API Command Categories
- 135 -
API Command Categories
- 136 -
API Command Categories
- 137 -
API Command Categories
ClearItems Optional; you must Make all items currently in the cart inact- 3
- 138 -
API Command Categories
- 139 -
API Command Categories
- 140 -
API Command Categories
- 141 -
API Command Categories
Required for
BusListing Second-level domain name (for example,
SLD 63
enom in enom.com)
and
BusListingRenewal
Required for
BusListing Renewal Top-level domain name (exten-
TLD 15
sion)
and BusListing
Optional;
Quantity Number of years. 2
default is 1
- 142 -
API Command Categories
Required for
POP
Second-level domain name (for example,
SLD 10
Renew-POP enom in enom.com)
EmailStorage
Required
forPOPRenew-
TLD Top-level domain name (extension) 10
POP EmailStorage
Required for
POP pak ID number. To retrieve this
ProductID Renew-POP 3
value, use the GetPOP3 command.
EmailStorage
- 143 -
API Command Categories
URLForwarding
URLForwardingRenew
Required for
EmailForwarding Second-level domain name (for
SLD EmailForwardingRenew 63
example, enom in enom.com)
URLForwarding
URLForwardingRenew
Required forE-
mailForwarding
TLD EmailForwardingRenew Top-level domain name (extension) 15
URLForwarding
URLForwardingRenew
Optional for
EmailForwarding
Quantity EmailForwardingRenew Number of years 2
URLForwarding
URLForwardingRenew
- 144 -
API Command Categories
- 145 -
API Command Categories
Optional; default is
Quantity Number of months 2
1
- 146 -
API Command Categories
- 147 -
API Command Categories
Optional;
Quantity Number of years 2
default is 1
- 148 -
API Command Categories
- 149 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds resellerdocs.com to the shopping cart of account resellid and
sends the response in XML format:
Query
https://re-
sellertest.enom.-
com/interface.asp?command=addtocart&uid=resellid&pw=
resellpw&sld=resellerdocs&tld=com
&producttype=register&responsetype=xml
<interface-response>
<WscAccountOverride>False</WscAccountOverride>
<ItemName>resellerdocs.com</ItemName>
<ItemId/>
<Price>8.95</Price>
<ICANNFees>0.20</ICANNFees>
<CartItemID>889066</CartItemID>
<NewDomainNameID>152932796</NewDomainNameID>
<ItemAdded>True</ItemAdded>
<Command>ADDTOCART</Command>
- 150 -
API Command Categories
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.781</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 3:27:30 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddBulkDomains
l DeleteFromCart
l GetCartContent
l GetHomeDomainList
l InsertNewOrder
l PurchasePreview
l UpdateCart
AdvancedDomainSearch
Description
Definition
Search the domains in your account.
Usage
Use this command to search domains that are in your account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 151 -
API Command Categories
https://resellertest.enom.com/domains/Domain-Manager.aspx?tab=search
The search button calls the AdvancedDomainSearch command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 152 -
API Command Categories
- 153 -
API Command Categories
- 154 -
API Command Categories
- 155 -
API Command Categories
Parameter Description
SP-NSStatus Returned domains match this name server status
SP-ContactXML
- 156 -
API Command Categories
Parameter Description
SP-WBLStatusID Returned domains have this status ID
The next response will start at this position in the overall sorted
NextPosition
list
Is the price for this premium .tv name above the premium
PremiumAboveThresholdPrice
threshold price?
- 157 -
API Command Categories
Parameter Description
PremiumCategory Premium category for a .tv name
WBLStatusID Status identifier for Business Listing for this domain name
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves domains that match the specified search criteria, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=AdvancedDomainSearch&uid=resellid&pw=
resellpw&SearchCriteria=Start&SLD=r&ExcludeNumbers=1&
ExcludeDashes=1&OrderBy=ExpDate&responsetype=XML
In the response, a domain list and an ErrCount value 0 indicate that the query was suc-
cessful:
- 158 -
API Command Categories
Output
<interface-response>
<DomainSearch>
<SearchParams>
<SP-TLDList>*</SP-TLDList>
<SP-SLD>r</SP-SLD>
<SP-SearchCriteria>Start</SP-SearchCriteria>
<SP-ParkingStatus/>
<SP-XML>
<DomainNames>
<DomainName sld="r" location="Start"/>
</DomainNames>
</SP-XML>
<SP-RegistrationStatus>Registered</SP-RegistrationStatus>
<SP-AutoRenew/>
<SP-Locked/>
<SP-DaysTillExpires/>
<SP-DaysExpired/>
<SP-NsStatus/>
<SP-HostRecordType/>
<SP-HostName/>
<SP-HostAddress/>
<SP-NameServer/>
<SP-HasIDProtect/>
<SP-HasPOPMail/>
<SP-EmailForwarding/>
<SP-HasWebHosting/>
<SP-ExcludeNumbers>True</SP-ExcludeNumbers>
<SP-ExcludeDashes>True</SP-ExcludeDashes>
<SP-IncludeSubAccounts/>
<SP-SubAccountLogin/>
<SP-XMLResponse>1</SP-XMLResponse>
<SP-RecordsToReturn>100</SP-RecordsToReturn>
<SP-StartPosition>1</SP-StartPosition>
<SP-OrderBy>ExpDate</SP-OrderBy>
<SP-CustomerGroupName/>
<SP-FolderOption/>
<SP-FolderSyncStatus/>
<SP-FolderName/>
<SP-EmailResultsOnly/>
<SP-CreationDate/>
<SP-DaysUntilIDProtectExpires/>
- 159 -
API Command Categories
<SP-ContactXML/>
<SP-WBLStatusID/>
<SP-WBLEnabled/>
<SP-WBLAutoRenew/>
</SearchParams>
<TotalResults>33</TotalResults>
<StartPosition>1</StartPosition>
<NextPosition>1</NextPosition>
<MultiRRP>False</MultiRRP>
<TLDOverride>0</TLDOverride>
<Domains>
<Domain>
<DomainNameID>318265464</DomainNameID>
<SLD>rtrtretqq</SLD>
<TLD>com</TLD>
<AutoRenew>0</AutoRenew>
<ExpDate>12/30/2005</ExpDate>
<DomainRe-
gistrationStatus>Registered</DomainRegistrationStatus>
<DeleteType/>
<LoginID>resellid</LoginID>
<AccountID>217-no-0647</AccountID>
<NSStatus>Yes</NSStatus>
<FolderStatus>0</FolderStatus>
<RRProcessor>E</RRProcessor>
<RRCompanyName>eNom, Inc.</RRCompanyName>
<HasIDProtect>disabled</HasIDProtect>
<IDProtectExpires/>
<DomainFolderStatus>0</DomainFolderStatus>
<WBLStatusID>0</WBLStatusID>
<WBLStatus>Available</WBLStatus>
<WBLExpDate/>
<WBLAutoRenew/>
<NameServers>dns1.name-services.com,dns2.name-services.com,
dns3.name-services.com,dns4.name-services.com,
dns5.name-services.com</NameServers>
<Vas/>
</Domain>
<Domain>
<DomainNameID>318273905</DomainNameID>
<SLD>roscoisgek</SLD>
<TLD>com</TLD>
- 160 -
API Command Categories
<AutoRenew>1</AutoRenew>
<ExpDate>5/13/2006</ExpDate>
<DomainRe-
gistrationStatus>Registered</DomainRegistrationStatus>
<DeleteType/>
<LoginID>resellid</LoginID>
<AccountID>217-no-0647</AccountID>
<NSStatus>Yes</NSStatus>
<FolderStatus>0</FolderStatus>
<RRProcessor>E</RRProcessor>
<RRCompanyName>eNom, Inc.</RRCompanyName>
<HasIDProtect>enabled</HasIDProtect>
<IDProtectExpires>7/29/2007</IDProtectExpires>
<DomainFolderStatus>0</DomainFolderStatus>
<WBLStatusID>0</WBLStatusID>
<WBLStatus>Available</WBLStatus>
<WBLExpDate/>
<WBLAutoRenew/>
<NameServers>dns1.name-services.com,dns2.name-services.com,
dns3.name-services.com,dns4.name-services.com,
dns5.name-services.com</NameServers>
<Vas/>
</Domain>
.
.
.
</Domains>
</DomainSearch>
<Command>ADVANCEDDOMAINSEARCH</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<debug/>
- 161 -
API Command Categories
<TrackingKey>340cd124-a655-41bd-820c-d3e1b731a1b3</Track-
ingKey>
<RequestDateTime>12/7/2011 3:29:08 AM</RequestDateTime>
</interface-response>
Related commands
l AddDomainFolder
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l RemoveUnsyncedDomains
l UpdateDomainFolder
AM_AutoRenew
Description
Definition
Set the Auto Renew flag for a GeoTrust Anti-Malware subscription.
Usage
Use this command to set the Auto Renew flag for a GeoTrust Anti-Malware subscription.
In the eNom web site, we only display the Auto Renew setting for subscriptions in status
Service Active, but our API allows you to set the Auto Renew flag at any time.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-anti-malware/details.aspx?id=11
- 162 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The GeoTrust Anti-Malware subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 163 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query sets the Auto Renew flag for a GeoTrust Anti-Malware subscription,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=AM_AutoRenew&UID=resellid&PW=resellpw
&ResponseType=XML&AMID=11&AutoRenew=True
Output
<?xml version="1.0"?>
<interface-response>
<AMID>2</AMID>
<AutoRenew>True</AutoRenew>
<Success>True</Success>
<Command>AM_AUTORENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
- 164 -
API Command Categories
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.016</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 10:35:29 AM</RequestDateTime>
</interface-response>
Related commands
l AM_Configure
l AM_GetAccountDetail
l AM_GetAccounts
l AM_Renew
AM_Configure
Description
Definition
Configure a GeoTrust Anti-Malware account.
Usage
Use this command to configure a GeoTrust Anti-Malware subscription after initial pur-
chase.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-anti-malware/details.aspx?id=11
Constraints
The query must meet the following requirements:
- 165 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?command=
nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 166 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query configures a GeoTrust Anti-Malware subscription after initial pur-
chase, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?command=AM_Con-
figure&UID=resellid&PW=resellpw&ResponseType=XML&AMID=11
&DomainName=mydomain.com&AdminEmail=owner@mydomain.com
&TechE-
mail=webmaster@mydomain.com&TechFName=John&TechLName=Smith
Output
<?xml version="1.0"?>
<interface-response>
<AMID>10</AMID>
<DomainName>mydomain.com</DomainName>
- 167 -
API Command Categories
<AdminEmail>owner@mydomain.com</AdminEmail>
<TechnicalEmail>webmaster@mydomain.com</TechnicalEmail>
<TechnicalFName>John</TechnicalFName>
<TechnicalLName>Smith</TechnicalLName>
<Success>True</Success>
<Command>AM_CONFIGURE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/> <MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site> <IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>10.000</ExecTime>
<Done>true</Done>
<RequestDateTime>11/11/2011 11:11:11 PM</RequestDateTime>
</interface-response>
Related commands
l AM_AutoRenew
l AM_GetAccountDetail
l AM_GetAccounts
l AM_Renew
AM_GetAccountDetail
Description
Definition
Retrieve detailed information for one GeoTrust Anti-Malware account.
Usage
Use this command to retrieve detailed information for one GeoTrust Anti-Malware sub-
scription.
Availability
All resellers have access to this command
- 168 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-anti-malware/details.aspx?id=11
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The GeoTrust Anti-Malware subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?command=
nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 169 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query retrieves detailed information for one GeoTrust Anti-Malware sub-
scription, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?command=AM_
GetAc-
coun-
tDetail&UID=resellid&PW=resellpw&ResponseType=XML&AMID=11
Output
<?xml version="1.0"?>
<interface-response>
<AMID>11</AMID>
<DomainName>mydomain.com</DomainName>
<ProdType>177</ProdType>
<ProdDesc>GeoTrust Anti-Malware Scan</ProdDesc>
<StatusID>1</StatusID>
<Status>Active</Status>
<SubStatusID>4</SubStatusID>
<SubStatus>Active</SubStatus>
<OrderDate>11/11/2011 4:35:27 PM</OrderDate>
- 170 -
API Command Categories
<OrderID>157776111</OrderID>
<ReferenceID/>
<ConfigurationDate>11/11/2011 11:11:11 PM</Con-
figurationDate>
<FulfillmentDate/>
<ExpirationDate>11/11/2012 3:47:18 PM</ExpirationDate>
<ValidityPeriod>12</ValidityPeriod>
<AutoRenew>True</AutoRenew>
<AdminEmail>owner@mydomain.com</AdminEmail>
<TechFName>John</TechFName>
<TechLName>Smith</TechLName>
<TechEmail>webmaster@mydomain.com</TechEmail>
<Success>True</Success>
<Message/>
<Command>AM_GETACCOUNTDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 11:59:51 AM</RequestDateTime>
</interface-response>
Related commands
l AM_AutoRenew
l AM_Configure
l AM_GetAccounts
l AM_Renew
- 171 -
API Command Categories
AM_GetAccounts
Description
Definition
Retrieve a list of GeoTrust Anti-Malware account for this login ID.
Usage
Use this command to retrieve a list of GeoTrust Anti-Malware account for this login ID.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-anti-malware/manage.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The GeoTrust Anti-Malware subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?command=
nameofcommand&uid=yourloginid&pw=yourpassword¶mname
=paramvalue&nextparamname=nextparamvalue
- 172 -
API Command Categories
- 173 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query retrieves a list of GeoTrust Anti-Malware account for this login ID,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?command=
AM_GetAccounts&UID=resellid&PW=resellpw&ResponseType
- 174 -
API Command Categories
=XML&PagingPageSize=5&Prodtype=175&SortBy=StatusID
Output
- 175 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 2:06:27 PM</RequestDateTime>
</interface-response>
Related commands
l AM_AutoRenew
l AM_Configure
l AM_GetAccountDetail
l AM_Renew
AssignToDomainFolder
Description
Definition
Assign one or more domains to one folder.
Usage
Use this command to assign one or more domains to a folder. Most commonly, youll put
domains in a standard folder to organize them; in a Magic Folder to manage settings.
You can assign domains in several ways:
l Put a list of domains into a folder.
l Move a list of domains from one folder to another, or from all folders where the
domains currently reside to a single folder.
l Copy a list of domains to a folder so that they are in multiple folders (but a domain
Availability
- 176 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The folder must belong to this login ID.
l A domain can only be in one Magic Folder at a time. See Notes.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?command=
nameofcommand&uid=yourloginid&pw=yourpassword¶mname
=paramvalue&nextparamname=nextparamvalue
- 177 -
API Command Categories
Required if Trans-
ferMode=1 or 2; Assign the listed domains to this folder.
ToFolderName 125
Ignored if Trans- Permitted value is one folder name.
ferMode=3
Parameter Description
ToFolderName Destination folder for domains
- 178 -
API Command Categories
Parameter Description
synchronization is in progress
7 At least one domain is already associated with another Magic
Folder
8 Unable to remove domains from folder
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l A domain can only be in one Magic Folder at a time.
l If a query string uses a wildcard value when removing domains from folders, or
does not specify a foldername (TransferMode=3&FromFolderName=*), it will
remove the domains from all folders they arecurrently in.
Example
The following query copies two domains into a folder and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=AssignToDomainFolder&uid=resellid
&pw=resellpw&DomainIDList=152656650,152656651&ToFolderName
=Lock&TransferMode=1&ResponseType=XML
In the response, a Result value 1 and an ErrCount value 0 confirm that the query was
successful:
- 179 -
API Command Categories
Output
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l DeleteDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l RemoveUnsyncedDomains
l UpdateDomainFolder
- 180 -
API Command Categories
AuthorizeTLD
Description
Definition
Create or add to a list of TLDs that you offer to your resellers and retail customers.
Usage
Use this command to specify the TLDs that you offer to your resellers and retail cus-
tomers. This command controls which TLDs your Web site can offer for registrations,
renewals, and transfers.
The first time you use this command, the list of TLDs we return to you switches from the
list of all TLDs we offer, which is the default, to your own list that contains only the TLDs
you authorize.
You can also use this command to add to your list of authorized TLDs. When you want to
add one TLD, run AuthorizeTLD with that single TLD.
To revert from the authorized TLD mode back to the default mode (all TLDs that we sup-
port), or to remove TLDs from your list, use the RemoveTLD command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
Clicking the TLD Pricing tab shows either the complete set of TLDs we offer, or the TLDs
you have authorized.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l You can only authorize TLDs that we offer.
- 181 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword¶mname=
paramvalue&nextparamname=nextparamvalue
- 182 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query authorizes TLDs .com, .net, and .org for account resellid, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=authorizetld&uid=resellid&pw=
resellpw&domainlist=com,net,org,info,biz&responsetype=xml
In the response, the list of TLDs and the ErrCount value 0 confirm that the query was suc-
cessful:
Output
<interface-response>
<tldlist>
<authorizetld>com</authorizetld>
<authorizetld>net</authorizetld>
<authorizetld>org</authorizetld>
<authorizetld>info</authorizetld>
<authorizetld>biz</authorizetld>
</tldlist>
<Command>AUTHORIZETLD</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
- 183 -
API Command Categories
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.188</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>1b2b72b9-77df-4666-a0cc-30c02aefed-
e9</TrackingKey>
<RequestDateTime>12/7/2011 3:34:07 AM</RequestDateTime>
</interface-response>
Related commands
l GetTLDList
l PE_SetPricing
l RemoveTLD
l SetResellerTLDPricing
AutoRenew
Description
Definition
Set the Auto Renew flag for a GeoTrust Anti-Malware subscription.
Usage
Use this command to set the Auto Renew flag for a GeoTrust Anti-Malware subscription.
In the eNom web site, we only display the Auto Renew setting for subscriptions in status
Service Active, but our API allows you to set the Auto Renew flag at any time.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-anti-malware/details.aspx?id=11
- 184 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The GeoTrust Anti-Malware subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw
=yourpassword¶mname=paramvalue&nextparamname=nextparamvalue
- 185 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query sets the Auto Renew flag for a GeoTrust Anti-Malware subscription,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?command=AM_
AutoRenew&UID=resellid&PW=resellpw&ResponseType=XML
&AMID=11&AutoRenew=True
Output
<?xml version="1.0"?>
<interface-response>
<AMID>2</AMID>
<AutoRenew>True</AutoRenew>
<Success>True</Success>
<Command>AM_AUTORENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
- 186 -
API Command Categories
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.016</ExecTime>
<Done>true</Done>
<RequestDateTime>1/11/2012 10:35:29 AM</RequestDateTime>
</interface-response>
Related commands
l AM_Configure
l AM_GetAccountDetail
l AM_GetAccounts
l AM_Renew
CalculateAllHostPackagePricing
Description
Definition
Retrieve contents, and calculate cost and selling price, of all Web hosting packages con-
figured for an account.
Usage
Use this command to generate a complete list of Web hosting packages defined for an
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Set Packages table, with the re-calculate and save packages buttons, calls and dis-
plays results of the CalculateAllHostPackagePricing command.
- 187 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 188 -
API Command Categories
Parameter Description
Number of Web site content storage units in this Web hosting
StorageUnits
package. Each storage unit is 1GB.
PackageCost The cost to this account for this Web hosting package
The price this account charges customers for this Web hosting
SellPrice
package
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 189 -
API Command Categories
Example
The following query retrieves the contents, cost, and selling price of all Web hosting
packages defined for account resellid, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CalculateAllHostPackagePricing&uid=
resellid&pw=resellpw&responsetype=xml
In the response, a list of packages and an ErrCount value 0 indicate that the query was
successful:
Output
- 190 -
API Command Categories
<BandwidthUnits>30</BandwidthUnits>
<PopUnits>10</PopUnits>
<SQLUnits>10</SQLUnits>
<PackageCost>36.70</PackageCost>
<SellPrice>58.50</SellPrice>
</package>
<PackageCount>3</PackageCount>
</resellerpackagepricing>
<Command>CALCULATEALLHOSTPACKAGEPRICING</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
- 191 -
API Command Categories
l WebHostSetCustomPackage
l WebHostSetOverageOptions
CalculateHostPackagePricing
Description
Definition
Calculate the cost and selling price of Web hosting packages (both existing and
planned) based on the costs and selling prices of their components.
Usage
Use this command to configure one or more Web hosting packages and calculate their
cost based on the components they contain. This command does not create the pack-
ages; rather, it allows you to adjust quantities of each component and view the effect on
the overall price of the package. Once you have a configuration you like, you can create
the package using the HostPackageDefine command.
Note that this command does not check for a valid package. For example, if you specify
a PackageName that already exists as a Windows package but specify Linux in this
query, the response will give the pricing for the Linux package; however, if you try to run
HostPackageDefine with the Linux package, the query will fail.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
In the Set Packages section, the re-calculate button calls the Cal-
culateHostPackagePricing command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
- 192 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 193 -
API Command Categories
Operating system of the Web hosting server for this Web host-
OSTypeX
ing account. Return values are Windows or Linux.
SellPriceX The price this account charges customers for this package
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 194 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query defines Web hosting packages Silver and Gold, calculates their cost
and resale price, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CALCULATEHOSTPACKAGEPRICING&uid=resellid
&pw-
w=resellpw&PackageName1=Silver&OSTypeID1=1&StorageUnits1=1
&BandwidthUnits1=1&PopUnits1=1&SQLUnits1=0
&PackageName2=Gold&OSTypeID2=1&&StorageUnits2=2
&BandwidthUnits2=2&PopUnits2=2&SQLUnits2=1&PackageCount=2
&responsetype=xml
In the response, package listings and an ErrCount value 0 confirm that the query was
successful:
Output
- 195 -
API Command Categories
<BandwidthUnits>2</BandwidthUnits>
<PopUnits>2</PopUnits>
<SQLUnits>1</SQLUnits>
<OSTypeID>1</OSTypeID>
<OSType>Windows</OSType>
<PackageCost>7.50</PackageCost>
<SellPrice>14.00</SellPrice>
</package>
<PackageCount>2</PackageCount>
</resellerpackagepricing>
<Command>CALCULATEHOSTPACKAGEPRICING</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
- 196 -
API Command Categories
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
CancelHostAccount
Description
Definition
Enable or disable a Web hosting account, or mark a Web hosting account for deletion at
the end of the current billing cycle.
Usage
Use this command to enable a Web hosting account, unless it has been disabled by our
system for nonpayment or overages. In those circumstances, the Web hosting account
must be enabled by a customer service representative.
Use this command to disable a Web hosting account.
Use this command to flag a Web hosting account for deletion at the end of the billing
cycle.
Use this command to remove a deletion flag on a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l This command cannot be used to enable an account that has been disabled by our
system for nonpayment or overages. In those circumstances, the Web hosting
account must be enabled by a customer service representative.
Input parameters
Build the query string using this syntax:
- 197 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 198 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l If a Web hosting account has been disabled, then the GetHostAccount commands
and other commands will return an error: Host account has been disabled. Please
contact customer service.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query leaves Web hosting account B1027 enabled (Enable=1), flags it for
deletion at the end of the current billing cycle (Delete=1), and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CANCELHOSTACCOUNTuid=resellid
&pw=resellpw&hostaccount=B1027&Enable=1&Delete=1
&responsetype=xml
- 199 -
API Command Categories
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l CreateHostAccount
l GetAllHostAccounts
l GetHostAccount
l WebHostGetResellerPackages
CancelOrder
Description
Definition
Cancel a pre-order for a specific domain name.
Usage
Use this command to cancel the order of a specific pre-registration domain name.
Availability
All resellers have access to this command.
- 200 -
API Command Categories
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The OrderID and Domain Name must be passed in and be valid.
Input parameters
Build the query string using this syntax:
http://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword¶mname=paramvalue
&nextparamname=nextparamvalue
- 201 -
API Command Categories
Parameter Description
Text message indicating the description as appropriate based
Description
on the action, and/or errors.
Notes
l The Domain Name must be a part of the order ID passed in, and both items must
belong to the reseller calling the API command.
Example
The following query cancels the domain abcd1234.catering from orderID 123456789,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CancelOrderuid=resellid&pw=resellpw
&hostuid=resellid&pw=resellpw&OrderID=123456789
&DomainName=abcd1234.catering&responsetype=xml
In the response, the presence of spun names and the ErrCount value 0 indicate that the
query was successful:
Output
- 202 -
API Command Categories
<Result>Success</Result>
<Domains>
<DomainName>abcd1234.catering</DomainName>
<Description>Refunded</Description>
</Domains>
</Order>
<Command>CANCELORDER</Command>
<APIType>API.NET</APIType>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.094</ExecTime>
<Done>true</Done>
<TrackingKey>dc60f425-1e6f-44de-86d8-e15390eea4e-
b</TrackingKey>
<RequestDateTime>7/2/2014 4:28:17 PM</RequestDateTime>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddToCart
l Check
l Purchase
CertChangeApproverEmail
Description
Definition
Change approver email for a Symantec, Verisign or GeoTrust certificate.
- 203 -
API Command Categories
Usage
Use this command to change approver email for a Symantec, Verisign or GeoTrust cer-
tificate.
Availability
All resellers have access to this command.
Implementation on eNom.com
N/A
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 204 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes approver email for a GeoTrust Certificate, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertChangeApproverEmail&UID=resellid
&PW=resellpw&ResponseType=XML&CertID=111
&ApproverEmail=myemail@mydomain.com
Output
- 205 -
API Command Categories
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
l CertReissueCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
- 206 -
API Command Categories
CertConfigureCert
Description
Definition
Add or update certificate information in preparation to submit to Certificate Authority.
Usage
Use this command to add or update certificate information in preparation to submit to Cer-
tificate Authority.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/ConfigureCerts.asp?CertID=289
The save changes button calls the CertConfigureCert command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 207 -
API Command Categories
- 208 -
API Command Categories
- 209 -
API Command Categories
Optional over-
allthe default
for a cert
Admin is the
Admin contact
for this
account; Given name of this ContactGiven
defaults for the name of this ContactType for this
ContactTypeFName cert Tech and cert. Permitted ContactTypes are 60
Billing contacts Admin, Tech, and Billing. For
are the cert example, AdminFName=John
Admin contact.
If you supply
information for
a ContactType,
this param is
Required
If you supply
Family name of this ContacFamily
information for
name of this ContactType for this
ContactTypeLName a ContactType, 60
cert. For example, AdminLName-
this param is
e=Doe
Required
If you supply
information for
Organization name of this
ContactTypeOrgName a ContactType, 60
ContactType for this cert
this param is
Optional
If you supply
information for
Job title of this ContactType for
ContactTypeJobTitle a ContactType, 60
this cert
this param is
Optional
- 210 -
API Command Categories
If you supply
information for
Address, line 2, of this
ContactTypeAddress2 a ContactType, 60
ContactType for this cert
this param is
Optional
If you supply
information for
City for this ContactType for this
ContactTypeCity a ContactType, 60
cert
this param is
Required
Either State or
Province is
State for this ContactType for this
ContactTypeState Required for 2
cert
each
ContactType
Either State or
Province is
Province for this ContactType for
ContactTypeProvince Required for 60
this cert
each
ContactType
If you supply
information for
Postal code for this ContactType
ContactTypePostalCode a ContactType, 16
for this cert
this param is
Required
If you supply
information for Country for this ContactType for
ContactTypeCountry a ContactType, this cert, in two-letter country code 2
this param is format
Required
- 211 -
API Command Categories
If you supply
information for
Phone extension for this this
ContactTypePhoneExt a ContactType, 8
ContactType for this cert
this param is
Optional
If you supply
information for Email address for this
ContactTypeEmailAddress a ContactType, ContactType for this cert. Use 128
this param is format Name@DomainName.com
Required
- 212 -
API Command Categories
Parameter Description
Locality Locality embedded in this CSR
Notes
l Because the required parameters for this command exceed the length limits for
many browser address bars, you should submit your HTTP request using the
post instead of get method.
l The default response format is plain text. To receive the response in HTML or XML
format, send
l ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter
l Err(ErrCount) can be presented to the client. Otherwise process the returned para-
meters as defined above.
Example
The following query configures a cert, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CERTCONFIGURECERT&uid=resellid
- 213 -
API Command Categories
&pw=resellpw&ResponseType=XML&CertID=289
&Action=Configure&WebServerType=2
&CSR=MIIDPjCCAqcCAQAwYzEYMBYGA1UEAxMPa2ltYmVybHlza
GluLnVzMQwwCgYDVQQLEwNLaW0xDDAKBgNVBAoTA0tpbTERMA
8GA1UEBxMIQmVsbGV2dWUxCzAJBgNVBAgTAldBMQswCQYDV
QQGEwJVUzCBnzANBgkqhkiG9w0BAQEFAAOBjQA
wgYkCgYEA0gTzzYfBzisSajyZsb0wXPog%2FpHl
mYZp5v7ta5LbgSQ0XbLGGXU7KYwrhFZqZ1pgboflWgYSEM%2BVwYc%2B
0AZHd5yeAZKFN08GhTQxgaV0oiK3Q1Nj4pNVsju%2B7uwiBI
9v8S6Gyowa7LF4ZKcUWdHSX6e4%2Fgcgd1N%2FdWWQmzfpKisCAwEAAa
CCAZkwGgYKKwYBBAGCNw0CAzEMFgo1LjAuMjE5NS4yMHsGCisGAQQBg
jcCAQ4xbTBrMA4GA1UdDwEB%2FwQEAwIE8DBEBgkqhkiG9w0BCQ8ENzA1
MA4GCCqGSIb3DQMCAgIAgDAOBggqhkiG9w0DBAICAIAw
BwYFKw4DAgcwCgYIKoZIhvcNAwcwEwYDVR0lBAwwCgYIKwYBBQUHA
wEwgf0GCisGAQQBgjcNAgIxge4wgesCAQEeWgBNAGkAYwByAG
8AcwBvAGYAdAAgAFIAUwBBACAAUwBDAGgAYQBuAG4AZQBsACAAQwByAH
kAcAB0AG8AZwByAGEAcABoAGkAYwAgAFAAcgBvAHYAaQBkAGUAcgOBiQAn
Uv2qmJCagvl02VUuQzY%2FpQVwxgwTVxQyJ08RQcQZ%2FE4HV5MZe7
yuGC4l8NJxSLL2HVI6Qc7wKeMJAWhg%2BFv%2BJGFoJtu7VSw1%2Bgk
bWKYI%2FTsuvyTyA5bvrO6%2Bf7N9TkBtJCMl%2F9JtfItk71MNt7hj
ZqSVGjZp5kFWbYZfPd7ONgAAAAAAAAAAMA0GCSqGSIb3DQEBBQUAA4GBAG
vhsjZbtidJL48NqJecna5A0eIwGiizlYjJibLcdN6YnR%2BM
N4BP8JmX8T2CJPnHOf2PIeXUujLhzv5bajXvHVT
y1oG%2B%2FYLc%2B3LQzSm9rQXjMEk%2F1eJXi3OAShQX%2BS2Gby-
aUitu%2BlZ%2FK8QIzxCtoKf0vNlzbB70fOjWWQqfJhVsm
&AdminOrgName=Bel+Air&AdminJobTitle=Pres&AdminFName=F
&AdminLName=Bern&AdminAddress1=516+Apple&AdminCity=Bel+Air
&AdminState=MD&AdminPostalCode=21014&AdminCountry=US
&AdminPhone=5555555555&AdminEmailAddress=
john@resellerdocs.com&TechOrgName=Bel+Air&TechJobTitle=Pres
&TechFName=F&TechLName=Bern&TechAddress1=516+Apple
&TechCity=Bel+Air&TechState=MD&TechPostalCode=21014
&TechCountry=US&TechPhone=5555555555
&TechEmailAddress=john@resellerdocs.com
&BillingOrgName=Bel+Air&BillingJobTitle=Pres&BillingFName=F
&BillingLName-
e=Bern&BillingAddress1=516+Apple&BillingCity=Bel+Air
&BillingState=MD&BillingPostalCode=21014&BillingCountry=US
&BillingPhone=5555555555
&BillingEmailAddress=john@resellerdocs.com
In the response, a success value True confirms that the query was successful:
Output
- 214 -
API Command Categories
- 215 -
API Command Categories
<Done>true</Done>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
l CertReissueCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertGetApproverEmail
Description
Definition
Retrieve the email addresses of qualified approvers for the domain name embedded in a
CSR.
Usage
Use this command to retrieve the email addresses of qualified approvers for the domain
name embedded in a CSR.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/ConfigureCerts.asp?CertID=295
- 216 -
API Command Categories
The save changes button calls the CertParseCSR command to retrieve the domain
name associated with this CSR. Then, the CertGetApproverEmail command calls the
authoritative WhoIs and retrieves the email address for the registrant of that domain.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 217 -
API Command Categories
Parameter Description
ApproverType Type of approver
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query queries the authoritative Whois database for the domain registrants
email address, generates other email addresses that are likely to be valid approvers for
the cert, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertGetApproverEmail&uid=resellid&pw=resellpw
&Domain=resellerdocs.com&ResponseType=XML
In the response, a Success status True confirms that the query was successful:
Output
<interface-response>
<CertGetApproverEMail>
- 218 -
API Command Categories
<Success>True</Success>
<Approver Type="Domain">
<Approver-
Email>kdfmxykmg@whoisprivacyprotect.com</ApproverEmail>
</Approver>
<Approver Type="Domain">
<Approver-
Email>kdfmxykmg@whoisprivacyprotect.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<ApproverEmail>admin@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<Approver-
Email>administrator@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<ApproverEmail>hostmaster@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<ApproverEmail>root@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<ApproverEmail>webmaster@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Generic">
<ApproverEmail>postmaster@resellerdocs.com</ApproverEmail>
</Approver>
<Approver Type="Manual">
</Approver>
</CertGetApproverEMail>
<Command>CERTGETAPPROVEREMAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
- 219 -
API Command Categories
<ExecTime>1.687</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 3:38:17 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertReissueCert
l CertParseCSR
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertGetCertDetail
Description
Definition
Retrieve configuration information on one SSL certificate.
Usage
Use this command to retrieve detailed configuration information on one SSL certificate.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.comsecure/configure-ssl-certificate.aspx?certid=295
- 220 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 221 -
API Command Categories
Parameter Description
WebServerTypeName Text description of the type of server this cert is configured for
Message Message
- 222 -
API Command Categories
Parameter Description
ContactTypeFax Contact fax
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves information on a cert, and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=CERTGETCERTDETAIL&uid=resellid&pw=resellpw
&CertID=288&ResponseType=XML
- 223 -
API Command Categories
In the response, cert information and an ErrCount value 0 confirm that the query was suc-
cessful:
Output
<interface-response>
<CertGetCertDetail>
<CertID>288</CertID>
<DomainName>kimberlyshin.us</DomainName>
<ValidityPeriod>12</ValidityPeriod>
<OrderDate>5/4/2005 2:21:07 PM</OrderDate>
<ConfigDate></ConfigDate>
<RenewalIndicator>False</RenewalIndicator>
<WebServerTypeID>33</WebServerTypeID>
<WebServerTypeName>Microsoft IIS 6.x or later-
</WebServerTypeName>
<OrderID>156256243</OrderID>
<OrderDetailID>1380409</OrderDetailID>
<ExpirationDate>5/4/2006 2:21:07 PM</ExpirationDate>
<ServerCount>1</ServerCount>
<ApproverEmail></ApproverEmail>
<Message></Message>
<CertStatusID>1</CertStatusID>
<CertStatus>Awaiting Configuration</CertStatus>
<CertStatusDetail></CertStatusDetail>
<ReissueStatus></ReissueStatus>
<ProdType>27</ProdType>
<ProdDesc>SSL Certificate - GeoTrust TrueBizID Wild-
card</ProdDesc>
<UseWebHosting>0</UseWebHosting>
<SSLCertificate></SSLCertificate>
<CSR>
-----BEGIN CERTIFICATE REQUEST-----
MIIDPjCCAqcCAQAwYzEYMBYGA1UEAxMPa2ltYmVy-
bHlzaGluLnVzMQwwCgYDVQQLEwNLaW0xDDAKB
gNVBAoTA0t-
pbTERMA8GA1UEBxMIQmVs-
bGV2dWUxCzAJBgNVBAgTAldBMQswCQYDVQQGEwJVUzCBnz
ANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA0gTzzYfBzisSa-
jyZsb0wXPog/pHlmYZp5v7ta5LbgSQ
0XbLGGXU7KYwrhFZqZ1p-
gboflWgYSEM+VwYc+0AZHd5yeAZKFN08GhTQxgaV0oiK3Q1Nj4pNVsju+
- 224 -
API Command Categories
owa7LF4ZKcUWdHSX6e4/gcg-
d1N/dWWQmzfpKisCAwEAAaCCAZkwGgYKKwYBBAGCN
w0CAzEMFgo1LjAuMjE5NS4yMHsGCisGAQQBgjcCAQ4xbTBrMA4GA1UdDwEB-
/wQEAwIE8DBEBgkqhk
iG9w0BCQ8ENzA1MA4GCCqGSIb3DQMCAgIAgDAOBg-
gqhkiG9w0DBAICAIAwBwYFKw4DAgcwCgYIKoZ
IhvcNAw-
cwEwYDVR0lBAwwCgYIKwYBBQUHAwEwg-
f0GCisGAQQBgjcNAgIxge4wgesCAQEeWgBNAGkA
YwByAG8AcwBvAGYAdAAgAFIAUwBBACAAUwBDAGgAYQBuAG4AZQBsACAAQwB-
yAHkAcAB0AG8AZwByA
GEAcABoAGkAYwAgAFAAcgBvAHYAaQBkAGUAcgOBiQAnUv2qmJCagvl02VUu-
QzY/pQVwxgwTVxQyJ0
8RQcQZ/E4HV5MZe7y-
uGC4l8NJxSLL2HVI6Qc7wKeMJAWhg+Fv+JGFoJtu7VSw1+gk-
bWKYI/TsuvyT
yA5b-
vrO6+f7N9TkBtJCMl/9Jt-
fItk71MNt7hjZqSVGjZp5kFWbYZfPd7ONgAAAAAAAAAAMA0GCSqG
SIb3DQEBBQUAA4GBAGvh-
sjZbtidJL48NqJecna5A0eIwGiizlYjJibLcdN6YnR+MN4BP8JmX8T2CJ
PnHOf2PIeXUujLhzv5ba-
jXvHVTy1oG+/YLc+3LQzSm9rQXjMEk/1eJXi3OAShQX+S2GbyaUitu+lZ
/K8QIzxCtoKf0vNlzbB70fOjWWQqfJhVsm
-----END CERTIFICATE REQUEST-----
</CSR>
<PVT>
-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----
</PVT>
<ReferenceID></ReferenceID>
<AdminOrgName>Bel Air</AdminOrgName>
<AdminJobTitle>Pres</AdminJobTitle>
<AdminFName>F</AdminFName>
<AdminLName>Bern</AdminLName>
<AdminAddress1>516 Apple</AdminAddress1>
<AdminAddress2></AdminAddress2>
<AdminCity>Bel Air</AdminCity>
<AdminStateProvince></AdminStateProvince>
<AdminStateProvinceChoice>S</AdminStateProvinceChoice>
<AdminPostalCode>21014</AdminPostalCode>
<AdminCountry>US</AdminCountry>
<AdminPhone>5555555555</AdminPhone>
- 225 -
API Command Categories
<AdminFax></AdminFax>
<AdminE-
mailAddress>john@resellerdocs.com</AdminEmailAddress>
<AdminPhoneExt></AdminPhoneExt>
<TechOrgName>Bel Air</TechOrgName>
<TechJobTitle>Pres</TechJobTitle>
<TechFName>F</TechFName>
<TechLName>Bern</TechLName>
<TechAddress1>516 Apple</TechAddress1>
<TechAddress2></TechAddress2>
<TechCity>Bel Air</TechCity>
<TechStateProvince></TechStateProvince>
<TechStateProvinceChoice>S</TechStateProvinceChoice>
<TechPostalCode>21014</TechPostalCode>
<TechCountry>US</TechCountry>
<TechPhone>5555555555</TechPhone>
<TechFax></TechFax>
<TechEmailAddress>john@resellerdocs.com</TechEmailAddress>
<TechPhoneExt></TechPhoneExt>
<BillingOrgName>Bel Air</BillingOrgName>
<BillingJobTitle>Pres</BillingJobTitle>
<BillingFName>F</BillingFName>
<BillingLName>Bern</BillingLName>
<BillingAddress1>516 Apple</BillingAddress1>
<BillingAddress2></BillingAddress2>
<BillingCity>Bel Air</BillingCity>
<BillingStateProvince></BillingStateProvince>
<BillingStateProvinceChoice>S</BillingStateProvinceChoice>
<BillingPostalCode>21014</BillingPostalCode>
<BillingCountry>US</BillingCountry>
<BillingPhone>5555555555</BillingPhone>
<BillingFax></BillingFax>
<BillingE-
mailAddress>john@resellerdocs.com</BillingEmailAddress>
<BillingPhoneExt></BillingPhoneExt>
<WebServerTypes>
<WebServerType>
<WebServerTypeID>22</WebServerTypeID>
<WebServerTypeName>Apache + ApacheSSL</WebServerTypeName>
<WebServerTypeCode>apacheapachessl</WebServerTypeCode>
</WebServerType>
<WebServerType>
- 226 -
API Command Categories
<WebServerTypeID>1</WebServerTypeID>
<WebServerTypeName>Apache + MOD SSL</WebServerTypeName>
<WebServerTypeCode>apachessl</WebServerTypeCode>
</WebServerType>
......
</WebServerTypes>
</CertGetCertDetail>
<Command>CERTGETCERTDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.078</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>15d0de00-b38a-49ff-932e-f589252acf45</Track-
ingKey>
<RequestDateTime>12/7/2011 3:39:54 AM</RequestDateTime>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCerts
l CertModifyOrder
l CertReissueCert
l CertParseCSR
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
- 227 -
API Command Categories
CertGetCerts
Description
Definition
Retrieve a list of the SSL certificates currently registered in this account.
Usage
Use this command to retrieve a list of the types of SSL certificates that that are currently
registered in this account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com /secure/manage-ssl-certificates.aspx
The table lists the certs currently registered in this account.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 228 -
API Command Categories
- 229 -
API Command Categories
- 230 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves all certs in a domain name account, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
com-
mand=CertGetcerts&UID=resellid&PW=resellpw&ResponseType=XML
In the response, cert information and the ErrCount value 0 confirm that the query was
successful:
Output
<interface-response>
<CertGetCerts>
<Certs>
<Cert>
<IsExpired>False</IsExpired>
<CertID>15971</CertID>
<OrderDate>11/10/2011</OrderDate>
<ConfigDate></ConfigDate>
<DomainName></DomainName>
<ValidityPeriod>12</ValidityPeriod>
<RenewalIndicator>False</RenewalIndicator>
<ProdType>23</ProdType>
<ProdDesc>SSL Certificate - RapidSSL</ProdDesc>
<ExpirationDate>11/10/2012</ExpirationDate>
<ServerCount>1</ServerCount>
<CertStatus>Awaiting Configuration</CertStatus>
- 231 -
API Command Categories
<CertStatusID>1</CertStatusID>
<OrderID>157772626</OrderID>
<ReissueStatus></ReissueStatus>
</Cert>
<Cert>
<IsExpired>False</IsExpired>
<CertID>15970</CertID>
<OrderDate>11/10/2011</OrderDate>
<ConfigDate></ConfigDate>
<DomainName>www.california.com</DomainName>
<ValidityPeriod>12</ValidityPeriod>
<RenewalIndicator>False</RenewalIndicator>
<ProdType>23</ProdType>
<ProdDesc>SSL Certificate - RapidSSL</ProdDesc>
<ExpirationDate>11/10/2012</ExpirationDate>
<ServerCount>1</ServerCount>
<CertStatus>Awaiting Configuration</CertStatus>
<CertStatusID>1</CertStatusID>
<OrderID>157772625</OrderID>
<ReissueStatus></ReissueStatus>
</Cert>
......
<ProductType>all</ProductType>
<StatusID>all</StatusID>
<StartPosition>1</StartPosition>
<PagingPageSize></PagingPageSize>
<Count>3253</Count>
<Sortby></Sortby>
<SortByDirection>desc</SortByDirection>
<TotalRecords>3253</TotalRecords>
</Certs>
</CertGetCerts>
<Command>CERTGETCERTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
- 232 -
API Command Categories
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.563</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>12/7/2011 3:42:01 AM</RequestDateTime>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertModifyOrder
l CertReissueCert
l CertParseCSR
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertModifyOrder
Description
Definition
Cancel a cert configuration order. Cancellation is permitted while a cert is in status
Approval email sent or Processing. This command does not delete the cert from a cus-
tomers account; it only cancels the configuration order. This allows a customer to
change the configuration, including the domain name with which the cert will be asso-
ciated.
Usage
Use this command to cancel a cert configuration order. A cert configuration order can
only be canceled while the cert is in status Approval email sent or Processing.
Availability
- 233 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
l The CertModifyOrder command must reach the Certification Authority before they
validate the cert.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 234 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query cancels the configuration order for a cert, and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertModifyOrder&uid=resellid
&pw=resellpw&CertID=294&ResponseType=XML
In the response, a cert ID number and an ErrCount value 0 confirms that the query was
successful:
Output
- 235 -
API Command Categories
<Command>CERTMODIFYORDER</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.109375</ExecTime>
<Done>true</Done>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertReissueCert
l CertParseCSR
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertParseCSR
Description
Definition
Parse a Certificate Signing Request (CSR) to determine the domain name and other
information associated with this cert.
Usage
- 236 -
API Command Categories
Use this command to parse a Certificate Signing Request (CSR) to determine the
domain name and other information associated with this cert.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/configure-ssl-certificate.aspx?certid=295
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 237 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query parses a CSR and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertParseCSR&uid=resellid&pw=resellpw
- 238 -
API Command Categories
&ResponseType=XML&CertID=295&CSR=CSR=%2D%2D%2D%2D%2D
BEGIN+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D%0D%0AMIIDVzCC
AsACAQAwfDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkRFMRMwEQYDV
QQH%0D%0AEwpXaWxtaW5ndG9uMRIwEAYDVQQKEwlBY21lIEluYy4xGDAWBg
NVBAsTD1NTTCBD%0D%0AZXJ0aWZpY2F0ZTEdMBsGA1UEAxMUd3d3LnJl
c2VsbGVyZG9jcy5jb20wgZ8wDQYJ%0D%0AKoZIhvcNAQEBBQADgY
0AMIGJAoGBAL0aEkBD2RkKOm82yJGy%2F
IhLRH7pYIGZCazh%0D%0ACxp731BjemXjSaVJLu0%2BoE6sIMRhV0
4X%2FJjVFgGGbswVvHT5qWZdpODe2EEBG971%0D%0ABJlUmBGEX%
2Flgkd%2BjjHbP3MnOqbkuRRYrdao2CPjB3dcv46IcjFvCl5P%2BS
EVx7Y9c%0D%0Awjk3n%2FxLAgMBAAGgggGZMBoGCisGAQQ
BgjcNAgMxDBYKNS4yLjM3OTAuMjB7Bgor%0D%0ABgEEAYI3AgEO
MW0wazAOBgNVHQ8BAf8EBAMCBPAwRAYJKoZIhvcNAQkPBDcwNTAO
%0D%0ABggqhkiG9w0DAgICAIAwDgYIKoZIhvcNAwQCAgCAMAcGBSsOAw
IHMAoGCCqGSIb3%0D%0ADQMHMBMGA1UdJQQ
MMAoGCCsGAQUFBwMBMIH9BgorBgEEAYI3DQICMYHuMIHrAgEB%0D%0AH
loATQBpAGMAcgBvAHMAbwBmAHQAIABSAFMAQQAgAFMAQwBo
AGEAbgBuAGUAbAAg%0D%0AAEMAcgB5AHAAdABvAGcAcgBhAHAAaABpAG
MAIABQAHIAbwB2AGkAZABlAHIDgYkA%0D%0AAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>A%0D%0AA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA%0D%0AAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADANBgkqhkiG
%0D%0A9w0B9w0BAQUFAAOBgQCfN86YfjwTGCMj84DFkvQBPX0zQ881
5bgqaZSNHQRYl67Gj4A%2B%0D%0Awmg3O18lX0NwBt%2BT
%2F57OaJS4HB6x6JvAo96N%2B1vX%2F
%2BiG2thcu1PqTb%2Fu%2BmUbapaa%0D%0Ackas6Ubbe2MVHKRz7o
0ZNfIKUrRBdCRtZBEVxz1ZrPMqRHVo1oq5N17SEA%3D%3D%0D%0A%2D%2D
%2D%2D%2DEND+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D
In the response, parsed information and an ErrCount value 0 confirm that the query was
successful:
Output
- 239 -
API Command Categories
<Country>US</Country>
</CertParseCSR>
<Command>CERTPARSECSR</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.578125</ExecTime>
<Done>true</Done>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertReissueCert
l CertModifyOrder
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertPurchaseCert
Description
Definition
Send a cert configuration to its Certification Authority for final approval and issuance of
the cert.
Usage
- 240 -
API Command Categories
Once you have confirmed that all configuration information is correct, use this command
to send the configurationto the Certification Authority for final approval and issuance of
the cert.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/configure-approval-email.aspx?CertID=295
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 241 -
API Command Categories
Required for all Unit within the organization that will use
CSROrganizationUnit 64
Comodo certs this cert
- 242 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sends information to the Certification Authority for final validation of
the cert, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertPurchaseCert&uid=resellid&pw=resellpw
&ApproverEmail=johndoe@resellerdocs.com&CertID=295
&CSRAddress1=111+Main&CSRLocality=Wilmington
&CSRStateProvince=DE&CSRPostalCode=00123
&ResponseType=XML
In the response, an ErrCount value 0 confirms that the query was successful:
Output
- 243 -
API Command Categories
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertReissueCert
l CertModifyOrder
l CertParseCSR
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertReissueCert
Description
Definition
Reissue an existing Symantec, Verisign or GeoTrust certificate.
- 244 -
API Command Categories
Usage
Use this command to reissue an existing Symantec, Verisign or GeoTrust certificate.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/configure-ssl-certificate.aspx?certid=295
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 245 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query parses a CSR and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertReissueCert&uid=resellid&pw=resellpw
- 246 -
API Command Categories
&ResponseType=XML&CertID=111&CSR=%2D%2D%2D%2D%2D
BEGIN+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D%0D%0AMI
IDVzCCAsACAQAwfDELMAkGA1UEBhMCVVMxCzAJBgNVBA
gTAkRFMRMwEQYDVQQH%0D%0AEwpXaWxtaW5ndG9uMRIw
EAYDVQQKEwlBY21lIEluYy4xGDAWBgNVBAsTD1NTTCBD%
0D%0AZXJ0aWZpY2F0ZTEdMBsGA1UEAxMUd3d3LnJlc2Vs
bGVyZG9jcy5jb20wgZ8wDQYJ%0D%0AKoZIhvcNAQEBBQA
DgY0AMIGJAoGBAL0aEkBD2RkKOm82yJGy%2FIhLRH7pYIG
ZCazh%0D%0ACxp731BjemXjSaVJLu0%2BoE6sI
MRhV04X%2FJjVFgGGbswVvHT5qWZdpODe2EEBG9
71%0D%0ABJlUmBGEX%2Flgkd%2BjjHbP3MnOqbkuRRYrd
ao2CPjB3dcv46IcjFvCl5P%2BSEVx7Y9c
%0D%0Awjk3n%2FxLAgMBAAGgggGZMBoGCisGAQQBgjc
NAgMxDBYKNS4yLjM3OTAuMjB7Bgor%0D%0ABgEEAYI3Ag
EOMW0wazAOBgNVHQ8BAf8EBAMCBPAwRAYJKoZIhvcNA
QkPBDcwNTAO%0D%0ABggqhkiG9w0DAgICAIAwDgYIKoZ
IhvcNAwQCAgCAMAcGBSsOAwIHMAoGCCqGSIb3%0D%0AD
QMHMBMGA1UdJQQMMAoGCCsGAQUFBwMBMIH9BgorBgEEA
YI3DQICMYHuMIHrAgEB%0D%0AHloATQBpAGMAcgBvAHMA
bwBmAHQAIABSAFMAQQAgAFMAQwBoAGEAbgBuAGUAbAAg
%0D%0AAEMAcgB5AHAAdABvAGcAcgBhAHAAaABpAGMAIAB
QAHIAbwB2AGkAZABlAHIDgYkA%0D%0AAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAA>A%0D%0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA%0D%0AAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
DANBgkqhkiG%0D%0A9w0B9w0BAQUFAAOBgQCfN86YfjwT
GCMj84DFkvQBPX0zQ8815bgqaZSNHQRYl67Gj4A%2B%0D
%0Awmg3O18lX0NwBt%2BT%2F57OaJS4HB6x6JvAo96N
%2B1vX%2F%2BiG2thcu1PqTb%2Fu%2BmUbapaa%0D
%0Ackas6Ubbe2MVHKRz7o0ZNfIKUrRBdCRtZBEV
xz1ZrPMqRHVo1oq5N17SEA%3D%3D%0D%0A%2D%2D
%2D%2D%2DEND+NEW+CERTIFICATE+REQUEST%2D%2D
%2D%2D%2D
In the response, parsed information and an ErrCount value 0 confirm that the query was
successful:
Output
- 247 -
API Command Categories
<Command>CERTREISSUECERT</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.578125</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>1/11/2012 11:18:42 AM</RequestDateTime>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
l CertResendApproverEmail
l CertResendFulfillmentEmail
l GetCerts
CertResendApproverEmail
Description
Definition
Resend approver email for a Symantec, Verisign or GeoTrust certificate.
Usage
- 248 -
API Command Categories
User this command to resend approver email for a Symantec, Verisign or GeoTrust cer-
tificate.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/secure/configure-ssl-certificate.aspx?certid=295
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 249 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes approver email for a GeoTrust Certificate, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertResendApproverEmail&UID=resellid
&PW=resellpw&ResponseType=XML&CertID=111
In the response, parsed information and an ErrCount value 0 confirm that the query was
successful:
Output
- 250 -
API Command Categories
<?xml version="1.0"?>
<interface-response>
<CertResendApproverEmail>
<ApproverEmailType>ApproverEmail</ApproverEmailType>
<Success>True</Success>
</CertResendApproverEmail>
<Command>CERTRESENDAPPROVEREMAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.297</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>1/11/2012 11:18:42 AM</RequestDateTime>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
l CertReissueCert
l CertResendFulfillmentEmail
l GetCerts
- 251 -
API Command Categories
CertResendFulfillmentEmail
Description
Definition
Resend fulfillment email (final cert) for a Symantec, Verisign or GeoTrust certificate.
Usage
Use this command to resend fulfillment email (final cert) for a Symantec, Verisign or
GeoTrust certificate.
Availability
All resellers have access to this command.
Implementation on eNom.com
N/A
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The cert must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 252 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes approver email for a GeoTrust Certificate, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CertResendFulfillmentEmail&UID=resellid
- 253 -
API Command Categories
&PW=resellpw&ResponseType=XML&CertID=111
In the response, parsed information and an ErrCount value 0 confirm that the query was
successful:
Output
<?xml version="1.0"?>
<interface-response>
<CertResendFulfillmentEmail>
<Success>True</Success>
</CertResendFulfillmentEmail>
<Command>CERTRESENDFULFILLMENTEMAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>blvdt112</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.967</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>3/1/2012 11:29:08 AM</RequestDateTime>
</interface-response>
Related commands
l CertChangeApproverEmail
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
l CertReissueCert
- 254 -
API Command Categories
l CertResendApproverEmail
l GetCerts
Check
Description
Definition
Check the availability of a domain name.
Usage
Use this command to check whether a domain name is already registered.
Availability
The Check command is available to every reseller.
Implementation on eNom.com
http://www.enom.com/
When you type a domain name in the Register A Domain boxes, the GO or Search but-
tons call the Check command.
Constraints
Domain names must meet the following requirements:
l Second-level domain (SLD) must be composed of the letters a through z, the num-
bers 0 through 9, and the hyphen (-) character.
l Some foreign character sets can display onscreen, but resolve to alphanumeric
plus hyphen characters in the underlying code.
l The SLD must not begin or end with the hyphen character.
l The SLD must not contain spaces.
l The SLD must not contain special characters other than the hyphen character.
l The third and fourth characters of the SLD must not both be hyphens unless it is an
encoded international-character domain name.
l The SLD must contain 2 to 63 characters, inclusive.
l SLDs are not case sensitive.
l The SLD-TLD combination must be unique.
- 255 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
Command=Check&UID=YourLogin&PW=YourPassword
&SLD=DesiredSLD&TLD=DesiredTLD&OptParam1=ParamValue1
&OptParam2=ParamValue2
Required unless
Second-level domain name (for example,
SLD DomainList is used 63
enom in enom.com)
- 256 -
API Command Categories
Parameter Description
Registry.
PremiumPrice Registration price per year for this premium name, in $US.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l When parsing the response, use the RRPCode value rather than the RRPText
value or the position in the response. Of these, only the RRPCode value is guar-
anteed by the Registry to be stable.
Example
The following checks whether the domain name unusualTVname.tv is available and
sends the response in XML format:
Query
- 257 -
API Command Categories
https://resellertest.enom.com/interface.asp?
com-
mand-
d=check&sld=unusualTVname&tld=tv&uid=resellid&pw=resellpw
&responsetype=xml
<interface-response>
<DomainName>unusualtvname.tv</DomainName>
<RRPCode>211</RRPCode>
<RRPText>Domain not available</RRPText>
<Command>CHECK</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.235</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:11:54 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddBulkDomains
l InsertNewOrder
l NameSpinner
l Purchase
- 258 -
API Command Categories
CheckLogin
Description
Definition
Validate user login for a domain name.
Usage
Use this command when you want to validate a users identity.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://www.enom.com/Login.asp?page=%2Fmyaccount%2FDefault%2Easp%3F
Clicking the log-in button calls the CheckLogin command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
Command=CheckLogin&UID=YourLogin&PW=YourPassword
- 259 -
API Command Categories
SiteType Site
HelpEmailAddress Email address for the Billing contact for this account
- 260 -
API Command Categories
Parameter Description
ClubDropExpired Is this Club Drop membership expired
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 261 -
API Command Categories
Example
The following query requests the party ID and reseller status of account resellid, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=checklogin&uid=resellid&pw=resellpw
&responsetype=xml
<interface-response>
<PartyID>{BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629}</PartyID>
<Reseller>True</Reseller>
<ParentAccount>000-00-0000</ParentAccount>
<IsETP>1</IsETP>
<SEOPartner>NA</SEOPartner>
<BulkMembershipType>None</BulkMembershipType>
<BulkMembership>False</BulkMembership>
<BulkMembershipStatus/>
<bBulkMembershipStatus>0</bBulkMembershipStatus>
<VerifiedBidder>False</VerifiedBidder>
<RSA>False</RSA>
<SiteType>E</SiteType>
<HelpE-
mailAddress>john.doe@resellerdocs.com</HelpEmailAddress>
<AgreementStatus>
<Agreement>
<Type>1</Type>
<Description>ResellerAgreement</Description>
<Category>ResellerAgreement</Category>
<RemoteURL/>
<LatestVersion>2.5</LatestVersion>
<Agreed>1</Agreed>
<CurrentCompliance>1</CurrentCompliance>
<AgreementNote/>
</Agreement>
<Agreement>
<Type>2</Type>
- 262 -
API Command Categories
- 263 -
API Command Categories
<Agreement>
<Type>6</Type>
<Description>RegistrationAgreement</Description>
<Category>RegistrationAgreement</Category>
<RemoteURL/>
<LatestVersion>2.0</LatestVersion>
<Agreed>1</Agreed>
<CurrentCompliance>1</CurrentCompliance>
<AgreementNote/>
</Agreement>
<Agreement>
<Type>7</Type>
<Description>BulkRegister temp</Description>
<Category>Admin</Category>
<RemoteURL/>
<LatestVersion>1.0</LatestVersion>
<Agreed>0</Agreed>
<CurrentCompliance>1</CurrentCompliance>
<AgreementNote/>
</Agreement>
</AgreementStatus>
<AgreementCount/>
<Account>217-no-0647</Account>
<IsETP>1</IsETP>
<SecurePackageEnabled>False</SecurePackageEnabled>
<ForceAddedSecurity>False</ForceAddedSecurity>
<SecureLockToken/>
<FailureCount>0</FailureCount>
<SecureLockReturnMessage/>
<ExtraCheck>False</ExtraCheck>
<ViewAgreement>False</ViewAgreement>
<ClubDrop>True</ClubDrop>
<ClubDropExpired>False</ClubDropExpired>
<CartItems>3</CartItems>
<PdqAccountId>1000186</PdqAccountId>
<RSFAccountStatus>New</RSFAccountStatus>
<RSFExpDate>7/12/2012</RSFExpDate>
<IsBadEmail>False</IsBadEmail>
<Command>CHECKLOGIN</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
- 264 -
API Command Categories
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.608</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:15:00 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l UpdateAccountInfo
l UpdateCusPreferences
CheckNSStatus
Description
Definition
Retrieve information about a name server:
l If the name server exists and is registered using our credential, this command
returns status information.
l If a name server does not exist, this command informs you of that fact.
- 265 -
API Command Categories
lIf a name server exists but is outside our credential, this command informs you of
that fact.
Usage
Use this command when you want status information about a name server, or want to
determine whether a name server exists, or is outside our credential.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l To retrieve status information, the name server must exist and must be registered
under our credential.
l The query must call the name server in a valid format (by its use name, not its IP
address).
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 266 -
API Command Categories
Other parameters will be returned, and will vary from one name
Other parameters
server to another
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter Check the return parameter Err(ErrCount) can be
presented to the client. Otherwise process the returned parameters as defined
above.
Example
The following query requests the status of name server ns1.name-services.com, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=checknsstatus&e.asp?command=checknsstatus
&uid=resellid&pw=resellpw&checknsname=
ns1.name-services.com&responsetype=xml
The NsCheckStatus value of 1 indicates that the name server was found:
Output
- 267 -
API Command Categories
<interface-response>
<NsCheckSuccess>1</NsCheckSuccess>
<CheckNsStatus>
<name>ns2.budip.com</name>
<attrib-id>5693446_HOST_CNE-VRSN</attrib-id>
<ipaddress>12.123.225.3</ipaddress>
<attrib-upid>rccbatch</attrib-upid>
<attrib-clid>024</attrib-clid>
<attrib-crid>rccbatch</attrib-crid>
<status>
<status>ok</status>
<status>linked</status>
</status>
<attrib-update>2005-02-02T17:38:04.0000Z</attrib-update>
<attrib-crdate>2005-02-02T17:38:04.0000Z</attrib-crdate>
</CheckNsStatus>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully</RRPText>
<Command>CHECKNSSTATUS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELL01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.609</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:40:34 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeleteNameServer
l GetDNS
l GetDNSStatus
l ModifyNS
l ModifyNSHosting
- 268 -
API Command Categories
l RegisterNameServer
l UpdateNameServer
CommissionAccount
Description
Definition
Returns the current commission balance for an account.
Usage
Use this command to return the current commission balances for an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/resellers/SubAccount.asp
On the subaccount page, the Access link calls the CommissionAccount command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 269 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the total and available commission balances for account
resellid, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=commissionaccount&uid=resellid
&pw=resellpw&responsetype=xml
- 270 -
API Command Categories
Output
<interface-response>
<CommissionAccount>
<PayInfoSaved>False</PayInfoSaved>
<Action/>
<data-errors>
</data-errors>
<CommissionBalance>172.41</CommissionBalance>
<AvailComBalance>172.41</AvailComBalance>
<HoldPeriod>90</HoldPeriod>
<AccountingInfo>
<OrgType/>
<OrgDesc/>
<TaxID/>
<PayableTo>Johnny Doety</PayableTo>
<Address1>15801 NE 24th Street</Address1>
<Address2/>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>98008</PostalCode>
<Country>US</Country>
<Phone>+1.4252744500</Phone>
<Fax/>
<Updatable>1</Updatable>
</AccountingInfo>
</CommissionAccount>
<Command>COMMISSIONACCOUNT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.654</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:53:52 AM</RequestDateTime>
<debug></debug>
- 271 -
API Command Categories
</interface-response>
Related commands
l GetBalance
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
Contacts
Description
Definition
Update contact information for a domain name.
Usage
Use this command to set or change contact information for a domain.
If you want to update one contact type and leave the others as is, use this command with
the ContactType parameter.
When you create contacts for .eu and .be domain names, we recommend that you
always provide Registrant contact information that is separate from Billing contact inform-
ation; dont use the "same as Billing" default. Tip: If the Billing and Registrant contact
information are the same, we recommend changing the use or spelling of abbreviations
in the street address to help our system recognize that it needs to create multiple con-
tacts. Separating the Registrant and Billing information makes it easier to update Regis-
trant contact information in the future.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 272 -
API Command Categories
https://resellertest.enom.com/domains/control-pan-
el/default.asp?DomainNameID=152533676
On the edit contact info page, typing information in the text boxes provides the parameter
values for the Contacts command.
Constraints
The query must meet the following requirements:
l The domain must exist in the account that is modifying it.
l Some country code TLDs require extended attributes (parameters that are specific
to the country code). To find out whether a country code TLD requires extended
parameters and what they are, run GetExtAttributes on the country code.
l The BILLING contact type cannot be updated with this command. To update billing
information, use UpdateAccountInfo.
l If you use the ContactType parameter, you can reset only one contact type.
l If you use the ContactType parameter, the contact type of the other parameters
must match it (for example, if you set ContactType=AUXBILLING, you must use
parameters
l AuxBillingOrganizationName, AuxBillingFirstName, and so on.
l If you dont use the ContactType parameter and dont supply new information for
all contacts, those that you dont supply will be empty in the database and will use
our defaults in interfaces.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword¶mname=paramvalue
&nextparamname=nextparamvalue
- 273 -
API Command Categories
- 274 -
API Command Categories
Done True indicates this entire response has reached you suc-
- 275 -
API Command Categories
Parameter Description
cessfully.
Notes
l The BILLING contact type cannot be updated with this command. To update billing
information, use UpdateAccountInfo.
l You can submit multiple contact data in a single request by omitting the
ContactType parameter and sending additional contact data by replacing Regis-
trant in the above optional parameters with the ContactTypes AUXBILLING,
TECH, or ADMIN.
l If you use the ContactType parameter, you can reset only one contact type.
l If you use the ContactType parameter, the contact type of the other parameters
must match it (for example, if you set ContactType=AUXBILLING, you must use
parameters AuxBillingOrganizationName, AuxBillingFirstName, and so on).
l If you dont use the ContactType parameter and dont supply new information for
all contacts, those that you dont supply will be empty in the database and will use
our defaults in interfaces.
l AUXBILLING masks the true billing contact in WhoIs output.
l Some country code TLDs require extended attributes (parameters that are specific
to the country code). To find out whether a country code TLD requires extended
parameters and what they are, run GetExtAttributes on the country code.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query provides new technical contact information for resellerdocs.com and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=contacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ContactType=Tech
&TechFirstName=John&TechLastName=Smith&TechPhone=
+1.5555555555&TechAddress1=100%20Main%20St.&TechCity=
- 276 -
API Command Categories
Townsville&TechCountry=USA
&TechEmailAddress=john@resellerdocs.com&responsetype=xml
The error count of 0 in the response confirms that the query was successful:
Output
<interface-response>
<Command>CONTACTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.156</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>fc1114b9-1773-4714-ae3a-db3a882f7c-
ab</TrackingKey>
<RequestDateTime>12/7/2011 4:56:54 AM</RequestDateTime>
</interface-response>
Related commands
l AddContact
l GetAddressBook
l GetContacts
l GetExtAttributes
l GetServiceContact
l GetWhoisContact
l Preconfigure
- 277 -
API Command Categories
CreateAccount
Description
Definition
Create a new subaccount.
Usage
Use this command to create a new retail subaccount.
CreateAccount differs from CreateSubAccount in that CreateAccount offers credit card
processing.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
https://resellertest.enom.com/NewAccount.asp?page=
At the bottom of the information form, the submit button calls the CreateAccount com-
mand.
Constraints
The query must meet the following requirements:
l Parameter values submitted in the query must pass validation tests.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 278 -
API Command Categories
- 279 -
API Command Categories
- 280 -
API Command Categories
- 281 -
API Command Categories
Parameter Description
Email address that we use when contacting account owner
EmailAddress_Contact
about this account
Code we use to log the user into the new subaccount imme-
sLoginPass
diately.
- 282 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l If there are errors validating the data passed in, the same parameters and values
are returned to rebuild the form.
Example
The following query creates subaccount ichiro, and requests the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=CreateAccount&uid=resellid&pw=resellpw
&NewUID=ichiro&NewPW=ichiropw&ConfirmPW=ichiropw
&RegistrantOrganizationName=Reseller%20Documents
%20Inc.&RegistrantFirstName=John&RegistrantLastName=Doe
&RegistrantJobTitle=First%20Baseman&RegistrantAddress1=
111%20Main%20St.&RegistrantCity=Hometown
&RegistrantPostalCode=99999&RegistrantCountry=United+States
&RegistrantEmailAddress=john%2Edoe%40resellerdocs%2Ecom
&RegistrantPhone=+1.5555555555
&RegistrantFax=+1.5555555556&AuthQuestionType=smaiden
&AuthQuestionAnswer=jones&Reseller=0&CardType=visa
&CCName=test1&ResponseType=XML
- 283 -
API Command Categories
The response confirms the successful creation of the subaccount and returns sub-
account information:
Output
<interface-response>
<NewAccount>
<OrganizationName>Reseller Documents Inc.</Or-
ganizationName>
<Fname>John</Fname>
<Lname>Doe</Lname>
<JobTitle>First Baseman</JobTitle>
<Address1>111 Main St.</Address1>
<Address2/>
<City>Hometown</City>
<StateProvince/>
<StateProvinceChoice/>
<PostalCode>99999</PostalCode>
<Country>US</Country>
<Phone>+1.5555555555</Phone>
<PhoneExt/>
<Fax>+1.5555555556</Fax>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<EmailAddress_Contact/>
<EmailInfo/>
<GetCustomerPaymentInfo>
<CCType>visa</CCType>
<CCName>test1</CCName>
<CCNumber/>
<CCMonth/>
<CCYear/>
<CCAddress/>
<CCCity/>
<CCStateProvince/>
<CCZip/>
<CCCountry/>
<CCPhone/>
</GetCustomerPaymentInfo>
<GetAccountInfo>
<Reseller>0</Reseller>
<NewUID>ichiro</NewUID>
<NewPW>ichiropw</NewPW>
<ConfirmPW>ichiropw</ConfirmPW>
- 284 -
API Command Categories
<AuthQuestionType>smaiden</AuthQuestionType>
<AuthQuestionAnswer>jones</AuthQuestionAnswer>
</GetAccountInfo>
<GetCustomerPreferences>
<DefPeriod/>
</GetCustomerPreferences>
<StatusCustomerInfo>Successful</StatusCustomerInfo>
<PartyID>{779CA342-D320-E111-A3F0-005056BC7747}</PartyID>
<Account>599-nj-0803</Account>
<sLoginPass>7A1218131209144A4948401218131209140B0C404A49544
C54494B4A4A5B4F414E42414A4F5B3A36</sLoginPass>
</NewAccount>
<Command>CREATEACCOUNT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>1.313</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:59:14 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckLogin
l CreateSubAccount
l DeleteSubaccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
- 285 -
API Command Categories
l GetTransHistory
l SubAccountDomains
l UpdateAccountInfo
l UpdateCusPreferences
CreateHostAccount
Description
Definition
Create a Web hosting account.
Usage
Use this command to establish an account for Web hosting.
This command automatically deducts the cost of this Web hosting account from the
domain name account balance, and the monthly fees for Web hosting are also deducted
from the account balance. This command does not accommodate our credit card pro-
cessing services.
NOTE: If you do your own billing, you should scan all Web hosting accounts on a
monthly basis to confirm that your billing reflects any upgrades customers have chosen.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingconfig.asp
On the configure a package page, the add to cart button behaves similarly to the
CreateHostAccount command.
Constraints
The query must meet the following requirements:
l The domain account login ID and password must be valid.
l The domain account must be a reseller account.
l The name for the Web hosting account must contain 6 to 14 characters. The first
character must be alphabetic; the remaining characters must be alphanumeric.
- 286 -
API Command Categories
l The password for the Web hosting account must contain 6 to 14 alphanumeric char-
acters.
l When you associate a domain name with this account, it must either be registered
with us or the host records must point to our servers (web1.ehost-services.com).
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 287 -
API Command Categories
Optional, but to
reduce the pos-
sibility of fraud we IP address of the computer from which
EndUserIP recommend that the order is being placed, for tracking pur- 15
you require this poses
information from
customers
- 288 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a Web hosting account WebHostTest in account resellid
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=CREATEHOSTACCOUNT&uid=resellid
&pw=resellpw&hostaccount=resellwebid
&HostPassword=resellwebpw&FullName=John%20Doe
&HostAccountEmail=john%2edoe%40resellerdocs%2ecom
&package=Silver&OverageOption=1&EndUserIP=127.0.0.1
&sld=resellerdocs&tld=com&responsetype=xml
- 289 -
API Command Categories
<PackageID>10000053</PackageID>
<ServerIP>127.0.0.1</ServerIP>
<Successful>True</Successful>
</CreateHost>
<Command>CREATEHOSTACCOUNT</Command>
<ErrCount>0</ErrCount>
<Server>TEST1</Server>
<Site>enom</Site>
<IsLockable>0</IsLockable>
<IsRealTimeTLD>0</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l GetAllHostAccounts
l GetHostAccount
l WebHostGetResellerPackages
CreateSubAccount
Description
Definition
Create a subaccount.
Usage
Use this command to create a new retail subaccount.
Resellers can also create subaccounts to help organize their business.
CreateSubAccount differs from CreateAccount in that CreateAccount offers credit card
processing;
CreateSubAccount does not.
Availability
All resellers have access to this command.
- 290 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://www.enom.com/resellers/NewSubAccount.asp?
The submit button calls the CreateSubAccount command.
Constraints
The query must meet the following requirements:
l The account must have reseller status in eNoms database.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 291 -
API Command Categories
- 292 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a new subaccount, resellsub4, and requests the response in
XML format:
Query
- 293 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=CreateSubAccount&uid=resellid&pw=resellpw
&newuid=resellsub4&newpw=resellsub4&confirmpw=resellsub4
&RegistrantOrganizationName=Reseller%20Documents%20Inc.
&RegistrantFirstName=john&RegistrantLastName=doe
&RegistrantAddress1=111%20Main%20St.&RegistrantCity=
Hometown&RegistrantStateProvince=WA
&RegistrantStateProvinceChoice=S&RegistrantPostalCode=
98003&RegistrantCountry=United+States
&RegistrantEmailAddress=john%2Edoe%40resellerdocs
%2Ecom&RegistrantPhone=+1.5555555555
&RegistrantFax=+1.5555555556&AuthQuestionType=smaiden
&AuthQuestionAnswer=jones&ResponseType=XML
Related commands
l CheckLogin
l CreateAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
- 294 -
API Command Categories
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l SubAccountDomains
l UpdateAccountInfo
l UpdateCusPreferences
DeleteAllPOPPaks
Description
Definition
Delete all POP3 email paks in a domain.
Usage
Use this command to delete all POP3 paks from a domain. Note that if you delete the
POP paks, the only way to replace them is to buy new paks.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l All POP paks in the domain must have no user emails configured. You can use the
DeletePOP3 command to remove user email accounts.
Input parameters
Build the query string using this syntax:
- 295 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Use the DeletePOP3 command to delete any email user accounts before running
DeleteAllPOPPaks.
- 296 -
API Command Categories
Example
The following query deletes all POP3 10-paks from resellerdocs.com and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DeleteAllPOPPaks&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
In the response, the error count 0 confirms that the command executed successfully:
Output
<interface-response>
<PaksRemoved>35</PaksRemoved>
<Command>DELETEALLPOPPAKS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>2.908</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 5:07:14 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetForwarding
l GetMailHosts
l GetPOP3
- 297 -
API Command Categories
l ModifyPOP3
l PurchasePOPBundle
l SetUpPOP3User
DeleteContact
Description
Definition
Delete a contact from the address book.
Usage
Use this command to delete a contact from a domain name accounts address book.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Only contacts added with the AddContact command can be deleted.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 298 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes a contact from a domain accounts address book, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DELETECONTACT&uid=resellid&pw=resellpw
- 299 -
API Command Categories
®istrantpartyid={4545A013-B40A-4D50-A15A-5D4356723794}
&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l AddContact
l GetAddressBook
l GetContacts
l GetSubAccounts
DeleteCustomerDefinedData
Description
Definition
Delete customer-defined data records.
- 300 -
API Command Categories
Usage
Use this command to delete customer-defined data.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Required If Type=2
TLD Top-level domain name (extension) 15
- 301 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes the customer-defined data labeled FavoriteCuisine from
account resellid, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deletecustomerdefineddata&uid=resellid
- 302 -
API Command Categories
&pw=resellpw&ObjectID=1&Type=1&Key=FavoriteCuisine
&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
<?xml version="1.0" ?>
<interface-response>
<Command>DELETECUSTOMERDEFINEDDATA</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l GetCustomerDefinedData
l SetCustomerDefinedData
DeleteDomainFolder
Description
Definition
Delete a folder.
Usage
Use this command to delete one domain name folder.
This command does not delete domains; only the folder.
- 303 -
API Command Categories
When you delete a folder, the domains that were in it keep the settings assigned by the
folder until you change them.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Manager.aspx?tab=folder
In the list of folders, the delete link calls the DeleteDomainFolder command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The folder must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 304 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes a domain folder, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DeleteDOMAINFOLDER&uid=resellid&pw=resellpw
&FolderName=Favorites%202&ResponseType=XML
<interface-response>
- 305 -
API Command Categories
<DeleteResult>
<FolderName>Favorites 2</FolderName>
<Result>1</Result>
</DeleteResult>
<Command>DELETEDOMAINFOLDER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.469</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>50ab0431-8c68-4d63-b47b-a7b27b-
c56b54</TrackingKey>
<RequestDateTime>12/7/2011 5:25:53 AM</RequestDateTime>
</interface-response>
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l AssignToDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l RemoveUnsyncedDomains
l UpdateDomainFolder
DeleteDomainHeader
Description
Definition
- 306 -
API Command Categories
Delete a domain header (a pointer that associates a domain with a specific location in
your directory structure) from a Web hosting account.
Usage
Use this command to delete a domain header from a Web hosting account. When the
domain header is deleted, the domain name no longer resolves.
Note that when you delete a domain header, any host headers associated with that
domain header are also deleted.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/wsg/hostingdomains.asp?HostAccount=resellwebid
In the Delete column, the delete links call the DeleteDomainHeader command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 307 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 308 -
API Command Categories
Example
The following query deletes the domain header for domain testsld3.biz from Web hosting
account test20030903, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deletedomainheader&uid=resellid&pw=resellpw
&hostaccount=test20030903&sld=testsld3&tld=biz
&responsetype=xml
Related commands
l AddDomainHeader
l DeleteDomainHeader
l ListDomainHeaders
l ModifyDomainHeader
l WebHostCreateDirectory
- 309 -
API Command Categories
DeleteFromCart
Description
Definition
Delete an item or all items from the shopping cart.
Usage
Use this command when you want to remove one or all items from the shopping cart.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/Cart.asp
The delete button behaves similarly to the DeleteFromCart command.
Constraints
The query must meet the following requirements:
l The shopping cart must contain one or more items.
l One or all items in the shopping cart must be deleted.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 310 -
API Command Categories
Either Either
ItemNumber or Use EmptyCart=On to completely empty
EmptyCart 2
EmptyCart is the shopping cart.
Required
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that item 365485 be deleted from the shopping cart, and
requests the response in XML format:
- 311 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=DeleteFromCart&uid=resellid&pw=resellpw
&ItemNumber=365485&ResponseType=XML
The response confirms the successful deletion from the shopping cart:
Output
Related commands
l AddBulkDomains
l AddToCart
l GetCartContent
l InsertNewOrder
l PurchasePreview
l UpdateCart
- 312 -
API Command Categories
DeleteHostedDomain
Description
Definition
Discontinue our DNS hosting of a domain name.
Usage
Use this command to cancel our DNS hosting of a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must be hosted by this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 313 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query discontinues our DNS hosting of ExternalHostedDomain.com, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DeleteHostedDomain&uid=resellid&pw=resellpw
- 314 -
API Command Categories
&sld=ExternalHostedDomain&tld=com&responsetype=xml
In the response, the OldRegistrationStatus value Hosted and the ErrCount value 0 indic-
ate that the query was successful:
Output
Related commands
l ExtendDomainDNS
l PurchaseHosting
- 315 -
API Command Categories
DeleteHostHeader
Description
Definition
Remove a host header (pointer to a third-level domain name) from your Web hosting
account.
Usage
Use this command to remove a host header from your Web hosting account. This com-
mand would commonly beused to disable a third-level domain name (host name).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/hostingdomains.asp
In the Manage column, the delete links call the DeleteHostHeader command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The domain name must use our name servers.
l The domain header must exist.
l The host header must exist.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 316 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 317 -
API Command Categories
Example
The following query deletes host header accountspayable from domain header reseller-
docs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deletehostheader&uid=resellid&pw=resellpw
&hostaccount=resellwebid&sld=resellerdocs&tld=com
&HostName=accountspayable&responsetype=xml
In the response, the error count 0 indicates that the query was successful:
Output
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DeleteDomainHeader
l GetAllHostAccounts
l GetDomainHeader
l GetHostAccount
l GetHostHeader
l ListDomainHeaders
- 318 -
API Command Categories
l ListHostHeaders
l ModifyHostHeader
DeleteNameServer
Description
Definition
Delete a name server at the Registry.
Usage
Use this command to delete a name server at the Registry. This command does not
affect the name servers listed for any individual domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/domains/RegNameServer.asp
In the Delete a Name Server box, the submit button calls the DeleteNameServer com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name server must be registered.
l The domain name this DNS uses must belong to this account.
l The domain name server must have no domains using it.
l All registrar locks and Registry holds must be off, and the domain must be in an act-
ive state.
Input parameters
Build the query string using this syntax:
- 319 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
- 320 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes the name server registration for dns3.resellerdocs.com at
the Registry, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deletenameserver&uid=resellid&pw=resellpw
&ns=dns3.resellerdocs.com&responsetype=xml
In the response, the NsSuccess value 1, the RRPCode 200, and the RRPText Com-
mand completed successfully confirm that the query was successful:
Output
- 321 -
API Command Categories
Related commands
l CheckNSStatus
l GetDNS
l GetDNSStatus
l ModifyNS
l ModifyNSHosting
l RegisterNameServer
l UpdateNameServer
DeletePOP3
Description
Definition
Delete an individual POP3 user name from the database.
Usage
Use this command to delete an individual POP3 email user name. Once you delete it,
you can fill that vacancy with another name. This command has no effect on the POP 10-
pak nor on any other user names in the account.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The user name must be listed in the POP3 list for the account.
l The user name must be in a POP pak for which the subscription is current.
Input parameters
Build the query string using this syntax:
- 322 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 323 -
API Command Categories
Example
The following query deletes the POP user james and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
com-
mand=DeletePOP3&uid=resellid&pw=resellpw&sld=resellerdocs
&tld=com&UserName1=james&responsetype=xml
In the response, the error count of 0 confirms that the POP user was deleted suc-
cessfully:
Output
<interface-response>
<AccountsDeleted>1</AccountsDeleted>
<success>True</success>
<Command>DELETEPOP3</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>ef0e27fe-c956-4f45-a1f9-da8b6b8adea5</Track-
ingKey>
<RequestDateTime>12/12/2011 3:17:09 AM</RequestDateTime>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOPPak
- 324 -
API Command Categories
l Forwarding
l GetCatchAll
l GetForwarding
l GetMailHosts
l GetPOP3
l ModifyPOP3
l PurchasePOPBundle
l SetCatchAll
l SetUpPOP3User
DeletePOPPak
Description
Definition
Delete a POP Email pak under a domain name.
Usage
Use this command to delete an entire 10-pak of POP accounts. Note that once a pak is
deleted, the only way to replace it is to purchase a new one.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The pak must have no user email accounts currently configured.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 325 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err (ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Use the DeletePOP3 command to delete any email user accounts before running
DeletePOPPak.
- 326 -
API Command Categories
Example
The following query deletes POP bundle 5733 from resellerdocs.com and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DeletePOPPak&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&BundleID=5733&ResponseType=XML
<interface-response>
<Command>DELETEPOPPAK</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.750</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>31063cc4-7994-4d96-b8bd-1ff3665d6039</Track-
ingKey>
<RequestDateTime>12/12/2011 3:25:01 AM</RequestDateTime>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l Forwarding
l GetForwarding
l GetMailHosts
- 327 -
API Command Categories
l GetPOP3
l ModifyPOP3
l PurchasePOPBundle
l SetUpPOP3User
DeleteRegistration
Description
Definition
Delete a domain name registration.
Usage
Use this command to delete a domain name registration. Fees will apply.
Availability
This command is available to resellers on our DeleteRegistration whitelist. If you wish to
have access to this command, contact your sales representative.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain name must have been purchased less than five days ago.
l The most common TLDs, including .com and .net, can be deleted. For other TLDs,
check the resellerpages on our Web site.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 328 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
- 329 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes a domain and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deleteregistration&uid=resellid&pw=resellpw
&sld=resellerdocs3&tld=info&responsetype=xml
In the response, an RRPCode value 200 confirms that the query was successful:
Output
<interface-response>response>
<deletedomain>
<domaindeleted>True</domaindeleted>
</deletedomain>
<ErrString/>
<ErrSource/>
<ErrSection>DELETEREGISTRATION</ErrSection>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully</RRPText>
<Command>DELETEREGISTRATION</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>2.75</ExecTime>
<Done>true</Done>
<debug>
[CDATA ]
- 330 -
API Command Categories
</debug>
</interface-response>
Related commands
l AddToCart
l Purchase
DeleteSubaccount
Description
Definition
Delete a subaccount.
Usage
Use this command to delete a retail or reseller subaccount.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/resellers/subaccount-list.asp
On the subaccounts page, the Delete link calls the DeleteSubaccount command with the
Action=Confirm parameter.
Click a Delete link
On the Delete Sub-account page, the delete button calls the DeleteSubaccount com-
mand with the Action=Delete parameter.
Constraints
The query must meet the following requirements:
- 331 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 332 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes the sub-account with account number 332-ep-2379 and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=deletesubaccount&uid=resellid&pw=resellpw
&account=332-ep-2379&Action=delete&responsetype=xml
In the response, the Action return parameter and the ErrCount value 0 confirm that the
query was successful:
Output
- 333 -
API Command Categories
<ExecTime>0.1523438</ExecTime>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l CreateAccount
l GetSubAccountDetails
l GetSubAccounts
DisableFolderApp
Description
Definition
Disable IIS Application functionality for a folder.
Usage
Use this command to disable execute permission for IIS Applications in the current
folder.
By default, subfolders inherit the enabled status of their parent. This remains the case
until you reset the status of a child. Once reset, the childs enabled status is no longer
inherited.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/advanced.asp?Path=/service
On the IIS Application line, the Remove link calls the DisableFolderApp command.
- 334 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 335 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query disables execute permissions for IIS Applications in folder acct, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=disablefolderapp&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=acct&responsetype=xml
In the response, the Successful value True indicates that the query was successful:
Output
- 336 -
API Command Categories
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l EnableFolderApp
l IsFolderEnabled
l WebHostCreateDirectory
DisableServices
Description
Definition
Switch off a service in an account.
Usage
Use this command to switch off a service in a domain name account.
This command does not shut down the service or cancel it at the end of the current
billing period; it merely toggles it off.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://re-
sellertest.enom.-
com/domains/ServiceSelection.asp?DomainNameID=152533676&service=wpps
When the unprotected option button is selected, the save changes button calls the Dis-
ableServices command.
- 337 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Other constraints may apply depending on the services being disabled.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 338 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query disables the ID Protect Whois privacy protection service on reseller-
docs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=DISABLESERVICES&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&service=wpps&responsetype=xml
In the response, the ServiceStatus value confirms the new status of the service:
Output
<interface-response>
<Service>wpps</Service>
<ServiceStatus>Disabled</ServiceStatus>
<Command>DISABLESERVICES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
- 339 -
API Command Categories
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.250</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 5:48:34 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l EnableServices
l GetWPPSInfo
l ServiceSelect
EnableFolderApp
Description
Definition
Enable IIS Application functionality for a folder.
Usage
Use this command to enable execute permission for IIS Applications in the current
folder.
By default, subfolders inherit the enabled status of their parent. This remains the case
until you reset the status of a child. Once reset, the childs status is no longer inherited.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/advanced.asp?Path=/delivery
In the IIS Application line, the Create link calls the EnableFolderApp command.
- 340 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
l The folder must already exist (this command does not create it).
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 341 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
Err(x)
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query makes folder acct executable and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=enablefolderapp&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=/acct&responsetype=xml
In the response, the Successful value True indicates that the query was successful:
Output
- 342 -
API Command Categories
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l IsFolderEnabled
l WebHostCreateDirectory
EnableServices
Description
Definition
Switch on a service in a domain name account.
Usage
Use this command to switch on a service in a domain name account.
This command does not give this account access to the service or subscribe to the ser-
vice. Rather, it toggles on a service that the account has already subscribed to but has
toggled off.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/ServiceSelection.asp?
DomainNameID=152533676&service=wpps
When the protected option button is selected, the save changes button calls the
EnableServices command.
- 343 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Other constraints may apply depending on the services being enabled.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 344 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query enables the ID Protect Whois privacy protection service on reseller-
docs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=ENABLESERVICES&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&service=wpps&responsetype=xml
In the response, the ServiceStatus value confirms the new status of the service:
Output
<interface-response>
<Service>wpps</Service>
<ServiceStatus>Enabled</ServiceStatus>
<Command>ENABLESERVICES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
- 345 -
API Command Categories
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.156</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 5:50:30 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddToCart
l DisableServices
l GetWPPSInfo
l PurchaseServices
l ServiceSelect
l SetRenew
l SetResellerServicesPricing
l UpdateAccountPricing
Extend
Description
Definition
Extend (renew) the registration period for a domain name.
Usage
Use this command to renew domain registrations in real time. We recommend that you
renew at least a week before the domain expiration date.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Most commonly, this command is used by resellers who maintain their own databases.
Resellers who use a shopping cart and our order processing queue generally use the
AddToCart command with input parameter ProductType=Renew.
- 346 -
API Command Categories
After a domain expires, use UpdateExpiredDomains to reactivate it and renew its regis-
tration.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
The Extend command is a real-time command that is not implemented on enom.com;
however, on the domain control panel page, the add years button behaves similarly to
the Extend command.
Constraints
The query must meet the following requirements:
l To use our credit card processing, this must be an ETP reseller account.
l The domain name must be valid and active.
l The new expiration date cannot be more than 10 years in the future.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 347 -
API Command Categories
If UseCreditCard=yes, use
eNoms credit-card processing
services. When you pass credit
UseCreditCard Optional 3
card information with this com-
mand, you must secure HTTPS
protocol.
If UseCreditCard=yes Amount to
ChargeAmount Required charge per year for the renewal. 6
Use DD.cc format.
Required If
CCName Cardholder's name 60
UseCreditCard=yes
Required If
CreditCardNumber Customer's credit card number 128
UseCreditCard=yes
Required If
Credit card expiration month in
CreditCardExpMonth UseCreditCard=yes 2
MM format
Required If
CVV2 Credit card verification code 4
UseCreditCard=yes
Required If
CCAddress UseCreditCard=yes Credit card billing address 60
Required If
CCZip Credit card billing postal code 15
UseCreditCard=yes
- 348 -
API Command Categories
Required UseCred-
RegistrantFirstName Registrant first name 60
itCard=yes
Required If
RegistrantLastName Registrant last name 60
UseCreditCard=yes
Required If
RegistrantAddress1 UseCreditCard=yes Registrant address 60
Required If
RegistrantCity UseCreditCard=yes Registrant city 60
Required If
RegistrantStateProvince Registrant state or province 60
UseCreditCard=yes
Required If
RegistrantPostalCode Registrant postal code 16
UseCreditCard=yes
Required If
RegistrantCountry Registrant country 60
UseCreditCard=yes
Required If
RegistrantEmailAddress Registrant email address 128
UseCreditCard=yes
- 349 -
API Command Categories
Notes
l If using our credit card option ALL credit card information is required.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l We recommend that you store the OrderID valueat least the most recent one for
each domainfrom thereturn. Several other commands use this value as a
required input parameter.
- 350 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that the registration period for resellerdocs.com be exten-
ded for 1 year, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=Extend&uid=resellid&pw=resellpw&sld=resellerdocs
&tld=com&NumYears=1&ResponseType=XML
The response confirms the successful extension of the registration period for the domain:
Output
<interface-response>
<Extension>successful</Extension>
<DomainName>12dectest.com</DomainName>
<OrderID>157781677</OrderID>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully</RRPText>
<DomainInfo>
<RegistryExpDate>2015-03-31 09:17:29.000</RegistryExpDate>
</DomainInfo>
<Command>EXTEND</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>1.452</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 3:32:35 AM</RequestDateTime>
- 351 -
API Command Categories
</interface-response>
Related commands
l Extend_RGP
l ExtendDomainDNS
l GetDomainExp
l GetExtendInfo
l GetPOPExpirations
l GetRenew
l InsertNewOrder
l RenewPOPBundle
l SetRenew
l UpdateExpiredDomains
Extend_RGP
Description
Definition
Renew domain names that are in RGP status, in near-real time. This command charges
not only the usual renewal fee, but also the higher redemption fee.
Usage
Use this command to extend names that are in RGP status. This command does not yet
accommodate names in Extended RGP status. Use the GetExpiredDomains command
to check a names status.
RGP redemptions are performed at the Registry and generally take at least 3 hours to
complete. When you run this command, we recommend that you store the Order ID so
that you can check progress conveniently using the GetOrderDetail command.
This command will result in both a redemption and a renewal charge for the domain
name. We recommend that you check the RGP redemption price before running this com-
mand, as it can be quite high.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 352 -
API Command Categories
Constraints
The query must meet the following requirements:
l This command is available only to ETP reseller accounts.
l The login ID and password must be valid.
l The domain name must belong to this account.
l This command does not support our credit card processing; it deducts from the
reseller balance.
l This command applies only to names in RGP status, not Extended RGP or
domains in Expired status. Todetermine the status of a name, use the GetEx-
piredDomains command.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 353 -
API Command Categories
Notes
l We recommend that you check the redemption price for RGP names before run-
ning this command, as theprice can be quite high. Use the PE_GetResellerPrice
command, and look at product types 16 (renew) and 17 (RGP).
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query redeems and renews a domain name that is in RGP status, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=Extend_RGP&uid=resellid&pw=resellpw
&sld=VeryExpiredName&tld=com&ResponseType=xml
- 354 -
API Command Categories
In the response, the Extension value Successful value confirms that the query was suc-
cessful:
Output
Related commands
l AddToCart
l Extend
l ExtendDomainDNS
l GetExpiredDomains
l GetOrderDetail
l GetRenew
l PE_GetResellerPrice
l PE_SetPricing
l Purchase
l PurchaseServices
- 355 -
API Command Categories
l SetRenew
l UpdateExpiredDomains
ExtendDomainDNS
Description
Definition
In real time, renew DNS hosting services for a domain name that is registered else-
where.
Usage
Use this command to renew DNS services for a name that is registered elsewhere. This
is a real-time command that is most commonly used by resellers who maintain their own
databases. Resellers who use a shopping cart and our order queue generally use the
AddToCart command with input parameter ProductType=HostRenew.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/Checkout.asp
The ExtendDomainDNS command is not implemented on www.enom.com. However, on
the checkout page, the purchase button calls InsertNewOrder, a similar command that ini-
tiates checkout. The difference is that InserNewOrder acquires contents of the shopping
cart and puts them in a queue for checkout; the ExtendDomainDNS command bypasses
the shopping cart and the queue.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be an ETP reseller account.
l The domain name must not be registered with us, but must use our name servers.
- 356 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Required if using
RegistrantFirstName our credit card pro- Registrant first name 60
cessing
Required if using
RegistrantLastName our credit card pro- Registrant last name 60
cessing
Required if using
RegistrantAddress1 our credit card pro- Registrant address 60
cessing
Required if using
RegistrantCity our credit card pro- Registrant city 60
cessing
Required if using
RegistrantEmailAddress our credit card pro- Registrant email address 128
cessing
- 357 -
API Command Categories
Required if using
RegistrantPostalCode our credit card pro- Registrant postal code 16
cessing
- 358 -
API Command Categories
Required If
CreditCardNumber Customer's credit card number 128
UseCreditCard=yes
Required UseCred-
CVV2 Credit card verification code 4
itCard=yes
Required If
CCAddress Credit card billing address 60
UseCreditCard=yes
Required If
CCZip Credit card billing postal code 15
UseCreditCard=yes
Required If
CCCountry Credit card billing country 60
UseCreditCard=yes
- 359 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML
l in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query renews DNS hosting for domain resellerdnshost.com. It uses a
credit card, submits the credit card information using the secure HTTPS protocol, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=EXTENDDOMAINDNS&uid=resellid&pw=resellpw
&sld=resellerdnshost&tld=com&numyears=1
&RegistrantFirstName=John&RegistrantLastName=Doe
&RegistrantAddress1=17462&RegistrantCity=Redmond
&RegistrantPostalCode=98052&RegistrantCountry=USA
&RegistrantPhone=+1.4255559999
&RegistrantEmailAddress=john.doe@resellerdocs.com
&UseCreditCard=yes&CardType=mastercard&CCName=John+Doe
&CredcVV2=555&ccAddress=17462&ChargeAmount=12
&responsetype=xml
In the response, the order ID and the ErrCount value 0 confirm that the query was suc-
cessful:
Output
<interface-response>
<OrderID>157781689</OrderID>
<Command>EXTENDDOMAINDNS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
- 360 -
API Command Categories
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>1.109</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 4:05:56 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddToCart
l DeleteHostedDomain
l Extend
l InsertNewOrder
l Purchase
l PurchaseHosting
l PurchasePOPBundle
l PurchaseServices
Forwarding
Description
Definition
Set email forwarding addresses.
Usage
Use this command to specify forwarding addresses for email sent to the domain.
A similar command, SetPOPForwarding, allows you to create, change, or delete mail-
boxes for either email forwarding or POP mail.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 361 -
API Command Categories
https://resellertest.enom.com/domains/MailConfig.asp?DomainNameID=152533676
On the e-mail settings page,the save changes button calls the Forwarding command.
Constraints
The query must meet the following requirements:
l The domain must be using eNoms domain name server.
l The domain must exist in the account cited in the query.
l The query must include all addresses that you want to keep. Forwarding
addresses not included in thequery are deleted from the account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 362 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Example: thisAddress@mydomain.com to be forwarded to me@myhome.com.
Pass as Address1=thisAddress and ForwardTo1=me@myhome.com
Example
The following query gives instructions that email addressed to jane.-
doe@resellerdocs.com and john.doe@resellerdocs.com be forwarded to jane.-
doe@example.com and john.doe@example.com,and requests the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=Forwarding&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&Address1=jane.doe
&ForwardTo1=jane.doe@example.com&ResponseType=XML
The error count 0 confirms that the email forwarding instructions are successful:
Output
- 363 -
API Command Categories
<interface-response>
<EmailForwardingEnabled>True</EmailForwardingEnabled>
<MailCount>0</MailCount>
<Command>FORWARDING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>8.453</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 6:14:10 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l GetCatchAll
l GetDotNameForwarding
l GetForwarding
l GetMailHosts
l GetPOP3
l ModifyPOP3
l PurchasePOPBundle
l SetCatchAll
l SetDotNameForwarding
l SetPOPForwarding
l SetUpPOP3User
- 364 -
API Command Categories
GetAccountInfo
Description
Definition
Get account ID, password, authorization question and answer, reseller flag, and credit
card agreement settings.
Usage
Use this command to return a short list of account identification information and reseller
status.
GetAllAccountInfo, a similar command, returns a complete list of account information.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command runs in the background of eNoms Web site.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 365 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 366 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a limited list of account information for account resellid,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetAccountInfo&uid=resellid&pw=resellpw
&ResponseType=XML
- 367 -
API Command Categories
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountPassword
l GetAllAccountInfo
l GetConfirmationSettings
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l UpdateAccountInfo
l UpdateCusPreferences
GetAccountPassword
Description
Definition
Get the password for an account.
Usage
Use this command to have the password for an account e-mailed to the contact for that
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/help/
On the help page, the Password recovery link calls the GetAccountPassword command.
- 368 -
API Command Categories
Constraints
The query must meet the following requirements:
l The AuthQuestionAnswer value must be correct.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 369 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter If greater than 0 the transaction failed. The parameter Err(ErrCount) can
be presented to the client. Otherwise process the returned parameters as defined
above.
Example
The following query requests the password for subaccountThe following query requests
the password for subaccount ichiro, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetAccountPassword&nAnswuid=resellid&pw=resellpw
&LoginID=ichiro&AuthQuestionAnswer=Jones&responsetype=xml
In the response, the true value for GotAccountInfo and the 0 value for ErrCount indicate
that the query was successful. The password is sent to the registrant e-mail address
almost instantly.
Output
<interface-response>
<GetSubAcctLogin>
<ResultCode>1</ResultCode>
<ErrorMessage>Success</ErrorMessage>
<GotAccountInfo>true</GotAccountInfo>
</GetSubAcctLogin>
<Command>GETACCOUNTPASSWORD</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
- 370 -
API Command Categories
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.438</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 6:16:27 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountValidation
l GetAllAccountInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l SendAccountEmail
l UpdateAccountInfo
l UpdateCusPreferences
GetAccountValidation
Description
Definition
Retrieve the authorization question and answer for a subaccount.
Usage
Use this command to retrieve the authorization question and answer for a subaccount.
Typically, you would use this command to validate the identity of a user before using the
GetAccountPassword command to email their password to them.
Availability
- 371 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The subaccount must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 372 -
API Command Categories
Parameter Description
smaiden mothers maiden name
sbirth city of birth
ssocial last 4 digits of SSN
shigh high school
fteach favorite teacher
fvspot favorite vacation spot
fpet favorite pet
fmovie favorite movie
fbook favorite book
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the authorization question and answer for subaccount
ichiro and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getaccountvalidation&uid=resellid
&pw=resellpw&loginid=ichiro&responsetype=xml
- 373 -
API Command Categories
Related commands
l GetAccountPassword
l GetSubAccounts
l GetSubaccountsDetailList
l SendAccountEmail
- 374 -
API Command Categories
GetAddressBook
Description
Definition
Retrieve all contact information that has been entered for all domains in this account.
Usage
Use this command to retrieve all contact information that has been entered for domains
in this account.
This command retrieves only information associated with names in this account. It does
not retrieve information from subaccounts.
A typical use for this command is for accounts that offer real-time purchases, where the
account contains domain names registered by many customers.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com. This command will typically be used
by a domain name reseller for administrative purposes.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 375 -
API Command Categories
City City
Country Country
- 376 -
API Command Categories
Parameter Description
Fax Fax number
Notes
l The first contact in the response will always be the Billing contact for the account.
This is true regardless ofthe Page and PageSize values submitted in the query.
l Other than the first contact in the response, contacts are listed in the order they are
retrieved from ourdatabase. No sort parameters are offered for this command.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the first 100 contacts recorded for account resellid and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETADDRESSBOOK&uid=resellid&pw=resellpw
&responsetype=xml
- 377 -
API Command Categories
In the response, address records, a Count value, and a TotalPages value confirm that
the query was successful:
Output
<interface-response>
<AddressBook>
<Address rec="1">
<PartyId>{BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629}</PartyId>
<OrganizationName>Extraordinary Sales</OrganizationName>
<JobTitle>Manager</JobTitle>
<FirstName>Johnny</FirstName>
<LastName>Doety</LastName>
<Address1>15801 NE 24th Street</Address1>
<Address2/>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>98008</PostalCode>
<Country>US</Country>
<Phone>+1.4252744500</Phone>
<PhoneExt/>
<Fax/>
<Email>john.doe@resellerdocs.com</Email>
</Address>
<Address rec="2">
<PartyId>{F543B7C7-8FAC-44C3-8081-000766DDC905}</PartyId>
<OrganizationName/>
<JobTitle/>
<FirstName>R</FirstName>
<LastName>R</LastName>
<Address1>Italy, Torino</Address1>
<Address2/>
<City>Torino</City>
<StateProvince>Torino</StateProvince>
<StateProvinceChoice>P</StateProvinceChoice>
<PostalCode>13654</PostalCode>
<Country>IT</Country>
<Phone>+39.13123658</Phone>
<PhoneExt/>
<Fax/>
<Email>rescussreda@srcu.com</Email>
</Address>
- 378 -
API Command Categories
.
.
.
<Address rec="100">
<PartyId>{0D9BABA5-B3F4-E011-872B-005056BC7747}</PartyId>
<OrganizationName/>
<JobTitle/>
<FirstName>TestViji</FirstName>
<LastName>test</LastName>
<Address1>TestAddr</Address1>
<Address2>test</Address2>
<City>Test City</City>
<StateProvince/>
<StateProvinceChoice>N</StateProvinceChoice>
<PostalCode>4454</PostalCode>
<Country>US</Country>
<Phone>91.9835643473</Phone>
<PhoneExt/>
<Fax/>
<Email>vijirajt@gmail.com</Email>
</Address>
<Count>100</Count>
<TotalPages>101</TotalPages>
</AddressBook>
<Command>GETADDRESSBOOK</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.609</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 6:20:04 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 379 -
API Command Categories
Related commands
l AddContact
l Contacts
l DeleteContact
l GetContacts
l GetExtAttributes
l GetResellerInfo
l GetServiceContact
l GetWhoisContact
l Preconfigure
GetAgreementPage
Description
Definition
Retrieve the up-to-date Registration Agreement.
Usage
Use this command to retrieve the up-to-date verbiage for the requested agreement. You
can implement this command in your own Web site so that your agreement page always
contains the current language.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/help/HostTerms.asp
The eNoms Registration Agreement link calls the GetAgreementPage command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 380 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 381 -
API Command Categories
- 382 -
API Command Categories
Notes
l For RichContent, display the user agreement found at http://www.rich-
contentwidget.com/terms.aspx
l For Comodo SSL certificates, display the user agreement that link from http://www.-
comodo.com/about/comodo-agreements.php
l For GeoTrust SSL certificates, display the user agreement found at http://www.geo-
trust.com/resources/cps/pdfs/gt_ssl_SA_v.2.0.pdf
l For VeriSign SSL certificates, display the user agreement found at http://www.ver-
isign.com/repository/agreements/serverClass3Org.html
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the Registration Agreement text and sends the response in
XML format.
Query
https://resellertest.enom.com/interface.asp?
command=GetAgreementPage&uid=resellid
- 383 -
API Command Categories
&pw=resellpw&responsetype=xml
Output
<interface-response>
<content>
<p>THIS AGREEMENT HAS A PROVISION FOR ARBITRATION OF
DISPUTES
BETWEEN THE PARTIES.</p>
<p>
This Registration Agreement ("Agreement") sets forth the
terms
and conditions of your use of domain name registration and
related services ("Services"). In this Agreement "you" and
"your" refer to you and the registrant listed in the WHOIS
contact information for the domain name. "We", "us" and
"our" refer to the registrars listed at the <a href=
"#registrars">bottom of this document</a>, any one of which
will be the registrar for your domain name and all of which
share common ownership, common terms and conditions, and a
shared Services infrastructure. To determine which regis-
trar
your domain name is registered with, perform a WHOIS lookup
at <a href="http://www.uwhois.com" target="_blank">http://
www.uwhois.com</a>. You obtain the Services through your
primary service provider, with whom we have a wholesale
relationship (your "Primary Service Provider"). Your
relationship with your Primary Service Provider may be
governed by additional terms, as you and your Primary Ser-
vice
Provider may agree. "We," "us" and "our" does not include
your
Primary Service Provider, except when specifically men-
tioned
or unless your Primary Service Provider is one of us (i.e.,
if your Primary Service Provider is also one of the regis-
trars
listed at the <a href="#registrars">bottom of this document
</a>)).
</p>
.
- 384 -
API Command Categories
.
.
</content>
<Command>GETAGREEMENTPAGE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>b6812a69-5c50-43dd-85db-aeb3f37ff497</Track-
ingKey>
<RequestDateTime>12/8/2011 3:31:10 AM</RequestDateTime>
</interface-response>
Related commands
l None
GetAllAccountInfo
Description
Definition
Combines GetAccountInfo, GetCustomerPaymentInfo, and GetCustomerPreferences.
Usage
Use this command to access all information for an account.
Availability
All resellers have access to this command.
- 385 -
API Command Categories
Implementation on eNom.com
This command runs in the background of eNoms Web site.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
City City
- 386 -
API Command Categories
Parameter Description
StateProvince State or province
Country Country
- 387 -
API Command Categories
Parameter Description
DefPeriod Default number of years to register a name
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests all account information for account resellid, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetAllAccountInfo&uid=resellid
&pw=resellpw&ResponseType=XML
<interface-response>
- 388 -
API Command Categories
<OrganizationName>Extraordinary Sales</OrganizationName>
<JobTitle>Manager</JobTitle>
<Fname>Johnny</Fname>
<Lname>Doety</Lname>
<Address1>15801 NE 24th Street</Address1>
<Address2/>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>98008</PostalCode>
<Country>US</Country>
<Phone>+1.4252744500</Phone>
<PhoneExt/>
<Fax/>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<EmailAddress_Contact/>
<URL/>
<CreationDate>6/25/2002</CreationDate>
<GetAccountInfo>
<UserID>resellid</UserID>
<Password>resellpw</Password>
<AuthQuestionType>smaiden</AuthQuestionType>
<AuthQuestionAnswer>Jones</AuthQuestionAnswer>
<Account>217-no-0647</Account>
<Reseller>True</Reseller>
<AcceptTerms>True</AcceptTerms>
</GetAccountInfo>
<GetCustomerPaymentInfo>
<CCName>ww</CCName>
<CCNumber>************1111</CCNumber>
<CCType>VISA</CCType>
<CCMonth>04</CCMonth>
<CCYear>2017</CCYear>
<CCAddress>asd</CCAddress>
<CCZip>234</CCZip>
<CCCity>asd</CCCity>
<CCStateProvince>asd</CCStateProvince>
<CCCountry>AI</CCCountry>
<CCPhoneDial/>
<CCPhone>+United States.34534</CCPhone>
</GetCustomerPaymentInfo>
<GetCustomerPreferences>
- 389 -
API Command Categories
<DefPeriod/>
</GetCustomerPreferences>
<GetCustomerSupportPin>
<pin>2619237</pin>
<enabled>True</enabled>
</GetCustomerSupportPin>
<Command>GETALLACCOUNTINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.172</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:34:38 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetResellerInfo
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l RPT_GetReport
l UpdateAccountInfo
l UpdateCusPreferences
- 390 -
API Command Categories
GetAllDomains
Description
Definition
Get all domain names in an account.
Usage
Use this command to list all the domain names in an account, with their domain name
IDs and expiration dates.
We recommend that you use this command only for accounts with fewer than 200
names, because longer lists can time out. For large accounts, use GetDomains.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l We recommend that you use this command only for accounts with fewer than 200
names, becauselonger lists can time out. For large accounts, use GetDomains.
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 391 -
API Command Categories
- 392 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests all domains in account resellid, and requests the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetAllDomains&uid=resellid
&pw=resellpw&ResponseType=XML
The response lists all domain names in the account, with the ID number and expiration
date for each domain:
Output
- 393 -
API Command Categories
<interface-response>
<GetAllDomains>
<DomainDetail>
<DomainName>00000000001111.com</DomainName>
<DomainNameID>340691704</DomainNameID>
<expiration-date>7/7/2012 8:37:00 AM</expiration-date>
<lockstatus>Locked</lockstatus>
<AutoRenew>No</AutoRenew>
</DomainDetail>
<DomainDetail>
<DomainName>00000startajay.info</DomainName>
<DomainNameID>152708845</DomainNameID>
<expiration-date>2/4/2011 6:25:00 AM</expiration-date>
<lockstatus>Not Locked</lockstatus>
<AutoRenew>No</AutoRenew>
</DomainDetail>
.
.
.
<domaincount>3077</domaincount>
<UserRequestStatus>DomainBox</UserRequestStatus>
</GetAllDomains>
<Command>GETALLDOMAINS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>74.456</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:38:26 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 394 -
API Command Categories
Related commands
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetHomeDomainList
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetAllHostAccounts
Description
Definition
Retrieve a list of all Web hosting accounts in a domain name account, with attributes.
Usage
Use this command to list the Web hosting accounts in your eNom account, and some
attributes of each.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/
In the left-hand menu, the manage link calls the GetAllHostAccounts command.
- 395 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword¶mname=paramvalue
&nextparamname=nextparamvalue
- 396 -
API Command Categories
Parameter Description
Status Status of this Web hosting account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of the Web hosting accounts in account resellid, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETALLHOSTACCOUNTS&uid=resellid
- 397 -
API Command Categories
&pw=reselluid=resellid&pw=resellpw&responsetype=xml
- 398 -
API Command Categories
<Server>TEST1</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CreateHostAccount
l GetHostAccount
GetAllResellerHostPricing
Description
Definition
Retrieve your wholesale costs and retail selling prices, for all quantity levels, for Web
hosting components, for either Windows or Linux.
Usage
Use this command to retrieve a list of your wholesale costs and retail selling prices, for
all quantity levels, for all Web hosting components. One run of the command retrieves
either Windows or Linux pricing; send the query twice if you want to display both sets of
pricing on one page.
A similar command, GetResellerHostPricing, retrieves prices you charge to your sub-
accounts for Web hosting components.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
- 399 -
API Command Categories
The Set Component Unit Pricing table displays the results of the GetAllReseller-
HostPricing command.
Constraints
The query must meet the following requirements:
The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
In the retail (selling price) structure for this account, the lower
end of the quantity range for this component. For example, if
RetailQtyX
one RetailQty=1 and the next largest is RetailQty=5, the prices
in the RetailQty=1 node apply to quantities of 1 to 4 of each
- 400 -
API Command Categories
Parameter Description
Web hosting component listed in this query string.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 401 -
API Command Categories
Example
The following query returns the reseller (wholesale) costs and retail (selling) prices for
all quantity levels of all components and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETALLRESELLERHOSTPRICING&uid=resellid
&pw=resellpw&ResponseType=XML
In the response, a list of components and prices comfirms that the query was successful:
Output
- 402 -
API Command Categories
</components>
<components>
<ResellerQty>10</ResellerQty>
<RetailQty>10</RetailQty>
<ResellerBandwidthPrice>.36</ResellerBandwidthPrice>
<RetailBandwidthPrice>.40</RetailBandwidthPrice>
<ResellerWebStoragePrice>.25</ResellerWebStoragePrice>
<RetailWebStoragePrice>.30</RetailWebStoragePrice>
<ResellerDBStoragePrice />
<RetailDBStoragePrice />
<ResellerPOPMailPrice>.20</ResellerPOPMailPrice>
<RetailPOPMailPrice>.24</RetailPOPMailPrice>
</components>
<components>
<ResellerQty>20</ResellerQty>
<RetailQty>20</RetailQty>
<ResellerBandwidthPrice>.24</ResellerBandwidthPrice>
<RetailBandwidthPrice>.27</RetailBandwidthPrice>
<ResellerWebStoragePrice />
<RetailWebStoragePrice />
<ResellerDBStoragePrice />
<RetailDBStoragePrice />
<ResellerPOPMailPrice />
<RetailPOPMailPrice />
</components>
<PackageCount>4</PackageCount>
</resellerhostpricing>
<Command>GETALLRESELLERHOSTPRICING</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
- 403 -
API Command Categories
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
GetBalance
Description
Definition
Get account balances.
Usage
Use this command to return the current balance on an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount.asp
The Access link calls the GetBalance command.
- 404 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 405 -
API Command Categories
Parameter Description
DomainCount Current count of domains in the account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l This command only returns the price for original purchase of domains, not tranfers
or renewals. For acomplete list of prices, use PE_GetRetailPricing or PE_
GetResellerPrice.
Example
The following query requests the account balance for account resellid, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetBalance&uid=resellid&pw=resellpw
&responsetype=xml
<interface-response>
- 406 -
API Command Categories
<Reseller>1</Reseller>
<Balance>2,261.65</Balance>
<AvailableBalance>1,939.50</AvailableBalance>
<Price>8.95</Price>
<COMPrice>8.95</COMPrice>
<NETPrice>8.95</NETPrice>
<ORGPrice>8.95</ORGPrice>
<CCPrice>24.95</CCPrice>
<TVPrice>39.95</TVPrice>
<BZPrice>24.95</BZPrice>
<NUPrice>24.95</NUPrice>
<DomainCount>2943</DomainCount>
<Command>GETBALANCE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>2</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.312</ExecTime>
<Done>true</Done>
<RequestDateTime>12/13/2011 2:59:04 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CommissionAccount
l RefillAccount
l UpdateNotificationAmount
GetCartContent
Description
Definition
- 407 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 408 -
API Command Categories
NameID Name ID
- 409 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than If greater than 0 the trans-
action failed. The parameter Err(ErrCount) can be presented to the client. Other-
wise process the returned parameters as defined above.rameter StThe parameter
StatusID returns A for active and will be affected by future transactions, or I for inact-
ive.
Example
The following quThe following query requests the contents of the shopping cart for
account resellid, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetCartContent&uid=resellid&pw=resellpw
&ResponseType=XML
The response indicates that the shopping cart currently contains a domain to register
(resellerdocs.us):
Output
<interface-response>
<GetCartContent>
<ContainsDomain>true</ContainsDomain>
<item>
<ItemID>889018</ItemID>
<Description>Email Pak - 10 email boxes</Description>
<ProdType>38</ProdType>
<Years>1</Years>
- 410 -
API Command Categories
<NameID>152533676</NameID>
<Name>resellerdocs.com</Name>
<StatusID>A</StatusID>
<ItemPrice>9.95</ItemPrice>
<ItemTotalPrice>9.9500</ItemTotalPrice>
<ItemUnitPrice>9.9500</ItemUnitPrice>
<Renew>0</Renew>
<cd>
<IsMailPak>1</IsMailPak>
<ShowWPPSLink>0</ShowWPPSLink>
<ShowWBLLink>0</ShowWBLLink>
<ShowMobilizerLink>0</ShowMobilizerLink>
<ShowMailLink>0</ShowMailLink>
<p>
<QtyDesc>Pak(s)</QtyDesc>
<SubItem>0</SubItem>
<FreeTrial>0</FreeTrial>
</p>
</cd>
</item>
<item>
<ItemID>889049</ItemID>
<Description>Register</Description>
<ProdType>10</ProdType>
<Years>1</Years>
<NameID>152932786</NameID>
<Name>resellerdocs1.com</Name>
<StatusID>A</StatusID>
<ItemPrice>8.95</ItemPrice>
<ItemTotalPrice>8.9500</ItemTotalPrice>
<ItemUnitPrice>8.9500</ItemUnitPrice>
<Renew>0</Renew>
<cd>
<IsMailPak>0</IsMailPak>
<ShowWPPSLink>1</ShowWPPSLink>
<ShowWBLLink>1</ShowWBLLink>
<ShowMobilizerLink>0</ShowMobilizerLink>
<ShowMailLink>1</ShowMailLink>
<p>
<QtyDesc>Year(s)</QtyDesc>
<SubItem>0</SubItem>
<FreeTrial>0</FreeTrial>
- 411 -
API Command Categories
<ICANNFees>0.20</ICANNFees>
<BaseItemPrice>8.75</BaseItemPrice>
</p>
</cd>
</item>
<item>
<ItemID>889066</ItemID>
<Description>Register</Description>
<ProdType>10</ProdType>
<Years>1</Years>
<NameID>152932796</NameID>
<Name>resellerdocs123.com</Name>
<StatusID>A</StatusID>
<ItemPrice>8.95</ItemPrice>
<ItemTotalPrice>8.9500</ItemTotalPrice>
<ItemUnitPrice>8.9500</ItemUnitPrice>
<Renew>0</Renew>
<cd>
<IsMailPak>0</IsMailPak>
<ShowWPPSLink>1</ShowWPPSLink>
<ShowWBLLink>1</ShowWBLLink>
<ShowMobilizerLink>0</ShowMobilizerLink>
<ShowMailLink>1</ShowMailLink>
<p>
<QtyDesc>Year(s)</QtyDesc>
<SubItem>0</SubItem>
<FreeTrial>0</FreeTrial>
<ICANNFees>0.20</ICANNFees>
<BaseItemPrice>8.75</BaseItemPrice>
</p>
</cd>
</item>
</GetCartContent>
<GroupCounts>
<Group ParentItemID="889049" GroupCount="1"/>
<Group ParentItemID="889066" GroupCount="1"/>
<Group ParentItemID="889018" GroupCount="1"/>
</GroupCounts>
<CartItems>3</CartItems>
<Command>GETCARTCONTENT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
- 412 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.843</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:43:27 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddBulkDomains
l AddToCart
l DeleteFromCart
l InsertNewOrder
l PurchasePreview
l UpdateCart
GetCatchAll
Description
Definition
Get the forwarding address for emails addressed to nonexistent mailboxes.
Usage
Use this command to retrieve the forwarding address for nonexistent email addresses
under a domain name. The domain name must be in our system, but the forwarding
address does not need to be.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 413 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 414 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check the
ErrCount
Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the Catch-All email address for this domain name, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetCatchAll&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
In the response, the presence of the Catch-All email address confirms that the query was
successful:
Output
- 415 -
API Command Categories
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l DeletePOP3
l Forwarding
l GetDotNameForwarding
l GetForwarding
l GetPOP3
l GetPOPForwarding
l SetCatchAll
l SetDotNameForwarding
l SetPOPForwarding
l SetUpPOP3User
GetCerts
Description
Definition
Retrieve a list of the SSL certificates that we offer.
Usage
Use this command to retrieve a list of the types of SSL certificates that we offer.
Availability
All resellers have access to this command.
- 416 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/secure/PurchaseCerts.asp?
The table that lists the certs we offer could be populated by the GetCerts command. Our
page uses GetCerts to retrieve prices and hard codes the cert names, but GetCerts does
return cert names as well.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 417 -
API Command Categories
Parameter Description
QtyDesc Units in which this product is sold
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of the SSL certificate products we offer, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetCerts&UID=resellid&PW=resellpw
&ResponseType=XML
- 418 -
API Command Categories
In the response, a list of certificates and an ErrCount value 0 confirm that the query was
successful:
Output
<interface-response>
<GetCerts>
<Reseller>True</Reseller>
<Certs>
<Cert1>
<ProdCode>certificate-rapidssl-rapidssl</ProdCode>
<ProdType>23</ProdType>
<ProdDesc>SSL Certificate - RapidSSL</ProdDesc>
<QtyDesc>Year(s)</QtyDesc>
<RetailPrice>$19.95</RetailPrice>
<ResellerPrice>$9.95</ResellerPrice>
<Enabled>True</Enabled>
<Years>1</Years>
<Years>2</Years>
<Years>3</Years>
<Years>4</Years>
<Years>5</Years>
</Cert1>
<Cert2>
<ProdCode>certificate-geotrust-quickssl</ProdCode>
<ProdType>26</ProdType>
<ProdDesc>SSL Certificate - GeoTrust QuickSSL</ProdDesc>
<QtyDesc>Year(s)</QtyDesc>
<RetailPrice>$125.00</RetailPrice>
<ResellerPrice>$69.00</ResellerPrice>
<Enabled>True</Enabled>
<Years>1</Years>
<Years>2</Years>
<Years>3</Years>
<Years>4</Years>
<Years>5</Years>
</Cert2>
.
.
.
</Certs>
<CertCount>16</CertCount>
</GetCerts>
- 419 -
API Command Categories
<Command>GETCERTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.500</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>c0a2fd36-f8f8-451b-9eb4-8b5b406b69c5</Track-
ingKey>
<RequestDateTime>12/8/2011 3:47:44 AM</RequestDateTime>
</interface-response>
Related commands
l CertConfigureCert
l CertGetApproverEmail
l CertGetCertDetail
l CertGetCerts
l CertModifyOrder
l CertParseCSR
l CertPurchaseCert
GetConfirmationSettings
Description
Definition
Retrieve the settings for email confirmations of orders.
Usage
Use this command to retrieve the current settings for email confirmations of orders (con-
firmations sent to you when a customer places an order).
- 420 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/ConfirmationSettings.asp
The settings on the Reseller Confirmation Email Settings page are retrieved using the
GetConfirmationSettings command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 421 -
API Command Categories
Parameter Description
you, when orders are placed on this account
EmailHead If set for custom email text, the header string that will be used
EmailTail If set for custom email text, the tail string that will be used
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the settings for order confirmation emails, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetConfirmationSettings&uid=resellid
&pw=resellpw&responsetype=xml
- 422 -
API Command Categories
In the response, return values in the ConfirmationSettings node confirms that the query
was successful:
Output
<interface-response>
<ConfirmationSettings>
<OrderConfirmation>True</OrderConfirmation>
<TransferOrderConfirmation>True</TransferOrderConfirmation>
<OrderConfirmationBCC>True</OrderConfirmationBCC>
<Trans-
ferOrderConfirmationBCC>True</TransferOrderConfirmationBCC>
<EmailHead></EmailHead>
<EmailTail></EmailTail>
</ConfirmationSettings>
<Command>GETCONFIRMATIONSETTINGS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.344</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:50:04 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAccountInfo
l GetCusPreferences
l GetSubAccountDetails
l GetTLDList
l PE_GetRetailPricing
l PE_SetPricing
l UpdateCusPreferences
- 423 -
API Command Categories
GetContacts
Description
Definition
Get all contact data for a domain name.
Usage
Use this command to display contact information for this account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
In the utilities section, the Contact/WhoIs Information link calls the GetContacts com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 424 -
API Command Categories
ContactTypePartyID Party ID
ContactTypeAddress1 Address 1
ContactTypeAddress2 Address 2
ContactTypeCity City
- 425 -
API Command Categories
Parameter Description
ContactTypeCountry Country
ContactTypeFax Fax
- 426 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l If there are additional contact entries, Billing in the above return parameter names
is replaced with REGISTRANT, AUXBILLING, TECH, or ADMIN.
Example
The following query requests the contact information for resellerdocs.com, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getcontacts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
The response gives contact information for the registrant party and billing party, and
states that no different information was provided for the auxiliary billing, technical, and
administrative contacts. Where no different information is provided, these contacts
default to the billing party information:
Output
<interface-response>
- 427 -
API Command Categories
<GetContacts>
<domainname sld="resellerdocs" tld="com" domain-
nameid="152533676">resellerdocs.com</domainname>
<Registrant>
<RegistrantPartyID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}
</RegistrantPartyID>
<RegistrantOrganizationName>Extraordinary Sales</Re-
gistrantOrganizationName>
<RegistrantJobTitle>Manager</RegistrantJobTitle>
<RegistrantFirstName>Johnny</RegistrantFirstName>
<RegistrantLastName>Doety</RegistrantLastName>
<RegistrantAddress1>15801 NE 24th Street</Re-
gistrantAddress1>
<RegistrantAddress2/>
<RegistrantCity>Bellevue</RegistrantCity>
<RegistrantCountry>US</RegistrantCountry>
<RegistrantStateProvince>WA</RegistrantStateProvince>
<Regis-
trantStateProvinceChoice>S</RegistrantStateProvinceChoice>
<RegistrantPostalCode>98008</RegistrantPostalCode>
<Regis-
trantE-
mailAddress>john.doe@resellerdocs.com</RegistrantEmailAddress>
<RegistrantPhone>+1.4252744500</RegistrantPhone>
<RegistrantPhoneExt/>
<RegistrantFax/>
</Registrant>
<AuxBilling>
<AuxBillingPartyID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}
</AuxBillingPartyID>
<AuxBillingOrganizationName>Extraordinary
Sales</AuxBillingOrganizationName>
<AuxBillingJobTitle>Manager</AuxBillingJobTitle>
<AuxBillingFirstName>Johnny</AuxBillingFirstName>
<AuxBillingLastName>Doety</AuxBillingLastName>
<AuxBillingAddress1>15801 NE 24th Street</AuxBillingAd-
dress1>
<AuxBillingAddress2/>
<AuxBillingCity>Bellevue</AuxBillingCity>
<AuxBillingCountry>US</AuxBillingCountry>
<AuxBillingStateProvince>WA</AuxBillingStateProvince>
<AuxBillingStateProvinceChoice>S</AuxBillingStateProvinceCh-
oice>
- 428 -
API Command Categories
<AuxBillingPostalCode>98008</AuxBillingPostalCode>
<AuxBillingE-
mailAd-
dress>john.doe@resellerdocs.com</AuxBillingEmailAddress>
<AuxBillingPhone>+1.4252744500</AuxBillingPhone>
<AuxBillingPhoneExt/>
<AuxBillingFax/>
<UseRegInfoAbove>True</UseRegInfoAbove>
<auxID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}</auxID>
<regID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}</regID>
</AuxBilling>
<Tech>
<TechPartyID>{5e731431-d986-405e-a9ae-4feb5dd2d6ae}
</TechPartyID>
<TechOrganizationName/>
<TechJobTitle/>
<TechFirstName>John</TechFirstName>
<TechLastName>Smith</TechLastName>
<TechAddress1>100 Main St.</TechAddress1>
<TechAddress2/>
<TechCity>Townsville</TechCity>
<TechCountry>US</TechCountry>
<TechStateProvince/>
<TechStateProvinceChoice> </TechStateProvinceChoice>
<TechPostalCode/>
<TechEmailAddress>john@resellerdocs.com</TechEmailAddress>
<TechPhone>+1.5555555555</TechPhone>
<TechPhoneExt/>
<TechFax/>
</Tech>
<Admin>
<AdminPartyID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}</Ad-
minPartyID>
<AdminOrganizationName>Extraordinary Sales</Ad-
minOrganizationName>
<AdminJobTitle>Manager</AdminJobTitle>
<AdminFirstName>Johnny</AdminFirstName>
<AdminLastName>Doety</AdminLastName>
<AdminAddress1>15801 NE 24th Street</AdminAddress1>
<AdminAddress2/>
<AdminCity>Bellevue</AdminCity>
<AdminCountry>US</AdminCountry>
- 429 -
API Command Categories
<AdminStateProvince>WA</AdminStateProvince>
<AdminStateProvinceChoice>S</AdminStateProvinceChoice>
<AdminPostalCode>98008</AdminPostalCode>
<AdminE-
mailAddress>john.doe@resellerdocs.com</AdminEmailAddress>
<AdminPhone>+1.4252744500</AdminPhone>
<AdminPhoneExt/>
<AdminFax/>
</Admin>
<Billing>
<BillingPartyID>{bb4a2de1-6485-45cb-a4fc-ee39ba0c1629}
</BillingPartyID>
<BillingOrganizationName>Extraordinary Sales</BillingOr-
ganizationName>
<BillingJobTitle>Manager</BillingJobTitle>
<BillingFirstName>Johnny</BillingFirstName>
<BillingLastName>Doety</BillingLastName>
<BillingAddress1>15801 NE 24th Street</BillingAddress1>
<BillingAddress2/>
<BillingCity>Bellevue</BillingCity>
<BillingCountry>US</BillingCountry>
<BillingStateProvince>WA</BillingStateProvince>
<BillingStateProvinceChoice>S</BillingStateProvinceChoice>
<BillingPostalCode>98008</BillingPostalCode>
<BillingE-
mailAddress>john.doe@resellerdocs.com</BillingEmailAddress>
<BillingPhone>+1.4252744500</BillingPhone>
<BillingPhoneExt/>
<BillingFax/>
<BillingFullCountry>United States</BillingFullCountry>
</Billing>
<Nexus category=""/>
<Purpose/>
<CurrentAttributes>
</CurrentAttributes>
<WPPSAllowed>1</WPPSAllowed>
<WPPSExists>1</WPPSExists>
<WPPSEnabled>1</WPPSEnabled>
<WPPSExpDate>12/22/2011</WPPSExpDate>
<WPPSAutoRenew>No</WPPSAutoRenew>
<WPPSContactData>
<ContactType>WPPS</ContactType>
- 430 -
API Command Categories
- 431 -
API Command Categories
Related commands
l AddContact
l Contacts
l DeleteContact
l GetAddressBook
l GetExtAttributes
l GetResellerInfo
l GetServiceContact
l GetWhoisContact
l Preconfigure
GetCusPreferences
Description
Definition
Retrieve global preferences for an account.
Usage
Use this command to retrieve global preferences for an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
On the settings page, many of the settings shown can be retrieved using GetCusPrefer-
ences.
- 432 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 433 -
API Command Categories
Parameter Description
True requires the account holders permission to transfer the
RegLock
domain to another registrar
DefaultHostRecordOwn Is this account using its own set of default host records?
HostPrice Price this Registry Rocket account charges for DNS hosting
- 434 -
API Command Categories
Parameter Description
PictureURL URL of image file used in this Registry Rocket site
ResCustomerPrice ?
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 435 -
API Command Categories
Example
The following query retrieves the account settings for resellid and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetCusPreferences&uid=resellid&pw=resellpw
&responsetype=xml
<interface-response>
<CustomerPrefs>
<DefPeriod>1</DefPeriod>
<AllowDNS>False</AllowDNS>
<ShowPopups>False</ShowPopups>
<AutoRenew>False</AutoRenew>
<RegLock>False</RegLock>
<AutoPakRenew>False</AutoPakRenew>
<UseDNS>True</UseDNS>
<ResellerStatus/>
<RenewalSetting>1</RenewalSetting>
<RenewalBCC>1</RenewalBCC>
<RenewalURLForward>False</RenewalURLForward>
<RenewalEmailForward>False</RenewalEmailForward>
<MailNumLimit>100</MailNumLimit>
<IDProtect>False</IDProtect>
<DefIDProtectRenew>False</DefIDProtectRenew>
<DefWBLRenew>False</DefWBLRenew>
<NameJetSales>False</NameJetSales>
<defaulthostrecords>
<hostrecord hostname="@" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="*" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="www" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="" address="" recordtype="A"/>
<hostrecord hostname="" address="" recordtype="A"/>
- 436 -
API Command Categories
</defaulthostrecords>
<defaulthostrecordown>False</defaulthostrecordown>
<UseOurDNS>False</UseOurDNS>
<NameServers>
<DNS1>ns1.nicmus.com</DNS1>
<DNS2>ns2.nicmus.com</DNS2>
<DNS3>ns3.nicmus.com</DNS3>
</NameServers>
</CustomerPrefs>
<CustomerInformation>
<AcceptTerms>True</AcceptTerms>
<URL/>
<ParentAccount>000-00-0000</ParentAccount>
<ParentLogin>Main-eNom</ParentLogin>
<NoService>False</NoService>
<BulkRegLimit>100</BulkRegLimit>
<Account>217-no-0647</Account>
</CustomerInformation>
<Command>GETCUSPREFERENCES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:56:24 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetConfirmationSettings
l UpdateCusPreferences
l UpdateRenewalSettings
- 437 -
API Command Categories
GetCustomerDefinedData
Description
Definition
Retrieve customer-defined data.
Usage
Use this command to retrieve custom data.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 438 -
API Command Categories
Required If Type=2
TLD Top-level domain name (extension) 15
- 439 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the value for the customer-defined data titled Favor-
iteCuisine for account resellid, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getcustomerdefineddata&uid=resellid&pw=resellpw
&ObjectID=1&Type=1&Key=FavoriteCuisine&responsetype=xml
- 440 -
API Command Categories
</interface-response>
Related commands
l DeleteCustomerDefinedData
l SetCustomerDefinedData
GetCustomerPaymentInfo
Description
Definition
Retrieve customer payment information.
Usage
Use this command to retrieve customer payment information.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/EditContact.asp
The Credit Card Information box contains the return values supplied by the GetCus-
tomerPaymentInfo command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
- 441 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 442 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the payment information on record for an account, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetCustomerPaymentInfo&uid=resellid
&pw=resellpw&responsetype=xml
- 443 -
API Command Categories
<CCPhoneDial>1</CCPhoneDial>
<CCPhone>5555559999</CCPhone>
</GetCustomerPaymentInfo>
<Command>GETCUSTOMERPAYMENTINFO</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>8.203125E-02</ExecTime>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAllAccountInfo
l GetSubAccountDetails
l GetSubAccounts
l UpdateAccountInfo
l UpdateCusPreferences
GetDNS
Description
Definition
Retrieve the name server settings for a domain name.
Usage
- 444 -
API Command Categories
Use this command to retrieve name servers for one domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 445 -
API Command Categories
Parameter Description
Name server X. Indexed X when ResponseType=Text or
DNSX
HTML.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the domain name servers for resellerdocs.com, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDNS&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
- 446 -
API Command Categories
<interface-response>
<dns>dns1.name-services.com</dns>
<dns>dns2.name-services.com</dns>
<dns>dns3.name-services.com</dns>
<dns>dns4.name-services.com</dns>
<dns>dns5.name-services.com</dns>
<UseDNS>default</UseDNS>
<NSStatus>Yes</NSStatus>
<HostsNumLimit>15</HostsNumLimit>
<DNSRegistrySynced>True</DNSRegistrySynced>
<RRPCodeGDNS>200</RRPCodeGDNS>
<RRPText>Command completed successfully</RRPText>
<Command>GETDNS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.594</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 3:58:52 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNSStatus
l ModifyNS
l ModifyNSHosting
l RegisterNameServer
l UpdateNameServer
- 447 -
API Command Categories
GetDNSStatus
Description
Definition
Get the nameserver status for a domain name.
Usage
Use this command to determine what DNS this domain uses. The query returns values
only if the domain uses eNom servers.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 448 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the DNS status of resellerdocs.com -- that is, whether the
domain uses its registrars servers. The query also requests the response in XML format:
Query
- 449 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=GetDNSStatus&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
The NS status Yes indicates that the domain uses the registrars name servers:
Output
<interface-response>
<UseDNS>default</UseDNS>
<NSStatus>Yes</NSStatus>
<HostsNumLimit>15</HostsNumLimit>
<Command>GETDNSSTATUS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:03:39 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNS
l ModifyNS
l ModifyNSHosting
l RegisterNameServer
l UpdateNameServer
- 450 -
API Command Categories
GetDomainCount
Description
Definition
Get the count for registered, hosted, processing, watch list, cart item and expired
domains.
Usage
Use this command to return the number of domains in each category.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
GetDomainCount is not implemented on eNom.com, but clicking the log-in button returns
information that includes counts of the domains in each category.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 451 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 452 -
API Command Categories
Example
The following query requests a tally of domains in account resellid, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainCount&uid=resellid&pw=resellpw
&ResponseType=XML
The response indicates that the account has 3084 registered and 190 hosted domains:
Output
<interface-response>
<RegisteredCount>3084</RegisteredCount>
<HostCount>190</HostCount>
<ExpiringCount>565</ExpiringCount>
<ExpiredDomainsCount>5379</ExpiredDomainsCount>
<RGP>0</RGP>
<ExtendedRGP>0</ExtendedRGP>
<KeywordCount>0</KeywordCount>
<ProcessCount>0</ProcessCount>
<WatchlistCount>160</WatchlistCount>
<CartItemCount>3</CartItemCount>
<trafficmsg>
<VistaCustomer>True</VistaCustomer>
<RedirectorData>False</RedirectorData>
<Month/>
<PageViews/>
<Visitors/>
<FreeTrial>False</FreeTrial>
<PDQVista/>
</trafficmsg>
<Command>GETDOMAINCOUNT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
- 453 -
API Command Categories
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.578</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:05:04 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetDomainExp
Description
Definition
Get domain expiration date.
Usage
Use this command to display the expiration date for a domain name.
Availability
- 454 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 455 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the expiration date for resellerdocs.com, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainExp&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
The response indicates that the expiration date for the domain is 6/10/2019:
Output
<interface-response>
<ExpirationDate>6/10/2019 3:56:56 PM</ExpirationDate>
- 456 -
API Command Categories
<Command>GETDOMAINEXP</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.095</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:06:42 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l Extend
l Extend_RGP
l GetAllDomains
l GetDomainCount
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l InsertNewOrder
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l UpdateExpiredDomains
l ValidatePassword
- 457 -
API Command Categories
GetDomainFolderDetail
Description
Definition
Retrieve an extensive set of information on a domain folder.
Usage
Use this command to retrieve an extensive set of information on a domain folder.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Manager.aspx?tab=folder
Clicking a Settings link calls the GetDomainFolderDetail command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The folder must belong to this account
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 458 -
API Command Categories
- 459 -
API Command Categories
Parameter Description
0 Leave auto-renew settings for each domain as is
1 Update auto-renew settings for all domains to this folders set-
ting
Registrar lock setting for this folder, if one is set. Values are:
RegLockStatus 0 Do not lock domains in this folder
1 Automatically lock domains in this folder
- 460 -
API Command Categories
Parameter Description
Domain password setting for this folder, if one is set. Values
are:
DomainPwdValue
0 Do not require a password for domains in this folder
1 Require a password for all domains in this folder
Should host records be the same for all domains in this folder?
Host records are also known as third-level domain names, like
SyncHostse www. Values each are:
0 Leave host records for each domain as is
1 Update host records for all domains to the folder settings
- 461 -
API Command Categories
Parameter Description
StateProvince State or province of this contact
Notes
l The default response format is plain text. To receive the response in HTML or
XMThe default response format is plain text. To receive the response in HTML or
XML format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter e parameterErr Err(ErrCount) can be presented to the
client. Otherwise process the returned parameters as defined above.
- 462 -
API Command Categories
Example
The following query retrieves details on a folder, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainFolderDetail&uid=resellid
&pw=resellpw&FolderName=Favorites&responsetype=XML
In the response, the presence of data and an ErrCount value 0 indicate that the query
was successful:
Output
<interface-response>
<Result>1</Result>
<Folder>
<FolderID>9140</FolderID>
<FolderName>Favorites</FolderName>
<Folder-
Description>FolderForMyFavoriteNames</FolderDescription>
<FolderType>1</FolderType>
<FolderStatus>2</FolderStatus>
<FolderDomainCount>0</FolderDomainCount>
<DNS>
<SyncDNS>1</SyncDNS>
<SyncDNSStatus>2</SyncDNSStatus>
<NSStatus>NA</NSStatus>
<NameServer>ns769.hostgator.com</NameServer>
<NameServer>ns770.hostgator.com</NameServer>
</DNS>
<Renew>
<SyncRenew>0</SyncRenew>
<SyncRenewStatus>2</SyncRenewStatus>
<RenewStatus/>
</Renew>
<RegLock>
<SyncRegLock>0</SyncRegLock>
<SyncRegLockStatus>2</SyncRegLockStatus>
<RegLockStatus/>
</RegLock>
<DomainPwd>
- 463 -
API Command Categories
<SyncDomainPwd>0</SyncDomainPwd>
<SyncDomainPwdStatus>2</SyncDomainPwdStatus>
<DomainPwdValue></DomainPwdValue>
</DomainPwd>
<Hosts>
<SyncHosts>0</SyncHosts>
<SyncHostsStatus>2</SyncHostsStatus>
</Hosts>
<Contacts>
<SyncContact>0</SyncContact>
<SyncContactStatus>2</SyncContactStatus>
<BillingContact>
<PartyID>BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629</PartyID>
<OrganizationName>Extraordinary Sales</OrganizationName>
<JobTitle>Manager</JobTitle>
<FName>Johnny</FName>
<LName>Doety</LName>
<Address1>15801 NE 24th Street</Address1>
<Address2></Address2>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>98008</PostalCode>
<Country>US</Country>
<FullCountry>United States</FullCountry>
<Phone>+1.4252744500</Phone>
<Fax></Fax>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<PhoneExt></PhoneExt>
<SameAs/>
</BillingContact>
<RegistrantContact>
<SyncContactRegistrant>0</SyncContactRegistrant>
<PartyID/>
<OrganizationName></OrganizationName>
<JobTitle></JobTitle>
<FName></FName>
<LName></LName>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateProvince></StateProvince>
- 464 -
API Command Categories
<StateProvinceChoice></StateProvinceChoice>
<PostalCode></PostalCode>
<Country></Country>
<FullCountry></FullCountry>
<Phone></Phone>
<Fax></Fax>
<EmailAddress></EmailAddress>
<PhoneExt></PhoneExt>
<SameAs/>
</RegistrantContact>
<AdminContact>
<SyncContactAdmin>0</SyncContactAdmin>
<PartyID/>
<OrganizationName></OrganizationName>
<JobTitle></JobTitle>
<FName></FName>
<LName></LName>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateProvince></StateProvince>
<StateProvinceChoice></StateProvinceChoice>
<PostalCode></PostalCode>
<Country></Country>
<FullCountry></FullCountry>
<Phone></Phone>
<Fax></Fax>
<EmailAddress></EmailAddress>
<PhoneExt></PhoneExt>
<SameAs/>
</AdminContact>
<TechContact>
<SyncContactTech>0</SyncContactTech>
<PartyID/>
<OrganizationName></OrganizationName>
<JobTitle></JobTitle>
<FName></FName>
<LName></LName>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateProvince></StateProvince>
- 465 -
API Command Categories
<StateProvinceChoice></StateProvinceChoice>
<PostalCode></PostalCode>
<Country></Country>
<FullCountry></FullCountry>
<Phone></Phone>
<Fax></Fax>
<EmailAddress></EmailAddress>
<PhoneExt></PhoneExt>
<SameAs/>
</TechContact>
<AuxBillingContact>
<SyncContactAuxBilling>0</SyncContactAuxBilling>
<PartyID/>
<OrganizationName></OrganizationName>
<JobTitle></JobTitle>
<FName></FName>
<LName></LName>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateProvince></StateProvince>
<StateProvinceChoice></StateProvinceChoice>
<PostalCode></PostalCode>
<Country></Country>
<FullCountry></FullCountry>
<Phone></Phone>
<Fax></Fax>
<EmailAddress></EmailAddress>
<PhoneExt></PhoneExt>
<SameAs/>
</AuxBillingContact>
</Contacts>
</Folder>
<FolderNameEnc>Favorites</FolderNameEnc>
<TrafficOnly>False</TrafficOnly>
<NameOnly>False</NameOnly>
<ParkingEnabled>False</ParkingEnabled>
<Command>GETDOMAINFOLDERDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
- 466 -
API Command Categories
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.234</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:14:10 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderList
l RemoveUnsyncedDomains
l UpdateDomainFolder
GetDomainFolderList
Description
Definition
Retrieve a list of folders that a domain is in, or retrieve a list of all folders in an account.
Usage
Use this command to find out which folders a domain is in, or to retrieve a list of all
folders in an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Manager.aspx?tab=folder
- 467 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 468 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a list of folders that contain the specified domain, and
sends the response in XML format:
Query
- 469 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=GetDomainFolderList&uid=resellid
&pw=resellpw&sld=resellerdocs&tld=com&responsetype=xml
In the response, a Result value 1 and an ErrCount value 0 indicate that the query was
successful:
Output
- 470 -
API Command Categories
<ExecTime>0.109</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderDetail
l RemoveUnsyncedDomains
l UpdateDomainFolder
GetDomainHeader
Description
Definition
Retrieve status of a domain header (a pointer for a domain name that associates the
sld.tld portion of the name with a specific location in your Web hosting directory struc-
ture) in your Web hosting account.
Usage
Use this command to retrieve information on a domain header from your Web hosting
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
The GetDomainHeader command is not implemented on enom.com; however, the fol-
lowing gives a similar result:
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/packagemanager.asp
- 471 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 472 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query checks whether a domain header record has been established for
resellerdocs.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETDOMAINHEADER&uid=resellid&pw=resellpw
&HostAccount=resellwebid&sld=resellerdocs&tld=com
&ResponseType=xml
The response indicates that resellerdocs.com does indeed have a domain header, and it
is pointed to \resellwebid:
Output
- 473 -
API Command Categories
<Path>\resellwebid</Path>
<Successful>True</Successful>
</DomainHeader>
<Command>GETDOMAINHEADER</Command>
<ErrCount>0</ErrCount>
<Server>TEST3</Server>
<Site>enom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l CreateHostAccount
l DeleteDomainHeader
l ListDomainHeaders
l ModifyDomainHeader
l WebHostCreateDirectory
GetDomainInfo
Description
Definition
Get information about a single domain name.
Usage
Use this command to display current information about a single domain name. This com-
mand also retrieves the DomainNameID value, which is required by some other com-
mands in our API.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 474 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
- 475 -
API Command Categories
Parameter Description
TLD Top-level domain name (extension)
- 476 -
API Command Categories
Parameter Description
StatusDescr Status ID of this Business Listing
- 477 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests domain informationstatus and services for reseller-
docs.com, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainInfo&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
<interface-response>
<GetDomainInfo>
<domainname sld="resellerdocs" tld="com" domain-
nameid="152533676">resellerdocs.com
</domainname>
<multy-langSLD>
</multy-langSLD>
<status>
<expiration>6/10/2019 3:56:56 PM</expiration>
<escrowliftdate/>
<escrowhold/>
<deletebydate>6/10/2019 3:56:56 PM</deletebydate>
<deletetype/>
<registrar>eNom, Inc.</registrar>
<registrationstatus>Registered</registrationstatus>
<purchase-status>Paid</purchase-status>
<belongs-to party-id="{BB4A2DE1-6485-45CB-A4FC-
EE39BA0C1629}">resellid</belongs-to>
- 478 -
API Command Categories
</status>
<ParkingEnabled>False</ParkingEnabled>
<services>
<entry name="dnsserver">
<enomDNS value="YES" isDotName="NO"/>
<service changable="1">1006</service>
<configuration changable="0" type="dns">
<dns>dns1.name-services.com</dns>
<dns>dns2.name-services.com</dns>
<dns>dns3.name-services.com</dns>
<dns>dns4.name-services.com</dns>
<dns>dns5.name-services.com</dns>
</configuration>
</entry>
<entry name="dnssettings">
<service changable="0">1021</service>
<configuration changable="1" type="host">
<host>
<name>@</name>
<type>A</type>
<address>66.150.5.189</address>
<mxpref>10</mxpref>
<iseditable>1</iseditable>
</host>
.
.
.
</configuration>
</entry>
<entry name="wsb">
<service changable="1">1063</service>
<configuration changable="1" type="wsb">
<wsb>LWSC353x2587</wsb>
<siteid>1348</siteid>
<prodtype>86</prodtype>
<nextbilldate>Jun 27 2011 12:00AM</nextbilldate>
</configuration>
</entry>
<entry name="emailset">
<service changable="1">1114</service>
<configuration changable="1" type="pop">
<pop>
- 479 -
API Command Categories
<username>dell</username>
</pop>
.
.
.
</configuration>
</entry>
<entry name="wpps">
<service changable="1">1120</service>
<configuration changable="1" type="id protect">
<wpps>
<cloak-
edemail>cmktwnrb@whoisprivacyprotect.com</cloakedemail>
<forward-to>john.doe@resellerdocs.com</forward-to>
<expiredate>Dec 22, 2011</expiredate>
<autorenew>No</autorenew>
</wpps>
</configuration>
</entry>
<entry name="wbl">
<service changable="1">1130</service>
<wbl>
<wblid>1010</wblid>
<statusid>2</statusid>
<statusdescr>Configured</statusdescr>
<expdate>2012-11-13T14:25:57.460</expdate>
<enabled>1</enabled>
<renew>no</renew>
<companyname>My Super Company</companyname>
<companydescription>We make super cool stuff</-
companydescription>
<domainname>resellerdocs.com</domainname>
<street>123 Anywhere Street</street>
<street2>Suite 100</street2>
<city>Peoria</city>
<stateprovince>IL</stateprovince>
<postalcode>10001</postalcode>
<country>US</country>
<categoryid1>11</categoryid1>
<categoryid2>14</categoryid2>
<categoryid3>16</categoryid3>
<configuration>
- 480 -
API Command Categories
<fields>
<field fieldname="Associations">
<value>My associations</value>
</field>
<field fieldname="Tags">
<value>My tags</value>
</field>
<field fieldname="Promotions">
<value>My Promotions</value>
</field>
</fields>
</configuration>
</wbl>
</entry>
.
.
.
</services>
</GetDomainInfo>
<Command>GETDOMAININFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.625</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:20:45 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomains
- 481 -
API Command Categories
l GetExpiredDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetDomainNameID
Description
Definition
Retrieves the ID number for a domain.
Usage
In some API commands, you can use the domain name ID instead of the SLD and TLD.
Our database associates a unique ID with each domain name, and all activity in the data-
base is tracked by ID rather than by domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 482 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 483 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the domain name ID for resellerdocs.com, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getdomainnameid&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<SLD>resellerdocs</SLD>
<TLD>com</TLD>
<DomainNameID>152533676</DomainNameID>
<Command>GETDOMAINNAMEID</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.108</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:24:19 AM</RequestDateTime>
- 484 -
API Command Categories
<debug></debug>
</interface-response>
Related commands
l GetDomainSLDTLD
GetDomains
Description
Definition
Get a single page of domain names with the ability to load the next or previous page of
names.
Usage
Use this command to list a single page of domains in an account. GetAllDomains is our
older command for large accounts. GetAllDomains, a similar command, returns the com-
plete list of domain names in an account but can time out for accounts with more than
200 domain names. AdvancedDomainSearch is the most up-to-date command for
accounts of all sizes.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/
In the my enom section, the x domain names link calls the GetDomains command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 485 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 486 -
API Command Categories
Name server status. YES indicates this domain uses our name
NS-StatusX
servers. Indexed X when ResponseType=Text or HTML.
- 487 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a list of domains and basic information about them for
account resellid, and requests the response in XML format. This command returns 25
domains at a time. Because it does not specify which domain to start with, the response
by default starts with the first domain (sorting by domain name: numbers first, then let-
ters):
Query
https://resellertest.enom.com/interface.asp?
command=GetDomains&uid=resellid&pw=resellpw
&ResponseType=XML
The response lists the first 25 domains in account resellid, starting with resellerdocs.com
and resellerdocs3.info. It also provides some summary information about the total con-
tents of the account:
Output
- 488 -
API Command Categories
<interface-response>
<GetDomains>
<tab/>
<multirrp>False</multirrp>
<domain-list type="Registered">
<domain>
<DomainNameID>340691704</DomainNameID>
<sld>00000000001111</sld>
<tld>com</tld>
<ns-status>YES</ns-status>
<expiration-date>7/7/2012</expiration-date>
<auto-renew>No</auto-renew>
<wppsstatus>disabled</wppsstatus>
<RRProcessor>E</RRProcessor>
</domain>
<domain>
<DomainNameID>152708845</DomainNameID>
<sld>00000startajay</sld>
<tld>info</tld>
<ns-status>NA</ns-status>
<expiration-date>2/4/2011</expiration-date>
<auto-renew>No</auto-renew>
<wppsstatus>disabled</wppsstatus>
<RRProcessor>E</RRProcessor>
</domain>
.
.
.
</domain-list>
<EndPosition>25</EndPosition>
<PreviousRecords>0</PreviousRecords>
<NextRecords>26</NextRecords>
<OrderBy/>
<Result>True</Result>
<StartPosition>1</StartPosition>
<DomainCount>3084</DomainCount>
<TotalDomainCount>3084</TotalDomainCount>
<StartLetter/>
</GetDomains>
<Command>GETDOMAINS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
- 489 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.828</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:27:04 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetExpiredDomains
l GetExtendInfo
l GetHomeDomainList
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetDomainServices
Description
Definition
Retrieve the settings for domain services and value-added services for a domain.
- 490 -
API Command Categories
Usage
Use this command to retrieve information about email forwarding, URL forwarding, and
other domain and valueadd services for a domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
On the domain control panel, change and configure buttons give access to current set-
tings and the ability to change value-add settings.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 491 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 492 -
API Command Categories
Example
The following query retrieves the domain and value-add service settings for reseller-
docs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainServices&uid=resellid&pw=resellpw
&responsetype=xml&sld=resellerdocs&tld=com
<interface-response>
<domainservices>
<website>1</website>
<phone>false</phone>
<ipresolver>1</ipresolver>
<map>true</map>
<domainnameid>152533676</domainnameid>
<mobilizer>1117</mobilizer>
<mobilizersourcedomain/>
<valueadd>
<EmailForwarding>0</EmailForwarding>
<EmailForwardExpDate/>
<EmailAutoRenew/>
<URLForwarding>0</URLForwarding>
<URLForwardExpDate/>
<URLAutoRenew/>
<emailForwardingPrice>0.00</emailForwardingPrice>
<urlForwardingPrice>0.00</urlForwardingPrice>
</valueadd>
</domainservices>
<Command>GETDOMAINSERVICES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
- 493 -
API Command Categories
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.188</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>fa977e24-b1d0-4837-b145-9c26b5f96990</Track-
ingKey>
<RequestDateTime>12/8/2011 4:28:18 AM</RequestDateTime>
</interface-response>
Related commands
l DisableServices
l EnableServices
l GetIPResolver
l ServiceSelect
l SetDomainSubServices
l SetIPResolver
GetDomainSLDTLD
Description
Definition
Retrieve the domain name (SLD and TLD).
Usage
Use this command when you have the domain name ID and want the domain name
(SLD and TLD).
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
- 494 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Done True indicates this entire response has reached you suc-
- 495 -
API Command Categories
Parameter Description
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the SLD and TLD for domain name ID 152533676 and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getdomainsldtld&uid=resellid&pw=resellpw
&domainnameid=152533676&responsetype=xml
<interface-response>
<SLD>resellerdocs</SLD>
<TLD>com</TLD>
<DomainNameID>152533676</DomainNameID>
<Command>GETDOMAINSLDTLD</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
- 496 -
API Command Categories
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 4:53:15 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetDomainInfo
l GetDomainNameID
GetDomainSRVHosts
Description
Definition
Retrieve SRV host records for a domain name.
Usage
Use this command to retrieve a list of all SRV records for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-pan-
el/default.asp?DomainNameID=152533676#
The list of SRV records is populated by the GetDomainSRVHosts command.
Constraints
The query must meet the following requirements:
- 497 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Protocol Internet protocol you have assigned for this SRV record
Fully qualified domain name you have assigned for this SRV
Address
record
Weight you have assigned to this SRV record (for load bal-
Weight
ancing)
Priority Priority you have assigned to this SRV record (for backup serv-
- 498 -
API Command Categories
Parameter Description
ers)
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves SRV records and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETDOMAINSRVHOSTS&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
<interface-response>
<srv-records>
<srv>
<HostID>18459357</HostID>
- 499 -
API Command Categories
<HostName>_imap</HostName>
<Protocol>_TCP</Protocol>
<Address>imap.resellerdocs.com.</Address>
<RecordType>SRV</RecordType>
<mxPref>0</mxPref>
<Weight>50</Weight>
<priority>10</priority>
<Port>1</Port>
</srv>
<srv>
<HostID>18459358</HostID>
<HostName>_xmpp</HostName>
<Protocol>_UDP</Protocol>
<Address>xmpp.resellerdocs.com.</Address>
<RecordType>SRV</RecordType>
<mxPref>0</mxPref>
<Weight>50</Weight>
<priority>10</priority>
<Port>98</Port>
</srv>
</srv-records>
<Command>GETDOMAINSRVHOSTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:31:56 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetDomainInfo
l GetHosts
- 500 -
API Command Categories
l SetDomainSRVHosts
l SetHosts
GetDomainStatus
Description
Definition
Check the registration status of TLDs that do not register in real time.
Usage
Use this command to check the status of domains that do not register in real time (includ-
ing .ca, .co.uk, .org.uk,and others). Because of the delay inherent in the non-real-time
registrations, wait at least five minutes after yourtransaction to run this command, and
run it at intervals of five minutes or longer. This command runs more quicklythan a sim-
ilar command, StatusDomain.
Use this command to retrieve the most recent order ID for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 501 -
API Command Categories
Status of the domain in our database: 0 not in our database 1 in our database and in the
InAccount account cited in this query 2 in our database but in a different account than the one cited in
this query
OrderID Order identification number of the most recent transaction for this domain
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 502 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the status of domain resellerdocs.co.uk and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETDOMAINSTATUS&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=net&orderID=156375934
&ordertype=purchase&responsetype=xml
In the response, the InAccount value 0 and the StatusDesc value Awaiting Registry
Response confirm that the order is currently being processed at the co.uk Registry:
Output
<interface-response>
<DomainStatus>
<DomainName>resellerdocs.net</DomainName>
<InAccount>1</InAccount>
<ExpDate>10/25/2007 5:18:12 AM</ExpDate>
<OrderID>156375934</OrderID>
</DomainStatus>
<Command>GETDOMAINSTATUS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.563</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 5:05:44 AM</RequestDateTime>
- 503 -
API Command Categories
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetDomainSubServices
Description
Definition
Get current settings for domain services (active or inactive).
Usage
Use this command to get which services are enabled to control whether to present the
user the ability to get or update information related to the service. (eg. Host or email for-
warding records). For some services, you can get more detailed information using the
GetDomainServices command.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 504 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=GetDomainSubServices&uid=yourloginid
&pw=yourpassword&sld=domain&tld=com
- 505 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets the subservices of a domain and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=GetDomainSubServices&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
The error count value of 0 confirms that hosts have been set successfully:
Output
<interface-response>
<DomainServices>
<EmailForwarding>True</EmailForwarding>
<HostRecords>True</HostRecords>
</DomainServices>
<Command>GETDOMAINSUBSERVICES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
- 506 -
API Command Categories
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:37:14 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetIPResolver
l ServiceSelect
l SetDomainSubServices
l SetIPResolver
GetDotNameForwarding
Description
Definition
Retrieve the current address for email forwarding by the .name Registry.
Usage
Use this command to retrieve the email forwarding address used by the .name Registry
for forwarding email addressed to this domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
On the domain names menu, click my domains, and then click a .name domain.
- 507 -
API Command Categories
In the email settings box of the domain control panel, the .name email button calls the
GetDotNameForwarding command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must be a .name domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 508 -
API Command Categories
Parameter Description
Status Status
The number of errors if any occurred. If greater than 0 check the Err
ErrCount
(1 to ErrCount) values.
Done True indicates this entire response has reached you successfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the email forwarding address for john.doe.name and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getdotnameforwarding&uid=resellid&pw=resellpw
&sld=john.doe&tld=name&responsetype=xml
- 509 -
API Command Categories
<dotnameforwarding>
<domainname domainnameid="157171163" sld="john.doe" tld-
d="name" />
<status>1</status>
<address>john.doe@resellerdocs.com</address>
</dotnameforwarding>
<Command>GETDOTNAMEFORWARDING</Command>
<ErrCount>0</ErrCount>
<Server>Reseller5</Server>
<Site>enom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l Forwarding
l GetCatchAll
l GetForwarding
l GetPOP3
l SetCatchAll
l SetDotNameForwarding
GetExpiredDomains
Description
Definition
Retrieve a list of an accounts domains that are in Expired, Redemption Grace Period
(RGP), and Extended RGP status.
Usage
Use this command to retrieve a list of Expired, RGP, and Extended RGP names in the
account specified in the query string. Typically, a reseller will use this information to
- 510 -
API Command Categories
determine which command to use to reactivate a domain, and what price they will
charge.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainManager.asp?tab=iown
Clicking the expired or redemption tabs call the GetExpiredDomains command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 511 -
API Command Categories
Parameter Description
DomainNameID Domain name ID number, from our database
Notes Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return paramet If greater than 0 the transaction failed. The parameter Err
(ErrCount) can be presented to the client. Otherwise process the returned para-
meters as defined above. ters as defined above.
Example
The following query retrieves the expired domains in account resellid; identifies them as
Expired, RGP, or Extended RGP status; and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getexpireddomains&uid=resellid
&pw=resellpw&responsetype=xml
- 512 -
API Command Categories
- 513 -
API Command Categories
<lockstatus>Locked</lockstatus>
</DomainDetail>
<DomainDetail>
<DomainName>ccpays.com</DomainName>
<DomainNameID>2082140</DomainNameID>
<status>Extended RGP</status>
<expiration-date>2/26/2011 4:01:46 PM</expiration-date>
<lockstatus>Locked</lockstatus>
</DomainDetail>
.
.
.
<domaincount>120</domaincount>
<Command>GETEXPIREDDOMAINS</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.503906</ExecTime>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l AddToCart
l Extend_RGP
l GetDomainInfo
l GetDomains
l PE_SetPricing
l Purchase
- 514 -
API Command Categories
GetExtAttributes
Description
Definition
This command retrieves the extended attributes for a country code TLD (required para-
meters specific to the country code).
Usage
Use this command to determine whether a country code TLD requires extended attrib-
utes, and what they are.
Extended attributes supplied by this command are used in the Preconfigure command to
configure some TLDs.
Input parameter names for the Preconfigure command are tagged <Name> in the return
of this command, and permitted values for the Preconfigure command are tagged
<Value> in the return for this command.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The country code TLD must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 515 -
API Command Categories
Parameter value for the query string. Use this as the input para-
Value
meter value in the Preconfigure command.
User must supply the value for this parameter from outside
UserDefined
sources
- 516 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ter ErrCount. Err(ErrCount) can be presented to the cli-
ent. Otherwise process the returned parameters as defined above.
Example
The following query requests the extended attributes for the .us TLD and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getextattributes&uid=resellid
&pw=resellpw&tld=us&responsetype=xml
The response indicates that the entended attributes for .us are us_nexus, global_cc_us,
and us_purpose. In the Preconfigure command, these parameters would be input, for
example, as us_nexus=C11&us_purpose=P2:=P2:
Output
- 517 -
API Command Categories
- 518 -
API Command Categories
<Value>P2</Value>
<Title>Non-profit</Title>
<Description>
Non-profit business, club, association, religious organ-
ization, etc.
</Description>
</Option>
.
.
.
</Options>
</Attribute>
</Attributes>
<Command>GETEXTATTRIBUTES</Command>
<ErrCount>0</ErrCount>
<Server>Reseller3</Server>
<Site>enom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA [ ] ]>
</debug>
</interface-response>
Related commands
l AddContact
l Contacts
l GetAddressBook
l GetContacts
l GetWhoisContact
l Preconfigure
GetExtendInfo
Description
Definition
Get extension (renewal) information.
- 519 -
API Command Categories
Usage
Use this command to display information about the expiration date of a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
On the domain control panel page, the add years button calls the GetExtendInfo com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 520 -
API Command Categories
- 521 -
API Command Categories
Parameter Description
Account-level settingTrue automatically renews email for-
MailNumLimit
warding 30 days before the subscription expires
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 522 -
API Command Categories
Example
The following query requests renewal information for resellerdocs.com and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getextendinfo&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<RegistrarHold>False</RegistrarHold>
<Expiration>6/10/2019</Expiration>
<MaxExtension>2</MaxExtension>
<MinAllowed>1</MinAllowed>
<CCAuthorized>True</CCAuthorized>
<Price>8.95</Price>
<Balance>2,491.60</Balance>
<AvailableBalance>2,106.75</AvailableBalance>
<CustomerPrefs>
<DefPeriod>1</DefPeriod>
<AllowDNS>False</AllowDNS>
<ShowPopups>False</ShowPopups>
<AutoRenew>False</AutoRenew>
<RegLock>False</RegLock>
<AutoPakRenew>False</AutoPakRenew>
<UseDNS>True</UseDNS>
<ResellerStatus/>
<RenewalSetting>1</RenewalSetting>
<RenewalBCC>1</RenewalBCC>
<RenewalURLForward>False</RenewalURLForward>
<RenewalEmailForward>False</RenewalEmailForward>
<MailNumLimit>100</MailNumLimit>
<IDProtect>False</IDProtect>
<DefIDProtectRenew>False</DefIDProtectRenew>
<DefWBLRenew>False</DefWBLRenew>
- 523 -
API Command Categories
<NameJetSales>False</NameJetSales>
<defaulthostrecords>
<hostrecord hostname="@" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="*" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="www" address="69.25.142.5" record-
type="A"/>
<hostrecord hostname="" address="" recordtype="A"/>
<hostrecord hostname="" address="" recordtype="A"/>
</defaulthostrecords>
<defaulthostrecordown>False</defaulthostrecordown>
<UseOurDNS>False</UseOurDNS>
<NameServers>
<DNS1>ns1.nicmus.com</DNS1>
<DNS2>ns2.nicmus.com</DNS2>
<DNS3>ns3.nicmus.com</DNS3>
</NameServers>
</CustomerPrefs>
<CustomerInformation>
<AcceptTerms>True</AcceptTerms>
<URL/>
<ParentAccount>000-00-0000</ParentAccount>
<ParentLogin>Main-eNom</ParentLogin>
<NoService>False</NoService>
<BulkRegLimit>100</BulkRegLimit>
<Account>217-no-0647</Account>
</CustomerInformation>
<RRPCode>200</RRPCode>
<RRPText/>
<Command>GETEXTENDINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.393</ExecTime>
- 524 -
API Command Categories
<Done>true</Done>
<RequestDateTime>12/8/2011 4:54:28 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l Extend
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l InsertNewOrder
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l UpdateExpiredDomains
l ValidatePassword
GetFilePermissions
Description
Definition
Retrieves write permissions for a Web hosting folder.
Usage
Use this command to retrieve write permissions for a Web hosting folder.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 525 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The root directory always has write permission.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 526 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the write access permissions for directory testdir and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getfilepermissions&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=testdir&
responsetype=xml
In the response, the Successful value True confirms that the query was successful. In
this example the Permission value R indicates that write permission is currently off for dir-
ectory testdir:
Output
- 527 -
API Command Categories
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l IsFolderEnabled
l ListWebFiles
l MetaBaseGetValue
l MetaBaseSetValue
l SetFilePermissions
l WebHostCreateDirectory
GetForwarding
Description
Definition
Get email forwarding records for a domain name.
- 528 -
API Command Categories
Usage
Use this command to display email forwarding records for a domain name.
A similar command, GetPOPForwarding, displays both email forwarding and POP
records for a single email address.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?domainnameid=152533676
On the domain control panel, if the e-mail settings service is set to e-mail forwarding, the
configure button calls the GetForwarding command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must use eNoms domain name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 529 -
API Command Categories
EmailForwarding True
HostRecords True
- 530 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests e-mail forwarding information for resellerdocs.com and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getforwarding&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<eforward>
<alias>john.doe</alias>
<forward-to>john.doe@example.com</forward-to>
<status>0</status>
<rejectreason/>
<mailid>3370493</mailid>
</eforward>
<EmailCount>1</EmailCount>
<MaxEmail>100</MaxEmail>
<DomainServices>
<EmailForwarding>True</EmailForwarding>
<HostRecords>True</HostRecords>
</DomainServices>
<Command>GETFORWARDING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
- 531 -
API Command Categories
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:56:11 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetCatchAll
l GetDotNameForwarding
l GetMailHosts
l GetPOP3
l ModifyPOP3
l PurchasePOPBundle
l SetDotNameForwarding
l SetUpPOP3User
GetGlobalChangeStatus
Description
Definition
Retrieve a list of IDs for instances in which a global edit command was run on this
account.
Usage
- 532 -
API Command Categories
Use this command to retrieve RequestID values for global edits performed on domains
in this account. Commonly, you will run this command to get a RequestID in order to run
the GetGlobalChangeStatusDetail command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/globaledit.asp
The Click here to view the status and history of your previous global edits link calls the
GetGlobalChangeStatus command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 533 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query Retrieves the global changes that have been requested in account
resellid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetGlobalChangeStatus&UID=resellid
&PW=resellpw&ResponseType=XML
- 534 -
API Command Categories
<interface-response>
<GetGlobalChangeStatus>
<GlobalStatusInfo>
<RequestID>11016</RequestID>
<ReqDate>11/10/2008 12:47:03 PM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>10307</RequestID>
<ReqDate>3/7/2008 9:00:07 AM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>10306</RequestID>
<ReqDate>3/7/2008 8:50:35 AM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>10305</RequestID>
<ReqDate>3/7/2008 6:43:10 AM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>9908</RequestID>
<ReqDate>11/9/2006 4:01:29 PM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8893</RequestID>
<ReqDate>2/24/2004 11:02:58 AM</ReqDate>
<ReqTypeDesc>Registrar-lock off</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8892</RequestID>
<ReqDate>2/23/2004 7:03:53 PM</ReqDate>
<ReqTypeDesc>Registrar-lock off</ReqTypeDesc>
- 535 -
API Command Categories
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8891</RequestID>
<ReqDate>2/23/2004 6:55:23 PM</ReqDate>
<ReqTypeDesc>Registrar-lock off</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8890</RequestID>
<ReqDate>2/23/2004 6:44:18 PM</ReqDate>
<ReqTypeDesc>Registrar-lock off</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8889</RequestID>
<ReqDate>2/23/2004 6:41:58 PM</ReqDate>
<ReqTypeDesc>Registrar-lock on</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8343</RequestID>
<ReqDate>9/3/2003 5:29:13 PM</ReqDate>
<ReqTypeDesc>Registrar-lock on</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8342</RequestID>
<ReqDate>9/3/2003 5:29:13 PM</ReqDate>
<ReqTypeDesc>Auto renew on</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8341</RequestID>
<ReqDate>9/3/2003 5:22:27 PM</ReqDate>
<ReqTypeDesc>Registrar-lock on</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8340</RequestID>
<ReqDate>9/3/2003 5:22:27 PM</ReqDate>
<ReqTypeDesc>Auto renew on</ReqTypeDesc>
- 536 -
API Command Categories
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8339</RequestID>
<ReqDate>9/3/2003 5:12:04 PM</ReqDate>
<ReqTypeDesc>Contact changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
<GlobalStatusInfo>
<RequestID>8210</RequestID>
<ReqDate>4/25/2003 3:00:03 AM</ReqDate>
<ReqTypeDesc>Custom DNS changes</ReqTypeDesc>
<ReqStatusDesc>Complete</ReqStatusDesc>
</GlobalStatusInfo>
</GetGlobalChangeStatus>
<Command>GETGLOBALCHANGESTATUS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.453</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:57:39 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetGlobalChangeStatusDetail
GetGlobalChangeStatusDetail
Description
Definition
- 537 -
API Command Categories
Retrieve a list of the domains affected by the specified global update, and the success
status for each.
Usage
Use this command to check the success of global changes.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/domains/globalaccountstatus.asp
Clicking any of the RequestID links calls the GetGlobalChangeStatusDetail command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The ResponseID must match a global update that was performed in this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 538 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the status for each domain affected by global change
RequestID=8331 and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetGlobalChangeStatusDetail&UID=resellid
- 539 -
API Command Categories
&PW=resellpw&RequestID=8331&ResponseType=XML
<interface-response>
<GetGlobalChangeStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart070103.biz</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart070103.com</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart070803.biz</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart070803.com</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart071703.com</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
<GlobalStatusDetail>
<DomainName>enomretailcart071703.us</DomainName>
<StatusDesc>Processed successfully</StatusDesc>
<ErrorDesc>none</ErrorDesc>
</GlobalStatusDetail>
</GetGlobalChangeStatusDetail>
<Command>GETGLOBALCHANGESTATUSDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
- 540 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.469</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 4:59:20 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetGlobalChangeStatus
GetHomeDomainList
Description
Definition
Retrieve a list of registered and hosted domains in this account that use our domain
name servers.
Usage
Use this command to retrieve a list of registered and hosted domains in this account that
use our domain name servers.
A typical use of this command is to retrieve domains that are eligible to use our DNS-
dependent services.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/websitecreator/wscsignup.asp
- 541 -
API Command Categories
For accounts with 25 or fewer domain names that use our DNS, the Select a domain text
box is a dropdown menu populated by the GetHomeDomainList command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 542 -
API Command Categories
Parameter Description
Name Domain name
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of domains in this account that use our DNS servers,
sorted by TLD, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETHOMEDOMAINLIST&uid=resellid&pw=resellpw
&display=25&orderby=tld&responsetype=xml
<interface-response>
<GetHomeDomains>
<StartPosition/>
- 543 -
API Command Categories
<Display>25</Display>
<OrderBy>tld</OrderBy>
<NewStartPosition>26</NewStartPosition>
<DomainCount>25</DomainCount>
<TotalDomains>3274</TotalDomains>
<Domains>
<Domain>
<ID>152926976</ID>
<Name>vras.ac</Name>
<RegStatus>Registered</RegStatus>
</Domain>
<Domain>
<ID>152926784</ID>
<Name>fert.am</Name>
<RegStatus>Registered</RegStatus>
</Domain>
.
.
.
</Domains>
</GetHomeDomains>
<Command>GETHOMEDOMAINLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.018</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 5:00:45 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddToCart
l GetAllDomains
- 544 -
API Command Categories
l GetDomains
l GetReport
l PurchaseServices
GetHostAccount
Description
Definition
Retrieve account and usage information about a Web hosting account.
Usage
Use this command to retrieve account information, limits, and this months usage-to-date
information for a Web hosting account.
To retrieve day-by-day usage information, use the WebHostGetStats command.
To retrieve bandwidth overage information for end-of-month account reconciliation, use
the
GetAccountOverages command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/packagemanager.asp
Links in the Login Name column call the GetHostAccount command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
Input parameters
Build the query string using this syntax:
- 545 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 546 -
API Command Categories
Parameter Description
POPMailBoxes POP mail boxes allocated to this domain name
Price Subscription rate for this Web hosting account, per billing cycle
SQLTableCount Number of SQL tables defined for this Web hosting account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 547 -
API Command Categories
Example
The following query requests information on Web hosting account resellwebid and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETHOSTACCOUNT&uid=resellid&pw=resellpw
&HostAccount=resellwebid&responsetype=xml
- 548 -
API Command Categories
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CreateHostAccount
l GetAllHostAccounts
GetHostAccounts
Description
Definition
Retrieve a list of all Web hosting accounts in a domain name account, with attributes.
Usage
Use this command to list Web hosting accounts and their current configurations.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/
In the left-hand menu, the manage link calls the GetHostAccounts command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 549 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 550 -
API Command Categories
Parameter Description
Date on which this Web hosting account will be deleted, if Ter-
TerminateDateX
minate=True
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following queThe following query retrieves a list of the Web hosting accounts in
domain name account resellid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETHOSTACCOUNTS&uid=resellid&pw=ruid=resellid
&pw=resellpw&responsetype=xml
In the response, the list of Web hosting account names and properties, and the Web host-
ing PackageCount, indicate that the query was successful:
Output
- 551 -
API Command Categories
- 552 -
API Command Categories
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CreateHostAccount
l GetAllHostAccounts
l GetHostAccount
GetHostHeader
Description
Definition
List attributes of a host header (pointer for a third-level domain name) in your Web host-
ing account.
Usage
Use this command to retrieve information about a host header in your Web hosting
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
- 553 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
HostHeaderFound Return status of the host header; whether the software found
- 554 -
API Command Categories
Parameter Description
the host header
Notes
l The default response format is plain text. To receive the response in HTML or XML-
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query asks whether there is a host header accountspayable under domain
header resellerdocs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=gethostheader&uid=resellid&pw=resellpw
&hostaccount=resellwebid&sld=resellerdocs&tld=com
&hostname=accountspayable&responsetype=xml
In the response, a return value of True for the HostHeaderFound parameter indicates
that the specified host header exists:
Output
- 555 -
API Command Categories
<HostHeader>
<HostName>accountspayable</HostName>
<Path>/accounts</Path>
<HostHeaderID>457</HostHeaderID>
<Successful>True</Successful>
<HostHeaderFound>True</HostHeaderFound>
</HostHeader>
<Command>GETHOSTHEADER</Command>
<ErrCount>0</ErrCount>
<Server>TEST3</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DeleteHostHeader
l GetAllHostAccounts
l GetHostAccount
l ListHostHeaders
GetHosts
Description
Definition
Get host records for a domain name.
Usage
Use this command to return all host records. GetRegHosts, a similar command, does not
return mail host records.
- 556 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
On the domain control panel, the DNS settings (zone file) box retrieves its information
using the GetHosts command. Clicking the configure button brings up the GetHosts com-
mand in editable form.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must use eNoms domain name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 557 -
API Command Categories
Preference level: the lower this value, the higher priority this
MXPref
service. Default value is 10.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests all host records, including mail hosts, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
- 558 -
API Command Categories
command=gethosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<host>
<name>@</name>
<type>A</type>
<address>66.150.5.189</address>
<hostid>18149735</hostid>
</host>
<host>
<name>photos</name>
<type>CNAME</type>
<address>photos.msn.com.</address>
<hostid>18487894</hostid>
</host>
<host>
<name>yahoo</name>
<type>URL</type>
<address>204.71.200.72</address>
<hostid>18487895</hostid>
</host>
<host>
<name>msn</name>
<type>FRAME</type>
<address>http://www.msn.com</address>
<hostid>18487896</hostid>
</host>
<host>
<name>mail</name>
<type>MXE</type>
<mxpref>10</mxpref>
<address>209.19.56.20</address>
<hostid>18492166</hostid>
</host>
<DomainServices>
<EmailForwarding>True</EmailForwarding>
<HostRecords>True</HostRecords>
- 559 -
API Command Categories
</DomainServices>
<Command>GETHOSTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.172</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 5:02:39 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetMetaTag
l GetRegHosts
l GetSPFHosts
l SetDNSHost
l SetHosts
l SetSPFHosts
l UpdateMetaTag
GetIDNCodes
Description
Definition
Retrieve a list of language codes currently supported for a TLD.
Usage
Use this command to retrieve a list of language codes currently supported for a TLD.
Availability
All resellers have access to this command.
- 560 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.comwith Login ID resellid, password resellpw.
Go to: https://resellertest.enom.com/domains/PreConfigure.asp
With a configurable domain in the cart, click the configure button below the list of cart
contents.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 561 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves list of language codes currently supported for a TLD, and
requests the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
Command=GetIDNCodes&UID=ResellID
&PW=resellpw&ResponseType=XML&TLD=com
Output
- 562 -
API Command Categories
</tlds>
<Command>GETIDNCODES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.047</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>12/12/2012 12:12:12 AM</RequestDateTime>
<debug />
</interface-response>
Related commands
l Purchase
l Preconfigure
GetIPResolver
Description
Definition
Get IP Resolver settings.
Usage
Use this command to retrieve the NameMyComputer settings for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 563 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 564 -
API Command Categories
Parameter Description
Client-Service Currently only service type 1 for ICQ.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests IP resolver information for the domain resellerdocs.com,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getipresolver&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
The response indicates that the IP resolver host name is home, and the client user ID is
12345678:
Output
- 565 -
API Command Categories
<interface-response>
<GetIPResolver>
<domainname sld="resellerdocs" tld="com" id="152533676">r-
resellerdocs.com</domainname>
<configuration>
<ipresolver>
<ip-resolver-id>1243</ip-resolver-id>
<host-name>home</host-name>
<client-service>1</client-service>
<client-user-id>12345678</client-user-id>
</ipresolver>
</configuration>
<options>
<clients>
<client>
<id>1</id>
<name>ICQ</name>
<short-name>icq</short-name>
<description>ICQ</description>
</client>
</clients>
</options>
</GetIPResolver>
<Command>GETIPRESOLVER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.203</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 5:04:05 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 566 -
API Command Categories
Related commands
l ServiceSelect
l SetIPResolver
GetMailHosts
Description
Definition
Get mail hosts (DNS information) only.
Usage
Use this command to retrieve the mail records associated with a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must use eNoms domain name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 567 -
API Command Categories
Preference level: the lower this value, the higher priority this
MXPrefX
service. Default value is 10.
- 568 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the mail host information for the domain resellerdocs.com,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getmailhosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<mailhosts>
<EmailForwarding>False</EmailForwarding>
<host>
<hostID/>
<HostName>@ (none)</HostName>
<RecordType>MX</RecordType>
<Address/>
<MXPref>10</MXPref>
</host>
<host>
<hostID/>
<HostName/>
<RecordType>MX</RecordType>
<Address/>
<MXPref>10</MXPref>
</host>
<host>
- 569 -
API Command Categories
<hostID/>
<HostName/>
<RecordType>MX</RecordType>
<Address/>
<MXPref>10</MXPref>
</host>
<host>
<hostID/>
<HostName/>
<RecordType>MX</RecordType>
<Address/>
<MXPref>10</MXPref>
</host>
<host>
<hostID/>
<HostName>* (other)</HostName>
<RecordType>MX</RecordType>
<Address/>
<MXPref>10</MXPref>
</host>
<LastNum-
berFromRegHostCounter>10</LastNumberFromRegHostCounter>
<MailHostCount>15</MailHostCount>
</mailhosts>
<ParkingEnabled>False</ParkingEnabled>
<ServiceSelect/>
<Command>GETMAILHOSTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.297</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 5:19:02 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 570 -
API Command Categories
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetForwarding
l GetPOP3
l ModifyPOP3
l PurchasePOPBundle
l SetUpPOP3User
GetMetaTag
Description
Definition
Retrieve the metatags for one of a domains host records.
Usage
Use this command to retrieve the current metatags for one host record for a domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with login ID resellid, password resellpw.
https://resellertest.enom.com/domains/HostConfig.asp?DomainNameID=152533676
After you assign to a host record a record type of URL Frame, then click save changes,
then in the DNS Settings (zone file) section click configure, the edit link calls the
GetMetaTag command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 571 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 572 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the HTML metatag contents for the specified host record,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getmetatag&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&MetaTagHostID=11415002
&ResponseType=XML
- 573 -
API Command Categories
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetHosts
l GetRegHosts
l SetHosts
l UpdateMetaTag
GetNameSuggestions
Description
Definition
Generate variations of a domain name based on a search term.
Usage
Use this command to generate variations of the domain name you specify. This com-
mand will return a list of domains across a variety of sld/tld combinations.
Availability
All resellers have access to this command.
Implementation on eNom.com
http://resellertest.enom.com/domainsearch/search-results.aspx
Type an SLD into the Register A New Domain box and click GO. The results in the
Related section are generated by the GetNameSuggestions command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l A search term must be passed in.
- 574 -
API Command Categories
Input parameters
Build the query string using this syntax:
http://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 575 -
API Command Categories
Max
Parameter Status Description
Size
False.
Idn Is this domain an IDN. True indicates yes; False indicates no.
In_GA Is this TLD in GA. True indicates yes; False indicates no.
- 576 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Note: The Premium output attribute is a best guess based on data provided by the
registries. This data is subject to change on a daily basis, so for the best results it
is recomended to do a an EPP Check (Check API Command) on any domain to
verify the domain is premium.
Example
The following query retrieves 8 domains that resemble the input SLD hand, and sends
the response in XML format:
Query
http://resellertest.enom.com/interface.asp?
command=GETNAMESUGGESTIONS&UID=resellid
&PW=resellpw&SearchTerm=hand&MaxResults=5
&ResponseType=XML
In the response, the presence of spun names and the ErrCount value 0 indicate that the
query was successful:
Output
<interface-response>
<DomainSuggestions>
<Domain score="0.3" tld="uno" sld="hand" idn="false" in_
ga="true" premium="false">hand.uno</Domain>
<Domain score="0.25" tld="co.com" sld="hand" idn="false"
in_ga="true" premium="false">hand.co.com</Domain>
<Domain score="0.22" tld="best" sld="hand" idn="false" in_
ga="true" premium="false">hand.best</Domain>
<Domain score="0.21" tld="guru" sld="hand" idn="false" in_
ga="true" premium="false">hand.guru</Domain>
<Domain score="0.18" tld="shop" sld="hand" idn="false" in_
ga="true" premium="false">hand.shop</Domain>
- 577 -
API Command Categories
</DomainSuggestions>
<DomainSuggestionCount>5</DomainSuggestionCount>
<Command>GETNAMESUGGESTIONS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.750</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>9efbb8e7-1cc3-4f2b-bbc2-cbe2517522aa</Track-
ingKey>
<RequestDateTime>12/9/2011 3:33:28 AM</RequestDateTime>
</interface-response>
Related commands
l AddToCart
l Check
l Purchase
GetNews
Description
Definition
Getting registry maintenance schedule details.
Usage
Use this command to get registry maintenance alert messages.
Availability
All resellers have access to this command.
- 578 -
API Command Categories
Implementation on eNom.com
This command is implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 579 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query is used to get registry maintenance alerts that have been requested
in account resellid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetNews&uid=resellid&pw=resellpw&responsetype=xml
<interface-response>
<Alerts>
<Alert>
<Product>
<![CDATA[ cn ]]>
</Product>
<Message>
<![CDATA[
CNNIC, the registry that manages .CN registrations has made
a temporary policy
decision to stop all new .CN registrations effective Jan
06, 2010. Renewals will
continue to work as expected. Meanwhile all attempts to
register new .CN domains
- 580 -
API Command Categories
Related commands
l GetProductNews
GetOrderDetail
Description
Definition
Get detailed information about an order.
- 581 -
API Command Categories
Usage
Use this command to retrieve contents and details of an order when you know the order
number.
Use this command to monitor status when an order includes non-real-time domain
names (names that, at the time you submit the order, have an RRPCode value of 1300
and an IsRealTimeTLD value of false).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/ViewOrders.asp
On the view orders page, clicking a link in the Order # column calls the GetOrderDetail
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 582 -
API Command Categories
Status for fulfilling the order for this item. Only a status Suc-
Status cessful indicates that the Registry has registered this name to
you.
Amount paid for this item. If the Registry has processed this
name and has not registered it to you, the AmountPaid va lue is
AmountPaid
Not billed. If the value is Not billed, check the Status parameter
for the reason for failure.
- 583 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the details of order 156062775, and requests the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetOrderDetail&uid=resellid&pw=resellpw
&orderid=157770751&responsetype=xml
The response indicates that in this order, the account successfully purchased 2
products:
Output
<interface-response>
<Order>
<OrderID>157770751</OrderID>
<Result>true</Result>
<BillDate>11/7/2011 5:40:05 AM</BillDate>
- 584 -
API Command Categories
<CCRefNum/>
<OrderBillAmount>$8.95</OrderBillAmount>
<AdjustToAccount/>
<Certs>false</Certs>
<OrderStatus>6</OrderStatus>
<StatusDesc>Successful</StatusDesc>
<OrderDate>11/7/2011 5:37:42 AM</OrderDate>
<OrderDetail>
<ProductType>Register</ProductType>
<Description>testnum10.com</Description>
<Status>Successful</Status>
<Quantity>1</Quantity>
<DetailStatusID>9</DetailStatusID>
<AmountPaid>8.95</AmountPaid>
<DomainPassword/>
<OrderStatus>Closed</OrderStatus>
<BundleID/>
<BundleInstanceID/>
<Discount/>
<BundleDescription/>
<BundleName/>
<ExpiryDatetime>11/7/2012 5:37:00 AM</ExpiryDatetime>
</OrderDetail>
</Order>
<Command>GETORDERDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.344</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>caef4da0-86af-4684-9232-2346b034789f</Track-
ingKey>
<RequestDateTime>12/8/2011 5:09:40 AM</RequestDateTime>
</interface-response>
- 585 -
API Command Categories
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetDomainStatus
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l RPT_GetReport
l UpdateAccountInfo
l UpdateCusPreferences
GetOrderList
Description
Definition
Get a list of the orders placed through this account.
Usage
Use this command to retrieve a list of orders, identified by order number.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/myaccount/newreports.asp
In the Report Categories menu, select the view orders option. Clicking the view report
button calls the GetOrderList command.
- 586 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Optional; if omit-
ted, six months of Must be no more than six months before
BeginDate orders are returned EndDate. Permitted format is 10
Beginning date of MM/DD/YYYY
orders to return.
Optional; if omit-
Must be no more than six months after
ted, EndDate is
EndDate BeginDate. Permitted format is 10
today End date of
MM/DD/YYYY
orders to return.
OrderDate Date on which the order was placed. Time stamp indicates the
- 587 -
API Command Categories
Parameter Description
time at which our database received the order.
Yes/No -- Yes displays a link that calls the next block of trans-
ShowNextLink
actions.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 588 -
API Command Categories
Example
The following query requests a list of orders successfully submitted through account
resellid. The optional Start=26 parameter specifies that the list should start with the 26th
most recent order. The query requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetOrderList&uid=resellid
&pw=resellpw&Start=26&responsetype=xml
The response gives an overview of orders starting with the 26th most recent. Normally,
the response would include the 26th through 50th most recent orders; this response
ends with the 37th because only 37 orders have been placed in the lifetime of the
account:
Output
<interface-response>
<OrderList>
<BeginDate>6/8/2011 5:11:16 AM</BeginDate>
<EndDate>12/8/2011 5:11:16 AM</EndDate>
<OrderDetail>
<OrderID>157772597</OrderID>
<OrderDate>11/10/2011 5:09:09 AM</OrderDate>
<StatusDesc>Order complete</StatusDesc>
<OrderProcessFlag>True</OrderProcessFlag>
</OrderDetail>
<OrderDetail>
<OrderID>157772596</OrderID>
<OrderDate>11/10/2011 5:09:09 AM</OrderDate>
<StatusDesc>Order complete</StatusDesc>
<OrderProcessFlag>True</OrderProcessFlag>
</OrderDetail>
.
.
.
<ShowPreviousAndNext>Yes</ShowPreviousAndNext>
<ShowPreviousLink>Yes</ShowPreviousLink>
<PreviousStartPosition>1</PreviousStartPosition>
<ShowStart>26</ShowStart>
- 589 -
API Command Categories
<ShowEnd>50</ShowEnd>
<ShowNextLink>Yes</ShowNextLink>
<NextStartPosition>51</NextStartPosition>
<RecordCount>1020</RecordCount>
</OrderList>
<Command>GETORDERLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.391</ExecTime>
<Done>true</Done>
<RequestDateTime>12/8/2011 5:11:18 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetOrderDetail
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l RPT_GetReport
l UpdateAccountInfo
l UpdateCusPreferences
- 590 -
API Command Categories
GetPasswordBit
Description
Definition
Check to see if a password is set for a domain name.
Usage
Use this command to determine whether a password is set for a domain name, and what
the password is.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
On the domain control panel, in the utilities box, the Domain Access Password link calls
the GetPasswordBit command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 591 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the domain name password for resellerdocs.com, and
requests the response in XML format:
Query
- 592 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=getpasswordbit&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
In the response, the password-set value of 1 indicates that a password is set. The
DomainPassword value indicates that the domain password is userpw.
Output
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
- 593 -
API Command Categories
GetPOP3
Description
Definition
Gets all POP3 accounts for a domain name.
Usage
Use this command to generate a list of the POP mail accounts belonging to a domain
name. Return information includes mailbox names and BundleID numbers for the
domains POP paks.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
In the domain control panel, email settings box, if the current service is POP mail, click-
ing the configure button calls the GetPOP3 command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must use eNoms domain name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 594 -
API Command Categories
POP user name for this email account (this mailbox). Indexed
UsernameX
X = 1 to
Auto-renewal setting for this POP3 account and its POP pak. 1
AutoRenewX signifies that auto-renew is on, 0 off. Indexed X = 1 to
EmailCount if ResponseType=text or HTML.
- 595 -
API Command Categories
Parameter Description
Total number of POP accounts that have been purchased for
[Pak]QtyPurchasedX this domain name. Prefixed xed X = 1 to Count if Respon-
seType=text or HTML.
Notes
l The default response format is plain textThe default response format is plain text.
To receive the response in HTML or XML format, send ResponseType=HTML or
ResponseType=XML in your request.
l Check the return parameter eater than 0 the transaction failed If greater than 0 the
transaction failed. The parameter Err(ErrCount) can be presented to the client.
Otherwise process the returned parameters as defined above.
Example
The following query requests a list of alThe following query requests a list of all POP
mail accounts in resellerdocs.com, and requests the response in XML format:
Query
- 596 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=getpop3&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
The response lists the eight POP mail accounts that belong to resellerdocs.com. Four
are part of bundle 26770 and one is from bundle 26771:
Output
<interface-response>
<pop>
<username>dell</username>
<password>78910</password>
<quota>1024</quota>
<expdate>5/3/2010 2:14:59 AM</expdate>
<BundleId>26770</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>hp</username>
<password>78910</password>
<quota>1024</quota>
<expdate>5/3/2010 2:14:59 AM</expdate>
<BundleId>26770</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>lenovo</username>
<password>1111</password>
<quota>1024</quota>
<expdate>5/3/2010 2:14:59 AM</expdate>
<BundleId>26770</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>sss</username>
- 597 -
API Command Categories
<password>aaaaaaa</password>
<quota>1024</quota>
<expdate>5/3/2010 2:14:59 AM</expdate>
<BundleId>26770</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>facebook</username>
<password>78910</password>
<quota>1024</quota>
<expdate>5/3/2010 2:15:51 AM</expdate>
<BundleId>26771</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>google</username>
<password>78910</password>
<quota>1024</quota>
<expdate>5/3/2010 2:15:51 AM</expdate>
<BundleId>26771</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>instragram</username>
<password>1111</password>
<quota>1024</quota>
<expdate>5/3/2010 2:15:51 AM</expdate>
<BundleId>26771</BundleId>
<AutoRenew>0</AutoRenew>
<admin>0</admin>
<quotaused>0</quotaused>
</pop>
<pop>
<username>twitter</username>
<password>1111</password>
<quota>1024</quota>
- 598 -
API Command Categories
- 599 -
API Command Categories
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.047</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>9940727e-36fd-4b47-92f8-732af897c07a</Track-
ingKey>
<RequestDateTime>12/8/2011 5:14:56 AM</RequestDateTime>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetCatchAll
l GetForwarding
l GetMailHosts
l GetPOPExpirations
l GetPOPForwarding
l ModifyPOP3
l PurchasePOPBundle
l RenewPOPBundle
l SetPakRenew
l SetPOPForwarding
l SetUpPOP3User
GetPOPExpirations
Description
Definition
Retrieve a list of POP paks and their expiration dates, and the domains they are asso-
ciated with.
Usage
Use this command to retrieve a list of POP paks and their expiration dates, and the
domains they are associated with.
- 600 -
API Command Categories
This command allows you to synchronize your database with ours. In particular, you can
use it to identify POP paks that are about to expire or have recently expired, update the
expiration dates of POP paks that were renewed in a site other than yours, or retrieve the
expiration date of POP paks associated with domains that were transferred or pushed
into your account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
In the email settings section, the configure button returns expiration dates for POP mail
paksone component of the information retrieved by the GetPOPExpirations command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 601 -
API Command Categories
ID number of this POP pak, from our internal records. Use this
ID number to renew the POP pak using the RenewPOPBundle
BundleIDX
command. The response is indexed X if ResponseType=text or
HTML.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves POP pak expiration dates, and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=GetPOPExpirations&uid=resellid
&pw=resellpw&responsetype=xml
- 602 -
API Command Categories
In the response, the list of POP paks and the ErrCount value 0 confirm that the query
was successful:
Output
<interface-response>
<popexpirations>
<pop>
<domain>1986anotherappz.us</domain>
<bundleid>30631</bundleid>
<expdate>10/25/2012 2:13:57 AM</expdate>
</pop>
<pop>
<domain>1986anotherappz.us</domain>
<bundleid>30630</bundleid>
<expdate>10/25/2012 2:12:18 AM</expdate>
</pop>
.
.
.
<count>125</count>
</popexpirations>
<Command>GETPOPEXPIRATIONS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.234</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>0a7ee088-86c5-4067-885c-d141144e8ae7</Track-
ingKey>
<RequestDateTime>12/9/2011 2:21:48 AM</RequestDateTime>
</interface-response>
- 603 -
API Command Categories
Related commands
l Extend
l GetPOP3
l GetRenew
l Purchase
l PurchasePOPBundle
l RenewPOPBundle
GetPOPForwarding
Description
Definition
Retrieve the email forwarding recordeither POP or our email forwardingfor a spe-
cified mailbox name.
Usage
Use this command to retrieve the email forwarding record for a specified mailbox user
name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
In the Email Settings section, the configure button retrieves forwarding records in a man-
ner similar to the GetPOPForwarding command.
Constraints
- 604 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 605 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the email forwarding record for Jane.Doe@re-
sellerdocs.com and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETPOPFORWARDING&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&username=Jane.Doe
&ResponseType=xml
In the response, the presence of the popforwarding node and the absence of an
ErrString parameter confirm that the query was successful:
Output
<interface-response>
<popforwarding>
<domainname>resellerdocs.com</domainname>
<domainnameid>152533676</domainnameid>
<username>Jane.Doe</username>
<forwardto/>
<active/>
</popforwarding>
<Count>0</Count>
<Command>GETPOPFORWARDING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
- 606 -
API Command Categories
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>1.063</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>0a5b34f2-b363-41f0-8686-4f64c8e32f30</Track-
ingKey>
<RequestDateTime>12/9/2011 2:24:10 AM</RequestDateTime>
</interface-response>
Related commands
l DeletePOP3
l GetCatchAll
l GetPOP3
l PurchasePOPBundle
l SetPOPForwarding
l SetUpPOP3User
GetProductNews
Description
Definition
Getting product maintenance schedule details at a time.
Usage
Use this command to get product maintenance alert messages.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is implemented on enom.com.
- 607 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 608 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query is used to get maintenance alert for the products that have been
requested in account resellid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETPRODUCTNEWS&uid=resellid
&pw=resellpw&responsetype=xml&
<interface-response>
<Alerts>
<Total>0</Total>
</Alerts>
<Command>GETPRODUCTNEWS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.078</ExecTime>
<Done>true</Done>
- 609 -
API Command Categories
<TrackingKey>b1bcb817-53ce-4c7f-ba6a-dd853d1f4de0</Track-
ingKey>
<RequestDateTime>11/14/2012 2:55:24 AM</RequestDateTime>
<debug/>
</interface-response>
Related commands
l GetNews
GetProductSelectionList
Description
Definition
Retrieve a list of sorting or filtering values (such as status values) for a given product.
Usage
Use this command to retrieve options for placement in a sorting or filtering selection form
field for a given product.
Availability
All resellers have access to this command
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 610 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
- 611 -
API Command Categories
Example
The following query retrieves a list of SiteLock account for this login ID, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetProductSelectionList&UID=resellid
&PW=resellpw&ResponseType=XML
&Action=status
Output
<?xml version="1.0"?>
<interface-response>
<GetProductSelectionList>
<ProdType>260</ProdType>
<ProdDesc />
<Action>status</Action>
<Statuses>
<Status>
<ID>1</ID>
<Desc>Awaiting Configuration</Desc>
</Status>
<Status>
<ID>2</ID>
<Desc>Service Active</Desc>
</Status>
<Status>
<ID>7</ID>
<Desc>Pending Expiration</Desc>
</Status>
<Status>
<ID>8</ID>
<Desc>Service Expired</Desc>
</Status>
</Statuses>
<SubStatuses>
<SubStatus>
- 612 -
API Command Categories
<ID>1</ID>
<Desc>Auto Renew Off</Desc>
</SubStatus>
<SubStatus>
<ID>2</ID>
<Desc>Billing Failed CC</Desc>
</SubStatus>
<SubStatus>
<ID>3</ID>
<Desc>Billing Failed Balance</Desc>
</SubStatus>
</SubStatuses>
</GetProductSelectionList>
<Success>True</Success>
<Command>GETPRODUCTSELECTIONLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.016</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>4/11/2012 11:11:00 AM</RequestDateTime>
</interface-response>
Related commands
l SL_GetAccountDetail
l SL_GetAccounts
- 613 -
API Command Categories
GetRegHosts
Description
Definition
Get host records for a domain without mail host records.
Usage
Use this command to display host record information for a domain. The response does
not include mail host entries. GetHosts, a similar command, returns all host records
including mail host records.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?domainnameid=152533676
In the domain control panel, DNS settings box, the configure button calls the
GetRegHosts command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must use eNoms domain name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 614 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 615 -
API Command Categories
Example
The following query requests the DNS host records for a domain name, specifies
ExtFormat=1 to enclose the host records in a separate tag, and requests the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getreghosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ExtFormat=1&responsetype=xml
<interface-response>
<hostrecords>
<host>
<hostID/>
<HostName>www</HostName>
<Address/>
<RecordType>CNAME</RecordType>
</host>
<host>
<hostID>18149735</hostID>
<HostName>@ (none)</HostName>
<Address>66.150.5.189</Address>
<RecordType>A</RecordType>
</host>
<host>
<hostID>18487896</hostID>
<HostName>msn</HostName>
<Address>http://www.msn.com</Address>
<RecordType>FRAME</RecordType>
</host>
<host>
<hostID>18487894</hostID>
<HostName>photos</HostName>
<Address>photos.msn.com.</Address>
<RecordType>CNAME</RecordType>
- 616 -
API Command Categories
</host>
<host>
<hostID>18487895</hostID>
<HostName>yahoo</HostName>
<Address>204.71.200.72</Address>
<RecordType>URL</RecordType>
</host>
<host>
<hostID/>
<HostName/>
<Address/>
<RecordType>A</RecordType>
</host>
<host>
<hostID/>
<HostName/>
<Address/>
<RecordType>A</RecordType>
</host>
<host>
<hostID/>
<HostName/>
<Address/>
<RecordType>A</RecordType>
</host>
<host>
<hostID/>
<HostName/>
<Address/>
<RecordType>A</RecordType>
</host>
<host>
<hostID/>
<HostName>* (other)</HostName>
<Address/>
<RecordType>CNAME</RecordType>
</host>
</hostrecords>
<ParkingEnabled>False</ParkingEnabled>
<ServiceSelect>1114</ServiceSelect>
<Command>GETREGHOSTS</Command>
<Language>eng</Language>
- 617 -
API Command Categories
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>1.047</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 2:26:00 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetHosts
l GetMetaTag
l SetDNSHost
l SetHosts
l UpdateMetaTag
GetRegistrationStatus
Description
Definition
Get the registration and paid status of a domain name.
Usage
Use this command to get the registration status and paid status of domains in your
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 618 -
API Command Categories
https://resellertest.enom.com/domains/DomainManager.asp?tab=iown
This command is not implemented on enom.com; however, the registered tab of the my
domains page returns similar information.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 619 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves information on whether the domain name resellerdocs.com
is registered and paid for, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getregistrationstatus&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
- 620 -
API Command Categories
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
GetRegLock
Description
Definition
Get the registrar lock setting for a domain name.
Usage
Use this command to determine whether one of your domain names is locked, that is,
whether it is protected from being transferred to another registrar.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 621 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 622 -
API Command Categories
Parameter Description
RRPText Response text from Registry.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the lock status of a domain name, and sends the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getreglock&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
In the response, the reg-lock value of 1 indicates that the domain name is locked:
Output
<interface-response>
<reg-lock>1</reg-lock>
<registrar>eNom</registrar>
<RRPCode>200</RRPCode>
- 623 -
API Command Categories
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
- 624 -
API Command Categories
GetRenew
Description
Definition
Get the auto-renew setting for a domain name.
Usage
Use this command to determine whether a domain in your account is set to renew auto-
matically. If so, the renewal is charged to your account a month before the expiration
date for the domain name. Fifteen days before that, you receive an email notifying you of
the auto-renew charges.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676
In the domain control panel, utilities box, the Set reg-lock/auto-renew options link calls
the GetRenew command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 625 -
API Command Categories
Returns 1 if the POP paks for this domain are set to auto-
AutoPakRenew
renew, 0 otherwise.
- 626 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the auto-renew status of resellerdocs.com and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getrenew&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
In the response, the auto-renew value of 1 indicates that the domain is set to auto-
matically renew:
Output
<interface-response>
<auto-renew>1</auto-renew>
<AutoPakRenew>0</AutoPakRenew>
<PakExist>1</PakExist>
<EmailForwardRenew>0</EmailForwardRenew>
<EmailFwdExists>0</EmailFwdExists>
<URLForwardRenew>0</URLForwardRenew>
<URLFwdExists>0</URLFwdExists>
<IDProtectRenew>0</IDProtectRenew>
<IDProtectExists>1</IDProtectExists>
<MobilizerRenew>0</MobilizerRenew>
<Command>GETRENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
- 627 -
API Command Categories
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 2:29:36 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l Extend
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetPasswordBit
l GetPOPExpirations
l GetRegLock
l GetSubAccountPassword
l InsertNewOrder
l RenewPOPBundle
l SetPakRenew
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l UpdateExpiredDomains
l ValidatePassword
GetReport
Description
Definition
- 628 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 629 -
API Command Categories
- 630 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a report on account resellid, and requests the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getreport&uid=resellid&pw=resellpw
&responsetype=xml
In the response, the ReportDetail section lists the domains in account resellid:
Output
- 631 -
API Command Categories
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAllAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetHomeDomainList
l GetOrderDetail
l GetOrderList
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l RPT_GetReport
l UpdateAccountInfo
l UpdateCusPreferences
GetResellerHostPricing
Description
Definition
- 632 -
API Command Categories
Retrieve pricing for the components of Web hosting packages, including price breaks for
larger packages.
Usage
Use this command to retrieve pricing for components of Web hosting packages.
To retrieve the prices you currently pay, use parameter AccountType=reseller.
To retrieve the prices you currently charge, use parameter AccountType=retail.
To retrieve the prices you currently charge a specific subaccount, use parameter SubID-
D=SubaccountName.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Set Component Unit Pricing table displays both the AccountType=reseller and
AccountType=retail return values.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 633 -
API Command Categories
Either Accoun-
tType or SubID is
Name of the subaccount to retrieve the
Required. If you
prices for. Return values are the prices
SubID use the SubID para- 20
the subaccount pays (wholesale prices)
meter, do not use
for components.
the AccountType
parameter.
BandwidthPrice Price for each bandwidth unit (each unit contains 20GB)
WebStoragePrice Price for each Web storage unit (each unit contains 1GB)
Price for each POP mail unit (each unit contains 10 email
POPMailPrice
boxes, with 100MB storage per mailbox)
- 634 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieThe following query retrieves the prices that account resellid
pays for Web hosting components, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETRESELLERHOSTPRICING& uid=resellid&pw=resellpw
&Auid=resellid&pw=resellpw&AccountType=reseller
&responsetype=xml
In the response, a list of component prices and the ErrCount value 0 indicate that the
query was successful:
Output
- 635 -
API Command Categories
<components>
<Qty>10</Qty>
<BandwidthPrice>.36</BandwidthPrice>
<WebStoragePrice>.25</WebStoragePrice>
<DBStoragePrice />
<POPMailPrice>.20</POPMailPrice>
</components>
<components>
<Qty>20</Qty>
<BandwidthPrice>.24</BandwidthPrice>
<WebStoragePrice />
<DBStoragePrice />
<POPMailPrice />
</components>
<PackageCount>4</PackageCount>
</resellerhostpricing>
<Command>GETRESELLERHOSTPRICING</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
- 636 -
API Command Categories
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
GetResellerInfo
Description
Definition
Retrieve the contact information for the account holder.
Usage
Use this command to retrieve contact information for a reseller account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/EditContact.asp
On the my info page, the Organization (or Individual) Information box displays the results
of the GetResellerInfo command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 637 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
City City
- 638 -
API Command Categories
Parameter Description
EMailAddress Email address
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves reseller contact information for the specified account and
domain, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetResellerInfo&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<ResellerInfo>
<OrganizationName>Extraordinary Sales</OrganizationName>
- 639 -
API Command Categories
<FName>Johnny</FName>
<LName>Doety</LName>
<Address1>15801 NE 24th Street</Address1>
<Address2/>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>98008</PostalCode>
<Country>US</Country>
<Phone>+1.4252744500</Phone>
<Fax/>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<PhoneExt/>
<Site>E</Site>
<LoginID>resellid</LoginID>
</ResellerInfo>
<Command>GETRESELLERINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.672</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 2:55:03 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddContact
l GetAccountInfo
l GetAddressBook
l GetAllAccountInfo
l GetContacts
l GetWhoisContact
- 640 -
API Command Categories
GetServiceContact
Description
Definition
Retrieve the customer service contact information for a domain name account.
Usage
Use this command to retrieve customer service contact information for an account. If
there is a PDQ subscription associated with this account, this command can return the
PDQ contact information. Otherwise, this command returns the Billing contact inform-
ation.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/pdq/RE_Default.asp?maintab=overview
Clicking the my site tab calls the GetServiceContact command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 641 -
API Command Categories
Done True indicates this entire response has reached you suc-
- 642 -
API Command Categories
Parameter Description
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the customer service contact information for resellid and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETSERVICECONTACT&uid=resellid
&pw=resellpw&responsetype=xml
In the response, the presence of contact information, and the ErrCount value 0, indicate
that the query was successful:
Output
- 643 -
API Command Categories
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<URL />
<ResellerKey />
</ServiceContact>
<Command>GETSERVICECONTACT</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<ExecTime>8.203125E-02</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l AddContact
l Contacts
l GetAddressBook
l GetContacts
l GetWhoisContact
GetSPFHosts
Description
Definition
Retrieve Sender Policy Framework (SPF) host records for a domain.
Usage
Use this command to retrieve SPF host records for a domain.
Availability
- 644 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 645 -
API Command Categories
Parameter Description
Type Type of this SPF record
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the SPF hosts for a domain and sends the response in
XML format:
Query
- 646 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=getspfHosts&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
In the response, host values confirm that the query was successful and that SPF records
have been configured for this domain:
Output
- 647 -
API Command Categories
Related commands
l GetHosts
l SetHosts
l SetSPFHosts
GetStorageUsage
Description
Definition
Retrieve the current usage of Web storage resources for this Web hosting account.
Usage
Use this command to retrieve the current Web storage usage for a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.enom.com/
In the Web Sites section, the Storage Usage line displays the results of the GetSt-
orageUsage command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
- 648 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 649 -
API Command Categories
Example
The following query retrieThe following query retrieves the amount of Web storage
space currently being used by Web hosting account resellwebid and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GETSTORAGEUSAGE&uid=resellid&pw=resellpw
&huid=resellid&pw=resellpw&hostaccount=resellwebid
&responsetype=xml
In the response, a return value for Usage indicates that the query was successful:
Output
Related commands
l GetAllHostAccounts
l WebHostGetOverages
l WebHostSetOverageOptions
- 650 -
API Command Categories
GetSubAccountDetails
Description
Definition
For one subaccount, get the wholesale prices you charge this subaccount for products
and services, and whether enabled settings for one subaccount.
Usage
Use this command to list prices for one subaccount.
To set TLD prices for one subaccount, use the SetResellerTLDPricing or UpdateAc-
countPricing.
To set prices for services for one subaccount, use the UpdateAccountPricing command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-List.asp
On the sub-account page, clicking a link in the LoginID column calls the GetSubAc-
countDetails command without the Action=Manage parameter.
https://resellertest.enom.com/resellers/SubAccount-Manage.asp?Account=154-dz-5567
On the Sub-account configuration page, clicking the save changes button calls the
GetSubAccountDetails command with the Action=Manage parameter.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The account must be a reseller account.
l The subaccount must belong to this account.
- 651 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 652 -
API Command Categories
Parameter Description
LoginID Account login ID of the subaccount
RegisterPrice Price for registering a domain of this type for one year
RenewPrice Price for renewing a domain of this type for one year
POP3 Price for one 10-mailbox POP pak, per year, in $US
- 653 -
API Command Categories
Parameter Description
Price for one year registration of a VeriSign Secure Site Exten-
Certificate-VeriSign-Secure-Site-EV
ded Validation SSL certificate
POPStorage Price for one unit of extra POP storage, for one year
POPStorageRenew Price to renew one year of extra POP storage, for one year
Price to renew POP service for one year, for one 10-mailbox
POPRenew
POP pak
EmailForwardingRenew Price to renew our email forwarding service, for one year and
- 654 -
API Command Categories
Parameter Description
one domain name
Price to renew our URL forwarding service, for one year and
URLForwardingRenew
one domain name
WPPSRenew Price to renew ID Protect for one year, for one domain
WBL Price for Business Listing for one year, for one domain
Done successfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests for a subaccount of resellid, subaccount 659-fs-2869. The
query retrieves the prices for all products and requests the response in XML format:
Query
- 655 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=GetSubaccountDetails&uid=resellid&pw=resellpw
&Account=659-fs-2869&responsetype=xml
The response lists the prices given in the query for each of the domain name products,
and then lists identification information and the updated prices for subaccount 154-dz-
5567:
Output
- 656 -
API Command Categories
<registerenabled>True</registerenabled>
<renewprice>29.95</renewprice>
<resellerpricerenew>29.95</resellerpricerenew>
<renewenabled>True</renewenabled>
<transferprice>29.95</transferprice>
<resellerpricetran>29.95</resellerpricetran>
<transferenabled>True</transferenabled>
</product>
.
.
.
<count>78</count>
</pricestructure>
<pop3>9.95</pop3>
<dotnamebundle>19.95</dotnamebundle>
<DNSHosting>4.00</DNSHosting>
<wpps>6.00</wpps>
.
.
.
<ValueAdds>
<valueadd>
<producttype>190</producttype>
<productenabled>True</productenabled>
<price>12.50</price>
<timebracket>1</timebracket>
</valueadd>
<valueadd>
<producttype>190</producttype>
<productenabled>True</productenabled>
<price>10.41</price>
<timebracket>12</timebracket>
</valueadd>
.
.
.
</ValueAdds>
</Get>
</SubAccountsManage>
<Command>GETSUBACCOUNTDETAILS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
- 657 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.500</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l DeleteSubaccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetConfirmationSettings
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccounts
l GetSubaccountsDetailList
l GetTransHistory
l GetWebHostingAll
l SetResellerServicesPricing
l SetResellerTLDPricing
l SubAccountDomains
l UpdateAccountInfo
l UpdateCusPreferences
- 658 -
API Command Categories
GetSubAccountPassword
Description
Definition
Get the password for a domain name.
Usage
Use this command to retrieve the password for a domain name that belongs to your
account. The password is emailed to the Registrant contact address.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/help/
On the help page, the Password recovery link calls the GetSubAccountPassword com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 659 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the password for domain resellerdocs.com, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetSubAccountPassword&uid=resellid&pw=resellpw
- 660 -
API Command Categories
&sld=resellerdocs&tld=com&responsetype=xml
The 0 value for ErrCount indicates that the request has been processed successfully.
The password is e-mailed to the registrant almost instantly.
Output
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
- 661 -
API Command Categories
GetSubAccounts
Description
Definition
List subaccounts.
Usage
Use this command to list subaccounts for an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount.asp
On the subaccount page,clicking the List/Manage link calls the GetSubAccounts com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 662 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 663 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a list of subaccounts for account resellid. It specifies that
the return values should be listed by last name, starting with the letter D, and starting
with the seventh subaccount in that list. Finally, the string requests the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=getsubaccounts&uid=resellid&pw=resellpw
&ListBy-
y=LName&StartLetter=D&StartPosition=7&responsetype=xml
The response indicates that account resellid has 12 subaccounts that fit the parameters,
and returns the seventh through twelfth subaccounts in that list:
Output
<interface-response>
<SubAccounts>
<SubAccount>
<Account>012-gf-7319</Account>
<DomainCount>0</DomainCount>
<PartyID>c3f7c836-f3d6-42ab-b628-519bf957786c</PartyID>
<LoginID>23</LoginID>
<Reseller>0</Reseller>
<FName>john</FName>
<LName>doe</LName>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
</SubAccount>
<SubAccount>
<Account>946-bw-5211</Account>
<DomainCount>0</DomainCount>
<PartyID>80585e17-7a95-4f35-a8cd-c2261b7f2f02</PartyID>
<LoginID>23142123412341</LoginID>
<Reseller>0</Reseller>
<FName>John</FName>
- 664 -
API Command Categories
<LName>Doe</LName>
<EmailAddress>john@resellerdocs.com</EmailAddress>
</SubAccount>
.
.
.
<EndPosition>31</EndPosition>
<PreviousRecords>-18</PreviousRecords>
<NextRecords>32</NextRecords>
<Count>88</Count>
<RecordsDisplayed>25</RecordsDisplayed>
<StartLetter>D</StartLetter>
<StartPosition>7</StartPosition>
</SubAccounts>
<success>True</success>
<Command>GETSUBACCOUNTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.141</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>5de6f4fa-69b3-4107-a34e-a1f6b-
beb58f4</TrackingKey>
<RequestDateTime>12/12/2011 5:42:54 AM</RequestDateTime>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l DeleteContact
l DeleteSubaccount
l GetAccountInfo
- 665 -
API Command Categories
l GetAccountPassword
l GetAccountValidation
l GetAllAccountInfo
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubaccountsDetailList
l GetTransHistory
l GetWebHostingAll
l SendAccountEmail
l SetResellerServicesPricing
l SetResellerTLDPricing
l SubAccountDomains
l UpdateAccountInfo
l UpdateCusPreferences
GetSubaccountsDetailList
Description
Definition
Retrieve a list of subaccounts, and contact information for their owners.
Usage
Use this command to retrieve contact information for your subaccounts.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 666 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 667 -
API Command Categories
Parameter Description
Fax Subaccount owners fax number
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a list of the subaccounts of account resellid, with owners
contact information, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetSubaccountsDetailList&uid=resellid
&pw=resellpw&ResponseType=xml
- 668 -
API Command Categories
<interface-response>
<SubAccountDetailList>
<SubAccount>
<LoginID>-Oler</LoginID>
<FName>John</FName>
<LName>Doe</LName>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<OrganizationName>-</OrganizationName>
<URL/>
<JobTitle>-</JobTitle>
<Address1>111 Main St.</Address1>
<Address2/>
<City>Hometown</City>
<StateProvince>AL</StateProvince>
<PostalCode>99999</PostalCode>
<Country>US</Country>
<Phone>+1.1234567890</Phone>
<Fax/>
<PhoneExt/>
<Reseller>False</Reseller>
<Password>tester123</Password>
</SubAccount>
<SubAccount>
<LoginID>.Olerud5</LoginID>
<FName>John</FName>
<LName>Doe</LName>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<OrganizationName>-</OrganizationName>
<URL/>
<JobTitle>-</JobTitle>
<Address1>111 Main St.</Address1>
<Address2/>
<City>Hometown</City>
<StateProvince/>
<PostalCode>99999</PostalCode>
<Country>US</Country>
<Phone>test</Phone>
<Fax/>
<PhoneExt/>
<Reseller>False</Reseller>
<Password>.Olerud5</Password>
</SubAccount>
- 669 -
API Command Categories
.
.
.
<SubAccounts>409</SubAccounts>
</SubAccountDetailList>
<Command>GETSUBACCOUNTSDETAILLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>7.828</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 5:45:11 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetSubAccountDetails
l GetSubAccounts
l GetAccountValidation
l GetWebHostingAll
l SubAccountDomains
GetTLDDetails
Description
Definition
Retrieve TLD characteristics in detail for a specified TLD.
Usage
Use this command to retrieve TLD characteristics in detail for a specified TLD.
- 670 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Multiple pages to drive specific characteristic based on TLD.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 671 -
API Command Categories
Parameter Description
Allow domain's contacts to use WHOIS Privacy Protection
AllowWPPS
Service (WPPS)?
Registration - Gen-
Date and time the TLD enters General Availability
eralAvailabilityStartDate
- 672 -
API Command Categories
Parameter Description
How many months does the registry allow user to renew the
Renewal - RenewBeforeExpMonths
domain prior to the expiration date?
After domain is deleted, how long does the Registry allow for
Renewal - RGPDays
redemption period
- 673 -
API Command Categories
Parameter Description
NameServers - RequiresDNS Require DNS for registration?
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves TLD characteristics in detail for a specified TLD, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
Command=GetTLDDetails&UID=resellid&PW=resellpw
&Responsetype=xml&SLD=Ninja
- 674 -
API Command Categories
<interface-response>
<tlds>
<tld>
<TLDID>298</TLDID>
<TLD>ninja</TLD>
<AbleToLock>True</AbleToLock>
<AllowWPPS>True</AllowWPPS>
<AutoRenewOnly>False</AutoRenewOnly>
<ExtAttributes>False</ExtAttributes>
<AllowWBL>True</AllowWBL>
<TransRequiresNewContact>False</TransRequiresNewContact>
<EncodingType>PUNY</EncodingType>
<LangCode></LangCode>
<NativeDisplay></NativeDisplay>
<ClearPhoneNumber>False</ClearPhoneNumber>
<ClearFax>False</ClearFax>
<ValidateDNSHosting>False</ValidateDNSHosting>
<HasPremiumNames>True</HasPremiumNames>
<Registration>
<Realtime>True</Realtime>
<Unit>Year</Unit>
<Minimum>1</Minimum>
<Maximum>10</Maximum>
<HasPremiumNames>True</HasPremiumNames>
<ExtAttributes>False</ExtAttributes>
<ExtAttributesDomainLevel>False</ExtAttributesDomainLevel>
<DNSRequired>True</DNSRequired>
<DNSMinimum>2</DNSMinimum>
<DNSMaximum>13</DNSMaximum>
<GeneralAvailabilityStartDate>2014-05-28T10:00:00</Gen-
eralAvailabilityStartDate>
</Registration>
<Renewal>
<AutoRenewOnly>False</AutoRenewOnly>
<AutoRenewed>True</AutoRenewed>
<RenewBeforeExpMonths>0</RenewBeforeExpMonths>
<DeleteType>0</DeleteType>
<DeleteDay>42</DeleteDay>
<GracePeriod>5</GracePeriod>
<Reactivate>True</Reactivate>
<Restorable>True</Restorable>
<RGP>True</RGP>
- 675 -
API Command Categories
<RGPDays>32</RGPDays>
<ExtendedRGP>True</ExtendedRGP>
<TransferPeriod>1</TransferPeriod>
</Renewal>
<Transfer>
<Transferable>True</Transferable>
<AuthInfo>True</AuthInfo>
<Realtime>False</Realtime>
<AutoVerification>True</AutoVerification>
<AutoFax>True</AutoFax>
<TransferByFOA>False</TransferByFOA>
<RequiresNewContact>False</RequiresNewContact>
</Transfer>
<PremiumNames>
<HasPremiumNames>True</HasPremiumNames>
<MaxPremiumRegYears>True</MaxPremiumRegYears>
<TrademarkStartDate>2014-04-30T10:00:00</Trade-
markStartDate>
</PremiumNames>
<NameServers>
<RequiresDNS>True</RequiresDNS>
<MinNameServers>False</MinNameServers>
<MaxNameServers>False</MaxNameServers>
</NameServers>
</tld>
</tlds>
<Command>GETTLDDETAILS</Command>
<APIType>API.NET</APIType>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.016</ExecTime>
<Done>true</Done>
<TrackingKey>1bfc0cc0-69c4-446c-93a0-79bafe666ee3</Track-
ingKey>
- 676 -
API Command Categories
GetTLDList
Description
Definition
Retrieve a list of the TLDs that you offer.
Usage
Use this command to retrieve a list of the TLDs that you offer. If you have not specifically
authorized TLDs then this command returns all TLDs offered by us.
Use the AuthorizeTLD command to authorize TLDs and the RemoveTLD command to
remove TLDs from authorized status for your account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
Clicking the TLD pricing tab shows a table that includes all TLDs offered by this account
(although the contents of this particular table are retrieved by a different command than
GetTLDList).
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
- 677 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 678 -
API Command Categories
Example
The following query retrieves a list of TLDs authorized for this account, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=gettldlist&uid=resellid&pw=resellpw
&responsetype=xml
- 679 -
API Command Categories
<tld>de</tld>
</tld>
<tldcount>9</tldcount>
</tldlist>
<Command>GETTLDLIST</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site />
<IsLockable />
<IsRealTimeTLD />
<ExecTime>0.140625</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l AuthorizeTLD
l PE_SetPricing
l RemoveTLD
l SetResellerTLDPricing
GetTransHistory
Description
Definition
Return a list of up to 25 transactions in an account.
Usage
Use this command to retrieve an overview of transactions.
Availability
All resellers have access to this command.
- 680 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/
When the my enom submenu is open on the left side of the Web page, clicking the trans-
actions link calls the GetTransHistory command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 681 -
API Command Categories
- 682 -
API Command Categories
Parameter Description
16 Sales Commission
17 CCTransaction Fee
20 Refund and Reverse Commissions with Charge Back
21 Charge Back
22 Reverse Commission
23 Reverse Commission with Charge Back
25 Preregistration Fee
26 Activation Fee
28 Refill Service Convenience Charge
30 PDQ Annual Fee
32 Refill Reseller Account (No Service Charge)
Language Language
- 683 -
API Command Categories
Parameter Description
TimeDifference Time difference between end user and our server
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the transaction history for account resellid, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetTransHistory&uid=resellid&pw=resellpw
&responsetype=xml
- 684 -
API Command Categories
<RecordCount>396</RecordCount>
<NewStartPosition>26</NewStartPosition>
<OldStartPosition>0</OldStartPosition>
<TransHistory>
<Transaction>
<Trans-Date>7/18/2007 1:25:11 PM</Trans-Date>
<Amount>-$4.40</Amount>
<TransDescription>Order</TransDescription>
<TransType>1</TransType>
<LinkValue>
OrderDetail.asp?OrderID=157385793&OrderProcess=Successful
</LinkValue>
<OrderID>157385793</OrderID>
<OrderProcessFlag>True</OrderProcessFlag>
<Balance>$7,028.39</Balance>
<ComBalance />
<TransStatus>Successful</TransStatus>
</Transaction>
<Transaction>
<Trans-Date>7/16/2007 2:05:01 AM</Trans-Date>
<Amount>-$8.95</Amount>
<TransDescription>Order</TransDescription>
<TransType>1</TransType>
<LinkValue>
OrderDetail.asp?OrderID=157385407&OrderProcess=Successful
</LinkValue>
<OrderID>157385407</OrderID>
<OrderProcessFlag>True</OrderProcessFlag>
<Balance>$7,032.79</Balance>
<ComBalance />
<TransStatus>Successful</TransStatus>
</Transaction>
.
.
.
</TransHistory>
</GetTransHistory>
<Command>GETTRANSHISTORY</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
- 685 -
API Command Categories
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.750</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l RefillAccount
l RPT_GetReport
l UpdateAccountInfo
l UpdateCusPreferences
GetWebHostingAll
Description
Definition
Retrieve reseller keys for Registry Rocket accounts.
Usage
Use this command to retrieve reseller keys for Registry Rocket accounts.
- 686 -
API Command Categories
Do not use this command to retrieve prices, because the prices returned here may be
obsolete. Instead, use one of the PE_Get* pricing commands.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
In the Registry Rocket Settings box at the bottom of the page, the ResellerKey line posts
the return value from the GetWebHostingAll command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 687 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of the reseller keys for account resellid, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetWebhostingAll&uid=resellid
&pw=resellpw&responsetype=xml
- 688 -
API Command Categories
In the response, the results for ResellerKey and the ErrCount of 0 confirm that the query
was successful:
Output
<interface-response>
<RocketLink>
<ResellerKey>20B0FF00-18C2-4425-9198-5</ResellerKey>
<HostPrice>11.21</HostPrice>
<CCPrice>27.69</CCPrice>
<InfoPrice>11.21</InfoPrice>
<BizPrice>7.14</BizPrice>
<TvPrice>43.14</TvPrice>
<WsPrice>16.36</WsPrice>
<BzPrice>27.69</BzPrice>
<NuPrice>27.69</NuPrice>
<UsPrice>11.21</UsPrice>
<PictureURL/>
<ContactEmail/>
<CompanyName>RRTest</CompanyName>
<Referrer/>
<NameMyPhone>False</NameMyPhone>
<NameMyComputer>False</NameMyComputer>
<NameMyMap>False</NameMyMap>
<SiteBuilder>False</SiteBuilder>
<StyleSheetNum>1</StyleSheetNum>
</RocketLink>
<success>False</success>
<Command>GETWEBHOSTINGALL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.047</ExecTime>
<Done>true</Done>
<debug/>
- 689 -
API Command Categories
<TrackingKey>75373637-e0d2-4b8a-b56d-55765f16d96a</Track-
ingKey>
<RequestDateTime>12/9/2011 3:08:37 AM</RequestDateTime>
</interface-response>
Related commands
l GetSubAccountDetails
l GetSubAccounts
l GetSubaccountsDetailList
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l PE_SetPricing
l Purchase
GetWhoisContact
Description
Definition
Get Whois contact information for a domain name.
Usage
Use this command to get contact information for any domain name registered through
eNom or its resellers.
Availability
All resellers have access to this command.
Implementation on eNom.com
https://resellertest.enom.com
On the enom.com home page, the Whois link at the top of the page calls the
GetWhoisContact command.
- 690 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
RegistrantCity City
- 691 -
API Command Categories
Parameter Description
RegistrantStateProvince State or province
RegistrantCountry Country
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 692 -
API Command Categories
l If additional contact types are returned other than Registrant they will be
"ContactType" Technical,Administrative or Billing.
Example
The following query requests the whois contact information for resellerdocs.com, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=getwhoiscontact&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<GetWhoisContacts>
<domainname sld="resellerdocs" tld-
d="com">resellerdocs.com</domainname>
<AboutusLink>True</AboutusLink>
<contacts>
<contact ContactType="Registrant">
<Organization>Whois Privacy Protection Service, Inc.</Or-
ganization>
<FName>Whois</FName>
<LName>Agent</LName>
<Address1>PMB 368, 14150 NE 20th St - F1</Address1>
<Address2>C/O resellerdocs.com</Address2>
<City>Bellevue</City>
<StateProvince>WA</StateProvince>
<PostalCode>98007</PostalCode>
<Country>US</Country>
<Phone>+1.4252740657</Phone>
<PhoneExt/>
<Fax>+1.4256960234</Fax>
<EmailAd-
dress>cmktwnrb@whoisprivacyprotect.com</EmailAddress>
</contact>
- 693 -
API Command Categories
.
.
.
</contacts>
<businesslisting>
<listing>
<wblid>1010</wblid>
<statusid>2</statusid>
<expdate>2012-11-13T14:25:57.460</expdate>
<expdate>1</expdate>
<companyname>My Super Company</companyname>
<companydescription>We make super cool stuff</-
companydescription>
<domainname>resellerdocs.com</domainname>
<street>123 Anywhere Street</street>
<street2>Suite 100</street2>
<city>Peoria</city>
<stateprovince>IL</stateprovince>
<postalcode>10001</postalcode>
<country>US</country>
<categoryid1>11</categoryid1>
<categoryid2>14</categoryid2>
<categoryid3>16</categoryid3>
<configuration>
<fields>
<field fieldname="Associations">
<value>My associations</value>
</field>
<field fieldname="Tags">
<value>My tags</value>
</field>
<field fieldname="Promotions">
<value>My Promotions</value>
</field>
</fields>
</configuration>
</listing>
</businesslisting>
<rrp-info>
<nameserver>
<nameserver>DNS3.NAME-SERVICES.COM</nameserver>
<nameserver>DNS2.NAME-SERVICES.COM</nameserver>
- 694 -
API Command Categories
<nameserver>DNS5.NAME-SERVICES.COM</nameserver>
<nameserver>DNS4.NAME-SERVICES.COM</nameserver>
<nameserver>DNS1.NAME-SERVICES.COM</nameserver>
</nameserver>
<updated-date>2011-09-28 20:17:36.000</updated-date>
<created-date>2002-06-25 20:24:35.000</created-date>
<registration-expiration-date>2015-08-21 17:45:35.000</re-
gistration-expiration-date>
<status>
<status>ok</status>
</status>
<domain>resellerdocs.com</domain>
</rrp-info>
<StatusValues>True</StatusValues>
</GetWhoisContacts>
<DomainExpired>False</DomainExpired>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully</RRPText>
<Source>ENOM</Source>
<Command>GETWHOISCONTACT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.813</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 3:10:26 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddContact
l Contacts
l GetAddressBook
l GetContacts
- 695 -
API Command Categories
l GetExtAttributes
l GetResellerInfo
l GetServiceContact
l Preconfigure
GetWPPSInfo
Description
Definition
Retrieve the ID Protect (Whois privacy protection) status and contact information for a
domain name.
Usage
Use this command to retrieve ID Protect status for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/domains/DomainDetail.asp?DomainNameID=152533676
In the id protect section, the configure button calls the GetWPPSInfo command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 696 -
API Command Categories
- 697 -
API Command Categories
Parameter Description
StateProvince State or province for this contact
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests ID Protect settings for resellerdocs.com and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GetWPPSInfo&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ResponseType=XML
- 698 -
API Command Categories
In the response, the ID Protect status information, and the ErrCount value 0, confirm that
the query wassuccessful:
Output
- 699 -
API Command Categories
<City>Hometown</City>
<StateProvince>WA</StateProvince>
<PostalCode>99999</PostalCode>
<Country>US</Country>
<Phone>+1.4252740657</Phone>
<Fax>+1.4256960234</Fax>
<EmailAd-
dress>ahxkghas@whoisprivacyprotect.com</EmailAddress>
</contact>
</contacts>
</GetWPPSInfo>
<Command>GETWPPSINFO</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<ExecTime>0.140625</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l DisableServices
l EnableServices
l PurchaseServices
l ServiceSelect
GM_CancelSubscription
Description
Definition
- 700 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 701 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 702 -
API Command Categories
Example
The following query cancels a goMobi subscription and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_CancelSubscription&uid=resellid&pw=resellpw
&SubscriptionID=90&ReasonID=7&Comment=Obsolete
&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 703 -
API Command Categories
Related commands
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_CheckDomain
Description
Definition
Check whether a third-level domain name is available for a goMobi mobile Web site.
- 704 -
API Command Categories
Usage
Use this command to check whether a third-level domain of gomobinow.mobi is avail-
able for a goMobi mobile web site. For example, check example if you want users to
access your mobile Web site at example.gomobinow.mobi.
This third-level domain functionality is one of four methods by which goMobi subscribers
can provide access to their mobile web site. Other options for mobilizing their Web site
include:
l Use the third-level domain name assigned when the subscription was created (in
format GMNNN.gomobinow.mobi).
l Associate the mobilized site with a separate domain name (for example, example.-
The snippet identifies thevisitors device, and delivers content formatted for that
device.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
Click a goMobi domain name.
In the Mobile URL row, click edit.
The Check button launches the GM_CheckDomain command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 705 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 706 -
API Command Categories
Example
The following query checks the availability of example.gomobinow.mobi and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_CheckDomain&uid=resellid&pw=resellpw
&ThirdLevelDomain=example&responsetype=xml
- 707 -
API Command Categories
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.281 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ b4d7b79f-5b70-4388-bd89-a320c484af5f ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetCancelReasons
Description
Definition
Retrieve a menu of reasons for cancelling a goMobi subscription.
Usage
Use this command to retrieve a menu of reasons for cancelling a goMobi subscription.
- 708 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 709 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves reasons for cancelling goMobi and the identification num-
bers associated with them, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_getcancelreasons&uid=resellid&pw=resellpw
&ThirdLevelDomain=example&responsetype=xml
In the response, a list of cancellation reasons and an ErrCount value 0 indicate that the
query was successful:
Output
- 710 -
API Command Categories
- 711 -
API Command Categories
</Done>
<debug />
<TrackingKey>
<![CDATA[ 19ee6f64-1d33-451c-a73c-60ad4e4a91c9 ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetControlPanelLoginURL
Description
Definition
Retrieve a URL for the goMobi control panel.
Usage
Use this command to retrieve a URL for the goMobi control panel. The URL includes a
five-minute login token.
All subscribers should use the control panel to confirm, or provide, content for their
mobile site.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 712 -
API Command Categories
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
Click a domain name.
The Login to goMobi Control Panel link launches the GM_GetControlPanelLoginURL
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The MobileDomainName value must be a domain name in this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 713 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check the
ErrCount
Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a URL for the goMobi control panel, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_GetControlPanelLoginURL&uid=resellid&pw=resellpw
&MobileDomainName=resellerdocs.com&responsetype=xml
In the response, the presence of a URL indicates that the query was successful:
Output
- 714 -
API Command Categories
1fr1dO1x1RtV375qBkbsfzo%3d/eng ]]>
</LoginUrl>
<Command>
<![CDATA[ GM_GETCONTROLPANELLOGINURL ]]>
</Command>
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
<![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.156 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ a6436432-c856-4738-b4b6-58c7ee86058d ]]>
</TrackingKey>
</interface-response>
- 715 -
API Command Categories
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetRedirectScript
Description
Definition
Retrieve the goMobi JavaScript snippet, which the customer embeds in the header for
their source (desktop) site to power the reformatting for mobile devices.
Usage
Use this command to retrieve the goMobi JavaScript snippet. The customer embeds the
snippet in the header for the desktop site associated with the source domain name.
goMobi uses this header information to detect the visitors mobile device and reformat
the desktop site for the specific mobile device.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
Click any subscription that displays a designated source domain.
In the Add Mobile Site Redirect row, the text box contains a JavaScript snippet supplied
by the GM_GetRedirectScript command.
- 716 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Redirect scripts require a designated source domain name.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 717 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a JavaScript snippet for goMobi, and sends the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_GetRedirectScript&uid=resellid&pw=resellpw
&SourceDomainName=example.com
&MobileDomainName=resellerdocs.com&responsetype=xml
In the response, the presence of a JavaScript snippet and an ErrCount value 0 indicate
that the query was successful:
Output
- 718 -
API Command Categories
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetStatuses
- 719 -
API Command Categories
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetStatuses
Description
Definition
Retrieve the list of possible statuses for goMobi.
Usage
Use this command to retrieve a list of the possible statuses for goMobi.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not directly implemented on the eNom Web site, but can be used on
any page that displays a goMobi subscription status description.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 720 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of possible statuses for goMobi, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_GetStatuses&uid=resellid&pw=resellpw
- 721 -
API Command Categories
&responsetype=xml
In the response, a list of statuses and an ErrCount value 0 indicate that the query was
successful:
Output
- 722 -
API Command Categories
<ExecTime>
<![CDATA[ 0.094 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 2977d696-5efc-4f06-b7bd-91bb520bf708 ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetSubscriptionDetails
Description
Definition
Retrieve details for one goMobi subscription.
Usage
Use this command to retrieve details for one goMobi subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 723 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
MobileDomainName Domain name that an end user of a mobile device should use
- 724 -
API Command Categories
Parameter Description
to access the mobile web site
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves details for one goMobi subscription, and sends the
response in XML format:
Query
- 725 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=GM_GetSubscriptionDetails&uid=resellid&pw=resellpw
&SubscriptionID=90&responsetype=xml
In the response, subscription details and an ErrCount value 0 indicate that the query was
successful:
Output
<interface-response>
<GoMobiSubscriptionDetails>
<GMSubscriptionId>90</GMSubscriptionId>
<PartyId>bb4a2de1-6485-45cb-a4fc-ee39ba0c1629</PartyId>
<MobileDomainName>resellerdocs.com</MobileDomainName>
<SourceDomainName>example.com</SourceDomainName>
<StatusDesc>Service Disabled</StatusDesc>
<BillingCycleDesc>Yearly</BillingCycleDesc>
<NextBillingDate>8/31/2011</NextBillingDate>
<StatusId>3</StatusId>
<NextBillingCycleDesc>Monthly</NextBillingCycleDesc>
<RenewDate>9/14/2011</RenewDate>
<HasPassword>false</HasPassword>
</GoMobiSubscriptionDetails>
<Command>GM_GETSUBSCRIPTIONDETAILS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.156</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>43bae90d-28bf-4223-b654-eb424831ed00</Track-
ingKey>
<RequestDateTime>12/9/2011 3:18:49 AM</RequestDateTime>
</interface-response>
- 726 -
API Command Categories
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_GetSubscriptions
Description
Definition
Retrieve a list of the goMobi subscriptions in an account.
Usage
Use this command to retrieve a list of the goMobi subscriptions in an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
The GM_GetSubscriptions command generates the list of goMobi subscriptions on this
page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 727 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 728 -
API Command Categories
Domain name of the desktop web site from which this mobile
SourceDomainName
site derives its content
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of goMobi subscriptions and sends the response in
XML format:
- 729 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=GM_GetSubscriptions&uid=resellid
&pw=resellpw&responsetype=xml
In the response, a list of subscriptions and an ErrCount value 0 confirm that the query
was successful:
Output
<interface-response>
<GoMobiSubscriptions>
<Subscription>
<MobileDomainName>GM89.gomobinow.mobi</MobileDomainName>
<SourceDomainName>teldom.si</SourceDomainName>
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>10/7/2010</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>89</GMSubscriptionId>
<RenewDate>10/14/2010</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>GM92.gomobinow.mobi</MobileDomainName>
<SourceDomainName/>
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>10/7/2010</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>92</GMSubscriptionId>
<RenewDate>10/14/2010</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>GM149.gomobinow.mobi</MobileDomainName>
<SourceDomainName/>
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>10/15/2010</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>149</GMSubscriptionId>
<RenewDate>10/22/2010</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>GM146.gomobinow.mobi</MobileDomainName>
<SourceDomainName>teldom.si</SourceDomainName>
- 730 -
API Command Categories
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>10/15/2010</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>146</GMSubscriptionId>
<RenewDate>10/22/2010</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>GM299.gomobinow.mobi</MobileDomainName>
<SourceDomainName/>
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>12/10/2010</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>299</GMSubscriptionId>
<RenewDate>12/17/2010</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>namita.gomobinow.mobi</MobileDomainName>
<SourceDomainName/>
<StatusDesc>Service Active</StatusDesc>
<NextBillingDate>8/31/2011</NextBillingDate>
<StatusId>1</StatusId>
<GMSubscriptionId>91</GMSubscriptionId>
<RenewDate>9/14/2011</RenewDate>
</Subscription>
<Subscription>
<MobileDomainName>resellerdocs.com</MobileDomainName>
<SourceDomainName>example.com</SourceDomainName>
<StatusDesc>Service Disabled</StatusDesc>
<NextBillingDate>8/31/2011</NextBillingDate>
<StatusId>3</StatusId>
<GMSubscriptionId>90</GMSubscriptionId>
<RenewDate>9/14/2011</RenewDate>
</Subscription>
<TotalCount>9</TotalCount>
</GoMobiSubscriptions>
<Command>GM_GETSUBSCRIPTIONS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
- 731 -
API Command Categories
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.297</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>ccf60879-a285-4b79-9315-897859daf6b7</Track-
ingKey>
<RequestDateTime>12/9/2011 3:20:26 AM</RequestDateTime>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_ReactivateSubscription
Description
Definition
Remove the cancellation flag from a goMobi subscription.
Usage
Use this command to undo the cancellation request for a goMobi subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 732 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account, and must be flagged for can-
cellation.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 733 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query removes the cancellation request from a goMobi subscription, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_ReactivateSubscription&uid=resellid&pw=resellpw
&SubscriptionID=90&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 734 -
API Command Categories
Related commands
l GM_CancelSubscription
l GM_CheckDomain
- 735 -
API Command Categories
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_RenewSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
GM_RenewSubscription
Description
Definition
Renew a goMobi subscription for which the status is Service Disabled (status 3) or
Billing Failed (status 4).
Usage
Us this command to renew a goMobi subscription Service Disabled (status 3, usually an
expired subscription) or Billing Failed (status 4, usually due to insufficient account bal-
ance).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
For any subscription with status Billing Failed (StatusID=4), clicking the Charge Account
link launches the GM_RenewSubscription command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account.
l The goMobi subscription must be in Billing Failed status.
- 736 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 737 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query renews a goMobi subscription for which the previous billing attempt
failed, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_RenewSubscription&uid=resellid&pw=resellpw
&SubscriptionID=41&responsetype=xml
In the response, a Success value True and an OrderID number indicate that the query
was successful:
Output
- 738 -
API Command Categories
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 1.172 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 1a5d4041-46d3-41f4-b84c-ec138035732f ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_UpdateBillingCycle
l GM_UpdateSubscriptionDetails
- 739 -
API Command Categories
GM_UpdateBillingCycle
Description
Definition
Change a goMobi billing cycle to monthly or yearly.
Usage
Use this command to switch between monthly and yearly billing for a goMobi sub-
scription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
Click a domain name.
In the Subscription Details section, the Switch to Annual Subscription link launches the
GM_UpdateBillingCycle command (the API command also allows you to change from
yearly to monthly billing, but we do not implement this option in our user interface).
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must be in this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 740 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 741 -
API Command Categories
Example
The following query updates a goMobi subscription to yearly billing, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_UpdateBillingCycle&uid=resellid&pw=resellpw
&SubscriptionID=89&Months=12&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 742 -
API Command Categories
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.109 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ cf2d2d1b-5f13-4687-9f52-caa5aa5074ed ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateSubscriptionDetails
GM_UpdateSubscriptionDetails
Description
Definition
Configure or update the source and mobile domain names for a goMobi subscription.
Usage
- 743 -
API Command Categories
Use this command to configure or update the source domain name (the full-sized web
site) and mobile domain name (site you want to display on mobile devices).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-mobile-2/manage.aspx
Click the domain name for the subscription you want to configure.
The Subscription Overview section receives input parameters, and the Save Settings but-
ton launches the GM_UpdateSubscriptionDetails command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The goMobi subscription must belong to this account.
l The mobile domain name must be in the same account as the goMobi sub-
scription.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 744 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 745 -
API Command Categories
Example
The following query specifies that resellerdocs.com should be the mobile domain name
associated with desktop Web site example.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=GM_UpdateSub-
scriptionDetails&uid=resellid&pw=resellpw
&SubscriptionID=90&SourceDomainName=example.com
&MobileDomainName=resellerdocs.com&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 746 -
API Command Categories
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
- <![CDATA[ 4.547 ]]>
</ExecTime>
<Done>
- <![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ c769a335-5f2b-4440-9797-a65bc0a95641 ]]>
</TrackingKey>
</interface-response>
Related commands
l GM_CancelSubscription
l GM_CheckDomain
l GM_GetCancelReasons
l GM_GetControlPanelLoginURL
l GM_GetRedirectScript
l GM_GetStatuses
l GM_GetSubscriptionDetails
l GM_GetSubscriptions
l GM_ReactivateSubscription
l GM_RenewSubscription
l GM_UpdateBillingCycle
HostPackageDefine
Description
Definition
Create and configure, or reconfigure, a Web hosting package that you offer to your retail
customers.
- 747 -
API Command Categories
Usage
Use this command to create and configure, or reconfigure, a Web hosting package that
you offer to your retail customers.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enom.staging.enom.com/myaccount/hostingpricing.asp
The save packages button calls the HostPackageDefine command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 748 -
API Command Categories
Recommended if
Number of SQL database storage units
DBType=MSSQL.
to include in this Web hosting package.
If this input param
DBStorageUnits Each unit contains 250MB of MDF file 2
is omitted, value
capacity; maximum permitted is 30 units
remains at the last
(7500MB).
value set.
- 749 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query defines a Web hosting package named Enterprise and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=HOSTPACKAGEDEFINE&uid=resellid&pw=resellpw
&PackageName=Enterprise&BandWidthUnits=5
&WebStorageUnits=10&DBType=MSSQL
&DBStorageUnits=5&PopUnits=10&DomainHeaders=50
&responsetype=xml
In the response, the Success value True and the ErrCount value 0 confirm that the Web
hosting package was defined successfully:
Output
- 750 -
API Command Categories
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
- 751 -
API Command Categories
HostPackageDelete
Description
Definition
Delete a host package configuration.
Usage
Use this command to delete a host package configuration.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
In the Set Packages section, clicking a delete link and then the save packages button
calls the HostPackageDelete command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword¶mname=paramvalue&
nextparamname=nextparamvalue
- 752 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 753 -
API Command Categories
Example
The following query deleteThe following query deletes Web hosting package Cor-
porate4 and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=HOSTPACKAGEDELETE&uid=resellid&pw=resellpw
&PackageName=Corporate4&responsetype=xml
In the response, the Success value True confirms that that query was successful:
Output
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageModify
- 754 -
API Command Categories
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
HostPackageModify
Description
Definition
Change the quantity of one or more components in a Web hosting package.
Usage
Use this command to change the configuration of storage, bandwidth, and so on in a
Web hosting package. If you make changes to a package that customers have already
subscribed to, their configuration remains the same as when they subscribed; the
change applies only to future customers.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
Changing quantities in the Set Packages grid and clicking the save changes button calls
the
HostPackageModify command.
Constraints
The query must meet the following requirements:
- 755 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Recommended if
DBType=MSSQL. Number of SQL database storage units
If this input param to include in this Web hosting package.
DBStorageUnits 2
is omitted, value Each unit contains 250MB; maximum
remains at the last permitted is 30 units (total of 7500MB).
value set.
- 756 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 757 -
API Command Categories
Example
The following query modifies the contents of Web hosting package Silver and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=HOSTPACKAGEMODIFY&uid=resellid&pw=resellpw
&PackageID=137&PackageName=Silver&BandWidthUnits=7
&WebStorageUnits=15&DBType=MSSQL&DBStorageUnits=5
&PopUnits=20&DomainHeaders=100&responsetype=xml
In the response, the Success value True indicates that the query was successful:
Output
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
- 758 -
API Command Categories
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
HostPackageView
Description
Definition
View the configurations of Web hosting packages available to your retail customers.
Usage
Use this command to display the contents of the Web hosting packages available to your
retail customers.
Use this command to display the contents of a single Web hosting package available to
your retail customers.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Set Packages table displays the results of the HostPackageView command.
- 759 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting package must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 760 -
API Command Categories
OSTypeX Operating system of the Web server that serves this account
Done True indicates this entire response has reached you suc-
- 761 -
API Command Categories
Parameter Description
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the Web hosting packages defined for account resellid and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=HOSTPACKAGEVIEW&uid=resellid&pw=resellpw
&responsetype=xml
In the response, a list of packages and an ErrCount value 0 confirm that the query was
successful:
Output
- 762 -
API Command Categories
<DBStorageUnits>1</DBStorageUnits>
<POPUnits>5</POPUnits>
<DomainHeaders>100</DomainHeaders>
<DBType>MSSQL</DBType>
<OSType>Windows</OSType>
<Enabled>True</Enabled>
</Package>
<Package>
<PackageID>139</PackageID>
<PackageName>Corporate</PackageName>
<BandwidthGB>40</BandwidthGB>
<WebStorageMB>2048</WebStorageMB>
<DBStorageMB>500</DBStorageMB>
<POPMailBoxes>100</POPMailBoxes>
<WebStorageUnits>2</WebStorageUnits>
<BandwidthUnits>2</BandwidthUnits>
<DBStorageUnits>2</DBStorageUnits>
<POPUnits>10</POPUnits>
<DomainHeaders>100</DomainHeaders>
<DBType>MSSQL</DBType>
<OSType>Windows</OSType>
<Enabled>True</Enabled>
</Package>
.
.
.
<Count>4</Count>
</HostPackages>
<Command>HOSTPACKAGEVIEW</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
- 763 -
API Command Categories
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
HostParkingPage
Description
Definition
Set the text for the parking page for a Web hosting account. This is the default parking
page used by all domains in the account that do not have a designated home page.
Usage
Use this command to set the title-bar and page content of the parking page for a Web
hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/parking.asp
- 764 -
API Command Categories
On the PARKING PAGE SETTINGS page, the save button calls the HostParkingPage
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Optional; default is
PageTitle Content for browser title bar 94
Welcome
Optional; a default
PageText Content for parking page 1890
is provided
- 765 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets parking text and title bar caption for domains in Web hosting
account resellwebid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=hostparkingpage&uid=resellid&pw=resellpw
&hostaccount=resellwebid&PageTitle=Test+page+title
&PageText=Test+page+text&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
- 766 -
API Command Categories
<Server>ResellerTest</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CreateHostAccount
l GetHostAccount
l HostPackageDefine
l HostPackageModify
l HostPackageView
l WebHostGetPackages
l WebHostGetResellerPackages
InsertNewOrder
Description
Definition
Insert a checkout order of items in the shopping cart.
Usage
Use this command if you use our shopping cart, to finalize purchase of the cart contents.
This command checks out the items in a shopping cart that are in A (active) status, and
puts the order in a queue.
Purchase, a similar command, completes the purchase of selected products in real time,
without using our shopping cart or waiting for the order processing queue.
Because of the high prices for some Premium Domains, we offer you a wider variety of
payment methods than for most purchases. In addition to immediate payment using your
account balance, as you do for other domains and services, we offer two additional pay-
ment options for high-value Premium Domains: wire transfer, or delayed payment using
- 767 -
API Command Categories
your account balance. Use the UseWireTransfer parameter in the InsertNewOrder com-
mand to signal that you want to pay later, then either wire your payment or use the NM_
ProcessOrder command to pay
using your account balance.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/Checkout.asp
On the checkout page, the purchase button calls the InsertNewOrder command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l If the shopping cart is empty, ItemCount must equal 1 or the query will return an
error message.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 768 -
API Command Categories
Identification number for the order that includes all items not
OrderID
associated with Premium Domains
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 769 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests purchase of the contents of the shopping cart, defers pay-
ment for the Premium Domains in the cart, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=insertneworder&uid=resellid&pw=resellpw
&UseWireTransfer=Yes&responsetype=xml
In the response, an order ID number for Premium Domains, regular items, or both con-
firms that the query string was successful:
Output
<interface-response>
<OrderID>157781016</OrderID>
<ProdType10>10</ProdType10>
<Command>INSERTNEWORDER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>4.922</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 3:24:56 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 770 -
API Command Categories
Related commands
l AddBulkDomains
l AddToCart
l Check
l DeleteFromCart
l Extend
l Extend_RGP
l ExtendDomainDNS
l GetDomainExp
l GetExtendInfo
l GetRenew
l Purchase
l PurchasePreview
l SetRenew
l UpdateCart
l UpdateExpiredDomains
IsFolderEnabled
Description
Definition
Retrieve the IIS-enabled status of a folder.
Usage
Use this command to determine the IIS-enabled status of a folder
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.enom.com with Login ID resellwebid, password resellwebpw.
http://webhostingtest.enom.com/websites/advanced.asp
In the list of directories, the folder icons indicate whether the folder is enabled.
Constraints
The query must meet the following requirements:
- 771 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 772 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the IIS-enabled status of folder acct, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=isfolderenabled&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=/acct&responsetype=xml
- 773 -
API Command Categories
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l WebHostCreateDirectory
ListDomainHeaders
Description
Definition
Retrieve a list of domain headers (pointers for domain names) and host headers for a
Web hosting account.
Usage
Use this command to list the domain headers and host headers for one Web hosting
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/packagemanager.asp
In the Domains column, the modify link calls the ListDomainHeaders command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
l The domain header must belong to this Web hosting account.
- 774 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Operating system for the Web hosting server for this Web host-
ServerType
ing account
- 775 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
Err(x)
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a list of domain headers in Web hosting account resell-
webid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=ListDomainHeaders&uid=resellid&pw=resellpw
&HostAccount=resellwebid&ResponseType=xml
The response lists the domains associated with the Web hosting account and the head-
ers in each:
Output
- 776 -
API Command Categories
<HostHeader>
<WebHostHeaderID>123</WebHostHeaderID>
<HostName>@</HostName>
<FilePath>\test20070903</FilePath>
</HostHeader>
<HostHeader>
<WebHostHeaderID>122</WebHostHeaderID>
<HostName>www</HostName>
<FilePath>\test20070903</FilePath>
</HostHeader>
<HeaderCount>2</HeaderCount>
</DomainHeader>
.
.
.
<DomainCount>6</DomainCount>
<ServerType>Windows</ServerType>
<Successful>True</Successful>
</DomainHeaders>
<Command>LISTDOMAINHEADERS</Command>
<ErrCount>0</ErrCount>
<Server>INTERFACESON</Server>
<Site>enom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l CreateHostAccount
l DeleteDomainHeader
l ModifyDomainHeader
- 777 -
API Command Categories
ListHostHeaders
Description
Definition
List the host headers (pointers to third-level domain names) in your Web hosting
account.
Usage
Use this command to retrieve a list of host headers in your Web hosting account, with
attributes.
Availability
All resellers have access to this command.
Implementation on eNom.com
The ListHostHeaders command is not implemented on enom.com; however, the fol-
lowing gives a similar result:
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/wsg/packagemanager.asp
In the table, the modify links call the ListHostHeaders command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The Web hosting account must belong to this domain name account.
l The domain header must already exist.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 778 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
- 779 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of the host headers for Web hosting account resell-
webid, domain resellerdocs.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=listhostheaders&uid=resellid&pw=resellpw
&hostaccount=resellwebid&sld=resellerdocs
&tld=com&responsetype=xml
In the response, a list of host names and a count of the total number of host headers for
the domain indicate that the query was successful:
Output
- 780 -
API Command Categories
<HostHeaderID>279</HostHeaderID>
</HostHeader>
<Count>3</Count>
<Successful>True</Successful>
</HostHeaders>
<Command>LISTHOSTHEADERS</Command>
<ErrCount>0</ErrCount>
<Server>TEST3</Server>
<Site>enom</Site>
<IsLockable>False</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DeleteHostHeader
l GetAllHostAccounts
l GetHostAccount
l GetHostHeader
ListWebFiles
Description
Definition
List the subdirectories and files in a directory of a Web hosting account.
Usage
Use this command to create a list of subdirectories and files in a directory in your Web
hosting account.
Availability
All resellers have access to this command.
- 781 -
API Command Categories
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/advanced.asp?Path=
The Change Directory box on the right side of the page displays some of the results of
the ListWebFiles command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 782 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of directories and files in the root directory of Web
hosting account resellwebid and sends the response in XML format:
Query
- 783 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=listwebfiles&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=\&responsetype=xml
In the response, the Successful value True confirms that the query was successful:
Output
- 784 -
API Command Categories
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l GetFilePermissions
l IsFolderEnabled
l MetaBaseGetValue
l MetaBaseSetValue
l SetFilePermissions
l WebHostCreateDirectory
MetaBaseGetValue
Description
Definition
Retrieve some current IIS settings for a directory in a Web hosting account.
Usage
Use this command to retrieve current settings for HTTP access, anonymous access, dir-
ectory browsing, and the pages to display in case of 404 or ASP errors.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
- 785 -
API Command Categories
http://webhostingtest.ehost-services.com
In the menu, clicking web sites and then advanced calls the MetaBaseGetValue com-
mand. The results display on the Advanced IIS Settings page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The directory must be a subdirectory you have created in this Web hosting
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 786 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the metabase settings for directory testdir and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=metabasegetvalue&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=testdir
&responsetype=xml
- 787 -
API Command Categories
In the response, the MetaBase node and the ErrCount value 0 confirm that the query
was successful:
Output
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l GetFilePermissions
l IsFolderEnabled
l ListWebFiles
l MetaBaseSetValue
l SetFilePermissions
l WebHostCreateDirectory
- 788 -
API Command Categories
MetaBaseSetValue
Description
Definition
Specify values for IIS settings for one directory in a Web hosting account.
Usage
Use this command to set HTTP access, anonymous access, directory browsing, the 404
error page, and the ASP error page for a directory in a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-services.com/websites/advanced.asp?Path=/testdir
The SAVE NEW FOLDER SETTINGS button calls the MetaBaseSetValue command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The directory must be a subdirectory you have created in the Web hosting account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 789 -
API Command Categories
- 790 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
Err(x)
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets metabase values for directory testdir and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=metabasesetvalue&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=testdir
&HTTPAccessible=on&AnonymousAccess=off&Directorybrowsing=on
&Err404Page=404error.htm&ErrASPpage=ASPerror.htm
&responsetype=xml
In the response, the Successful value True confirms that the query was successful:
Output
- 791 -
API Command Categories
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l GetFilePermissions
l IsFolderEnabled
l ListWebFiles
l MetaBaseGetValue
l SetFilePermissions
l WebHostCreateDirectory
ModifyDomainHeader
Description
Definition
Add a domain header (a pointer that associates a domain name with a specific location
in your Web hosting directory structure), or redirect a domain header from one directory
to another within your Web hosting account.
Usage
Use this command to change the path to the content displayed for your Web site.
- 792 -
API Command Categories
Note that if you modify a domain header, all host records associated with the domain
header are deleted.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingdomains.asp?HostAccount=resellwebid
The add button calls the ModifyDomainHeader command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The directory (domain header) you want to move the domain to must already exist.
l The domain designated by the SLD and TLD parameters must be hosted by us.
l If we are the registrar for this domain, it must be in this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 793 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query points resellerdocs.com to directory acct, and sends the response in
XML format:
Query
- 794 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=modifydomainheader&uid=resellid&pw=resellpw
&hostaccount=resellwebid&directory=acct
&sld=resellerdocs&tld=com&responsetype=xml
In the response, the Successful value True confirms that the query was successful:
Output
Related commands
l AddDomainHeader
l CreateHostAccount
l DeleteDomainHeader
l GetDomainHeader
l ListDomainHeaders
l WebHostCreateDirectory
- 795 -
API Command Categories
ModifyHostHeader
Description
Definition
Redirect a host header (a pointer to third-level domain name) to a different directory in
your Web hosting account.
Usage
Use this command to change the directory a host header points to.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password resell-
webpw.
http://webhostingtest.ehost-ser-
vices.com/websites/hostheader.asp?hn=accountspayable&
d=resellerdocs.com
The SAVE HOST HEADER SETTINGS button calls the ModifyHostHeader command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The domain header must already exist.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 796 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 797 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the accountspayable host header to point to the directory
/accounting and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=modifyhostheader& uid=resellid&pw=resellpw
&SLD=resellerdocs&TLD=com&hostaccount=resellwebid
&HostName=accountspayable&FilePath=accounting
&responsetype=xml
In the response, the Successful value True indicates that the query was successful:
Output
- 798 -
API Command Categories
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DeleteDomainHeader
l DeleteHostHeader
l GetAllHostAccounts
l GetDomainHeader
l GetHostAccount
l GetHostHeader
l ListDomainHeaders
l ListHostHeaders
ModifyNS
Description
Definition
Modify name servers for a domain name.
Usage
Use this command if you want to use name servers that are different than the name serv-
ers currently set for a domain.
ModifyNS updates DNS records at the Registry and in the registrars database. Modi-
fyNSHosting, a similar command, redirects to another set of name servers without updat-
ing the Registry records.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DNSConfig.asp?DomainNameID=152533676
On the Domain Name Maintenance page, the save changes button calls the ModifyNS
command.
- 799 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The query must pass name servers that are registered at NSI.
l Name servers for .us names must be located in the United States.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 800 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
l To set name servers to eNoms set the UseDNS=ours param and don't pass NS(x)
name servers. To setname servers to your name servers, set NSX-
X=YourNameServerX and don't pass UseDNS=default. Youcan set up to 12 of
your own name servers.
Example
The following query changes the name servers for resellerdocs.com to ns1.name-ser-
vices.com and ns2.name-services.com, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=modifyns&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ns1=ns1.name-services.com
&ns2=ns2.name-services.com&responsetype=xml
In the reponse, an ErrCount value 0 indicates that the change of name servers was suc-
cessful:
Output
- 801 -
API Command Categories
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNS
l GetDNSStatus
l ModifyNSHosting
l RegisterNameServer
l UpdateNameServer
ModifyNSHosting
Description
Definition
Modify the name server settings for a domain name, in our database, without changing
the settings at the Registry.
Usage
ModifyNSHosting redirects to another set of name servers without updating the Registry
records. ModifyNS, a similar command, updates name server records at the Registry and
in the registrars database.
- 802 -
API Command Categories
Use this command when name servers are set correctly at the Registry but incorrectly in
our records.
Use this command when a domain name is registered in your account, and uses DNS
Hosting in a different account. In this case, set the name servers to our name servers at
the Registry, and to N/A in our database.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The name server cited in the query must exist.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 803 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query designates ns1.name-services.com as the name server for reseller-
docs.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=modifynshosting&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&ns1=ns1.name-services.com
&responsetype=xml
- 804 -
API Command Categories
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNS
l GetDNSStatus
l ModifyNS
l RegisterNameServer
l UpdateNameServer
ModifyPOP3
Description
Definition
Modify POP account password.
Usage
Use this command to change the password of one or more POP3 mail accounts in a
domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameID=152533676
- 805 -
API Command Categories
On the Domain Name Maintenance page, in the Edit POP mail accounts box, typing a
new password and clicking the add to cart button to save modifications calls the Modi-
fyPOP3 command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The POP3 service need not be active for the password change to be successful.
l The values of UserName in the query must exist for the domain.
l The value for EmailCount must match the number of UserNames and Passwords
in the query.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 806 -
API Command Categories
Either IsAdminX or
PasswordX is
PasswordX X=1 to New password for UserNameXs mail-
Required They 50
EmailCount box.
may be used
together.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 807 -
API Command Categories
Example
The following query requests that two POP3 passwords change in resellerdocs.com:
user name john should now have password johnpw and user name jane should now
have password janepw. The query also requests that the response be in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=modifypop3&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&emailcount=2&username1=john
&password1=johnpw&username2=jane
&password2=janepw&responsetype=xml
<interface-response>
<success>False</success>
<Command>MODIFYPOP3</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>11.125</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>47a90b83-b576-4345-a883-f322c-
ccdf219</TrackingKey>
<RequestDateTime>12/9/2011 3:30:38 AM</RequestDateTime>
</interface-response>
- 808 -
API Command Categories
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetForwarding
l GetMailHosts
l GetPOP3
l PurchasePOPBundle
l SetUpPOP3User
MySQL_GetDBInfo
Description
Definition
Retrieve a list of the MySQL databases in a Web hosting account.
Usage
Use this command to retrieve a list of the MySQL databases in a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/packagemanager.asp?
In the resellwebid row, click access.
In the menu, click MySQL / PHP.
The Manage MySQL Databases table is populated by the MySQL_GetDBInfo command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
- 809 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 810 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
Err(x)
as is back to the client
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of the MySQL databases in a Web hosting account,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=MySQL_GetDBInfo&uid=resellid&pw=resellpw
&HostAccount=resellwebid&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
- 811 -
API Command Categories
<DBMaxSize>50</DBMaxSize>
<DBCurrentSize>0</DBCurrentSize>
</Database>
<Database>
<DBName>resellwebid_db160</DBName>
<DBStatus>Active</DBStatus>
<DBDateCreated>8/2/2005 4:54:40 PM</DBDateCreated>
<DBMaxSize>50</DBMaxSize>
<DBCurrentSize>0</DBCurrentSize>
</Database>
<Database>
<DBName>resellwebid_db162</DBName>
<DBStatus>Active</DBStatus>
<DBDateCreated>8/3/2005 10:43:50 AM</DBDateCreated>
<DBMaxSize>50</DBMaxSize>
<DBCurrentSize>0</DBCurrentSize>
</Database>
</MySQLDatabases>
<Command>MYSQL_GETDBINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.4257813</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CreateHostAccount
l GetAllHostAccounts
l GetHostAccount
- 812 -
API Command Categories
NameSpinner
Description
Definition
Generate variations of a domain name that you specify, for .com, .net, .tv, and .cc TLDs.
Usage
Use this command to generate variations of the domain name you specify. This com-
mand will return TLDs .com, .net, .tv, and .cc.
Availability
All resellers have access to this command.
Implementation on eNom.com
https://resellertest.enom.com/domains/default.asp
Type an SLD into the Register A New Domain box and click GO. The results in the We
also recommend section are generated by the NameSpinner command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 813 -
API Command Categories
- 814 -
API Command Categories
OriginalSLD The SLD value you supplied in the input query string
- 815 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves 8 domains that resemble the input SLD hand, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=NameSpinner&UID=resellid&PW=resellpw
&SLD=hand&TLD=com&MaxResults=8&Similar=High
&ResponseType=XML
In the response, the presence of spun names and the ErrCount value 0 indicate that the
query was successful:
Output
<interface-response>
<namespin>
<spincount>8</spincount>
<TLDList/>
<domains>
<domain name="Richandbob" com="n" comscore="778" net="y"
netscore="806" tv="y" tvscore="742" cc="y" ccscore="709"/>
<domain name="Cardbyhand" com="y" comscore="799" net="y"
netscore="774" tv="y" tvscore="748" cc="y" ccscore="723"/>
<domain name="Side" com="n" comscore="831" net="n"
netscore="806" tv="y" tvscore="797" cc="y" ccscore="764"/>
- 816 -
API Command Categories
Related commands
l AddToCart
l Check
l Purchase
- 817 -
API Command Categories
NM_CancelOrder
Description
Definition
Cancel a Premium Domains order that was created with the AddToCart or Purchase
command with the pay-later parameter UseWireTransfer=Yes, but which was never com-
pleted.
Usage
Use this command to cancel a Premium Domains order that was created with the
AddToCart or Purchase command with the deferred payment parameter UseWireTrans-
fer=Yes, but which was never completed.
This command cancels an entire order. We do not offer a means of splitting an order that
includes multiple items.
If you do not redeem, extend, or cancel an order within 10 days, the order cancels auto-
matically.
Availability
You must be a direct ETP Reseller to sell Premium Domains.
Implementation on eNom.com
This command is not implemented on enom.com..
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Premium Domains order must be associated with this account.
l The Premium Domains order must have been submitted using the UseWireTrans-
fer=Yes parameterand must still be in Payment Pending status.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 818 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query cancels an uncompleted Premium Domains order, and sends the
response in XML format:
- 819 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=NM_CancelOrder&uid=resellid&pw=resellpw
&orderid=157707812&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 820 -
API Command Categories
Related commands
l NM_ExtendOrder
l NM_GetPremiumDomainSettings
l NM_GetSearchCategories
l NM_ProcessOrder
l NM_Search
l NM_SetPremiumDomainSettings
NM_ExtendOrder
Description
Definition
Extend the payment period for a Premium Domain to 10 days from today.
Usage
Use this command to extend the payment deferral period for a Premium Domain. This
command can be used for Premium Domains purchased using either the AddToCart or
Purchase command with the UseWireTransfer=Yes parameter.
This command extends the payment period to 10 days from today.
A Premium Domains order that was submitted with payment deferral can be extended
once.
If you do not pay for, extend, or cancel the order, it will automatically cancel 10 days after
being placed.
Availability
- 821 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Premium Domains order must have been submitted with UseWireTrans-
fer=Yes, and must be inpayment pending status.
l An order can only be extended once.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 822 -
API Command Categories
Parameter Description
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query extends a Premium Domains order that was submitted with
UseWireTransfer=Yes, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=NM_ExtendOrder&uid=resellid&pw=resellpw
&orderid=157708338&responsetype=xml
In the repsonse, a Success status True indicates that the query was successful:
Output
- 823 -
API Command Categories
Related commands
l NM_CancelOrder
l NM_GetPremiumDomainSettings
l NM_GetSearchCategories
l NM_ProcessOrder
- 824 -
API Command Categories
l NM_Search
l NM_SetPremiumDomainSettings
NM_GetPremiumDomainSettings
Description
Definition
Retrieve account-level settings associated with Premium Domains.
Usage
Use this command to retrieve account-level settings that are specific to Premium
Domains:
The minimum and maximum price of Premium Domains to be returned by Instant
Reseller.
The threshold price above which you want to pay by wire transfer instead of using your
account balance.
Availability
Premium Domains can only be sold by our direct ETP resellers.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/premium-domain-pricing.aspx
The NM_GetPremiumDomainSettings command populates the Premium Domain Pri-
cing dollar amount.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
- 825 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 826 -
API Command Categories
Example
The following query retrieves and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=NM_GetPremiumDomainSettings&uid=resellid
&pw=resellpw&responsetype=xml
- 827 -
API Command Categories
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.109 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 5681f3a4-551c-4b01-8e63-20bc6ab7086a ]]>
</TrackingKey>
</interface-response>
Related commands
l NM_CancelOrder
l NM_ExtendOrder
l NM_GetSearchCategories
l NM_ProcessOrder
l NM_Search
l NM_SetPremiumDomainSettings
NM_GetSearchCategories
Description
Definition
Retrieve Premium Domain search categories and subcategories.
Usage
Use this command to retrieve search categories and/or subcategories for Premium
Domains.
- 828 -
API Command Categories
You can use this command to populate the Category and Subcategory values in the
NM_Search command.These would typically be rendered as Category and Subcategory
menus in a user interface.
Availability
Only our direct ETP resellers can sell Premium Domains.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 829 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the subcategories associated with category 169 (Recre-
ation) and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=NM_GetSearchCategories&uid=resellid&pw=resellpw
&Display=SubCategories&CategoryID=169&responsetype=xml
- 830 -
API Command Categories
In the response, a list of subcategories and an ErrCount value 0 indicate that the query
was successful:
Output
- 831 -
API Command Categories
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.156 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 7ba0df6d-6c15-4b16-84d3-0e31e6c2f8d3 ]]>
</TrackingKey>
</interface-response>
Related commands
l NM_CancelOrder
l NM_ExtendOrder
l NM_GetPremiumDomainSettings
l NM_ProcessOrder
l NM_Search
l NM_SetPremiumDomainSettings
NM_ProcessOrder
Description
Definition
- 832 -
API Command Categories
Finish processing a Premium Domain order that you initiated with the AddToCart or
Purchase command, using the deferred payment parameter, UseWireTransfer=Yes.
Usage
Use this command to use the account balance to pay for a Premium Domain order that
was originally submitted with the AddToCart or Purchase command, using the pay-later
parameter, UseWireTransfer=Yes.
Availability
You must be one of our direct ETP Resellers to sell Premium Domains.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Premium Domain order ID must be associated with this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 833 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query uses the account balance to pay for a Premium Domains order that
was originally submitted with our deferred payment option, UseWireTransfer=Yes:
Query
https://resellertest.enom.com/interface.asp?
command=nm_processorder&uid=resellid&pw=resellpw
&orderid=157707813&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 834 -
API Command Categories
<Success>
<![CDATA[ True ]]>
</Success>
<Command>
<![CDATA[ NM_PROCESSORDER ]]>
</Command>
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
- <![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
- <![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
- <![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
- <![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
- <![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
- <![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
- <![CDATA[ 0.391 ]]>
</ExecTime>
<Done>
- <![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 000e422f-fbee-4da2-bbe5-6bb9e9a33c67 ]]>
</TrackingKey>
</interface-response>
- 835 -
API Command Categories
Related commands
l NM_CancelOrder
l NM_ExtendOrder
l NM_GetPremiumDomainSettings
l NM_GetSearchCategories
l NM_Search
l NM_SetPremiumDomainSettings
NM_Search
Description
Definition
Search for available Premium Domains.
Usage
Use this command to search for Premium Domains that are available for purchase.
Availability
Premium Domains can only be sold by our direct ETP resellers.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domainsearch/search-premium.aspx
The text box populates the Keyword parameter, we set Record-
sToReturn=50&SortBy=Quality, and the Search button calls the NM_Search command.
Our UI divides the 50 results into five pages of 10 domains each.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
- 836 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Optional; default Return domain names that start with this char-
StartsWith 1
is no filter acter. Permitted values are alphanumeric
Optional; default Return domain names that end with this char-
EndsWithWith 1
is no filter acter. Permitted values are alphanumeric
Optional; by
default, the Topic category to search. Use the NM_
Category scope of a GetSearchCategories command to retrieve 3
search is all cat- search categories
egories
Optional; by
default, the Topic subcategory to search. Use the NM_
Subcategory scope of a GetSearchCategories to retrieve search sub- 3
search is all sub- categories
categories
- 837 -
API Command Categories
Optional; default For this set of results, start with this position
StartPosition ?
is 1 in the set of 25 domains, use Record-
- 838 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=HTML or Respon-
seType=XML in your request.
l Check the return parameter o the client. Otherwise process the If greater than 0 the
transaction failed. The parameter Err(ErrCount) can be presented to the client.
Otherwise process the returned parameters as defined above.
Example
The following query searches on comma-dilimited keywords, sorts by quality, and pages
the results:
Query
- 839 -
API Command Categories
https://resellertest.enom.com/interface.asp?
Command=NM_Search& uid=resellid&pw=resellpw
&Keyword=Box,Office&SortBy=quality
&RecordsToReturn=10&StartPosition=1&responsetype=xml
In the response, a list of matches and an ErrCount value 0 indicate that the query was
successful:
Output
- 840 -
API Command Categories
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.406 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 122c8b26-60f6-4dde-8a2d-dae0a5898bf7 ]]>
</TrackingKey>
</interface-response>
Related commands
l NM_CancelOrder
l NM_ExtendOrder
l NM_GetPremiumDomainSettings
l NM_GetSearchCategories
l NM_ProcessOrder
l NM_SetPremiumDomainSettings
- 841 -
API Command Categories
NM_SetPremiumDomainSettings
Description
Definition
Set the threshold at which you want to require payment for Premium Domains by wire
transfer to us.
Usage
Use this command to set the threshold price above which you want to always pay your
Premium Domains order by wire transfer. You can use this setting as a means of ensur-
ing that orders dont fail due to an insufficient account balance.
You also have the option of deferring payment at lower price levels, using the
UseWireTransfer parameter in the Purchase or InsertNewOrder commands.
The account-level deferred payment threshold that you set with the NM_SetPremi-
umDomainSettings command applies in the following ways:
l If you use the Purchase command to purchase domain names, the threshold
applies to the price of thesingle Premium Domain in the query string.
l If you use AddToCart and InsertNewOrder to purchase domain names, the
threshold applies to the sumof the Premium Domains, plus the services attached to
them, in an order.
There are a few considerations within our system to be aware of, to guide you in choos-
ing a threshold for deferredpayment:
l We place a limit on orders that use our merchant services to process credit cards. If
you normally use our merchant services and want to offer your customers Premium
Domains over that limit in value, you must establish a system to pay us, and to
charge your customers, that is outside our merchant services environment. The
lower the wire transfer threshold you choose, the more likely you are to need this
system.
l When youre ready to submit your deferred payment, use the NM_ProcessOrder
command to completethe order using your account balance, or contact your sales
representative for wire transfer instructions.
Availability
Premium Domains can only be sold by our direct ETP resellers.
Implementation on eNom.com
This command is not implemented on enom.com.
- 842 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 843 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query specifies account-level settings for Premium Domains: wire transfer
threshold. It sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=NM_SetPremi-
umDomainSettings&uid=resellid&pw=resellpw
&wiretransferthreshold=4000&responsetype=xml
In the response, a Status value Successful indicates that the query was successful:
Output
- 844 -
API Command Categories
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.141 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ e5f9e424-f92f-40a7-92e3-0786ca6035cc ]]>
</TrackingKey>
</interface-response>
Related commands
l NM_CancelOrder
l NM_ExtendOrder
l NM_GetPremiumDomainSettings
l NM_GetSearchCategories
l NM_ProcessOrder
l NM_Search
ParseDomain
Description
Definition
Separate the domain name into its host, SLD, and TLD.
- 845 -
API Command Categories
Usage
Use this command to separate a domain name into its constituent parts.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 846 -
API Command Categories
Parameter Description
SLD Second-level domain name (for example, enom in enom.com)
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query separates the domain name www.resellerdocs.com into its Host,
SLD, and TLD, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=parsedomain&uid=resellid&pw=resellpw
&passeddomain=www.resellerdocs.com&responsetype=xml
- 847 -
API Command Categories
<Host>www</Host>
<SLD>resellerdocs</SLD>
<TLD>com</TLD>
</ParseDomain>
<Command>PARSEDOMAIN</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l None
PE_GetCustomerPricing
Description
Definition
Get retail prices that this account charges to consumers. These are also the prices that
this accounts subaccounts will be charged, unless you change them for each individual
subaccount.
Usage
Use this command to retrieve prices that you have changed from their default values.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-List.asp
- 848 -
API Command Categories
If you click a Login ID of a retail subaccount, the link calls the PE_GetCustomerPricing
command. If you click a Login ID of a reseller subaccount, the link calls the PE_
GetResellerPrice command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 849 -
API Command Categories
Parameter Description
41 Registration and email forwarding by the .name Registry
44 .name registration and email forwarding renewal
Product type for Web hosting and Web site creation services.
Permitted values are:
50 Web hosting account with Access database
51 Web hosting component - 20GB bandwidth
52 Web hosting component - 1GB Web storage
53 Web hosting component - 250MB SQL database storage
54 Web hosting component - 10 POP mailboxes
55 Web hosting setup fee
ProductType for Web hosting and Web 56 Web hosting bandwidth overage, at per-1GB overage pro-
site creation services tection rate
57 Web hosting bandwidth overage fee, with upgrade
58 Web hosting component - 100MB POP storage
86 Web Site Creator without Web hosting - Basic
87 Web Site Creator without Web hosting - Full
88 Web Site Creator without Web hosting - eCommerce
90 Web Site Creator added to Web hosting - Basic
91 Web Site Creator added to Web hosting - Full
92 Web Site Creator added to Web hosting - eCommerce
- 850 -
API Command Categories
Parameter Description
46 Email forwarding by us - renewal
Enabled Enabled state for this TLD. Options are True or False.
- 851 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the price that subaccount ichiro charges for transferring a
.org domain name, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETCUSTOMERPRICING& uid=resellid
&pw=resellpw&ProductType=19&tld=org&responsetype=xml
The response indicates that the price for transferring a .org name is $8.95, and .org trans-
fers are enabled in this subaccount:
Output
<interface-response>
<productstructure>
<product>
<cpid>2490167</cpid>
<producttype>10</producttype>
<productdescription>Register</productdescription>
<tldid>0</tldid>
<tld>com</tld>
<retailprice>15</retailprice>
<resellerprice/>
<rocketprice/>
<enabled>True</enabled>
<minimumregistration>1</minimumregistration>
</product>
<product>
<cpid>2490168</cpid>
<producttype>10</producttype>
- 852 -
API Command Categories
<productdescription>Register</productdescription>
<tldid>0</tldid>
<tld>com</tld>
<retailprice>25.95</retailprice>
<resellerprice>8.95</resellerprice>
<rocketprice/>
<enabled>True</enabled>
<minimumregistration>1</minimumregistration>
</product>
.
.
.
</productstructure>
<Command>PE_GETCUSTOMERPRICING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+07.00</TimeDifference>
<ExecTime>0.438</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 11:07:40 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CommissionAccount
l GetBalance
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
- 853 -
API Command Categories
PE_GetDomainPricing
Description
Definition
Get the retail pricing that this account charges for registrations, renewals, and transfers,
by top-level domain.
Usage
Use this command when you want a list of retail prices for one top-level domain, for regis-
trations, renewals, and transfers. To get a list of retail prices for all products offered by
this account, use PE_GetRetailPricing.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-Manage.asp?Account=850-tn-1053
PE_GetDomainPricing is not implemented on enom.com. The sub-account configuration
page displays similar information, but for all top-level domains.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 854 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the pricing for account resellid for the various top-level
domains, with the response in XML format:
Query
- 855 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=PE_GETDOMAINPRICING&uid=resellid
&pw=resellpw&responsetype=xml
The response indicates that the price of .com domains is $8.95 per year, .net is $8.95 per
year, and so on:
Output
<interface-response>
<DisplayPriceIncrease>0</DisplayPriceIncrease>
<pricestructure>
<product>
<tld>com</tld>
<tldid>0</tldid>
<registerprice>8.95</registerprice>
<resellerpricereg>8.95</resellerpricereg>
<registerenabled>True</registerenabled>
<renewprice>8.95</renewprice>
<resellerpricerenew>8.95</resellerpricerenew>
<renewenabled>True</renewenabled>
<transferprice>8.95</transferprice>
<resellerpricetran>8.95</resellerpricetran>
<transferenabled>True</transferenabled>
</product>
<product>
<tld>net</tld>
<tldid>1</tldid>
<registerprice>8.95</registerprice>
<resellerpricereg>8.95</resellerpricereg>
<registerenabled>True</registerenabled>
<renewprice>8.95</renewprice>
<resellerpricerenew>8.95</resellerpricerenew>
<renewenabled>True</renewenabled>
<transferprice>8.95</transferprice>
<resellerpricetran>8.95</resellerpricetran>
<transferenabled>True</transferenabled>
</product>
.
.
.
<count>96</count>
- 856 -
API Command Categories
</pricestructure>
<Command>PE_GETDOMAINPRICING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>3.470</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 3:40:47 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CommissionAccount
l GetBalance
l PE_GetCustomerPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
PE_GetEapPricing
Description
Definition
Get Early Access Program (EAP) pricing and phase information for a list of TLDs, includ-
ing if there are pending orders for the domain for the given EAP day.
Usage
Use this command to retrieve prices for a list of domains in EAP status.
- 857 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
This is used to show the pre-registration options for a TLD on the queue search results.
http://resellertest.enom.com/tld-queue/pages/search-results.aspx?sld=trading&tld=cards
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l At least one domain must be passed in
l The TLD must be a TLD sold through Donuts Inc.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 858 -
API Command Categories
EAP Day number for that phase. Will only be present for EAP
Day
phase items.
ReleaseDate Localized time that the phase gets released. Time is in PST.
Order(s) exist for this SLD.TLD in the given EAP day? Will not
OrderCount
be returned for non EAP phases.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the price that account resellid will be charged and their
retail price for registering the domain name trading.cards, and requests the response in
XML format:
- 859 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=PE_GetEapPricing& uid=resellid&pw=resellpw
&sld1=trading&tld1=cards&responsetype=xml
The response indicates the available days to place a pre-registration for EAP and the pri-
cing available to the reseller.
Output
<interface-response>
<domains>
<domain domain="trading.cards" sld="trading" tld="cards"
tldid="488">
<pricing>
<phase>Pre-registration</phase>
<price>930.00</price>
<retailprice>1,208.00</retailprice>
<releasedate>2014-06-18T09:00:00</releasedate>
<releasedate-utc>2014-06-18T16:00:00</releasedate-utc>
<ordercount/>
</pricing>
<pricing>
<phase>EAP</phase>
<day>1</day>
<price>11,920.00</price>
<retailprice>14,946.00</retailprice>
<releasedate>2014-06-11T09:00:00</releasedate>
<releasedate-utc>2014-06-11T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
<day>2</day>
<price>3,670.00</price>
<retailprice>4,634.00</retailprice>
<releasedate>2014-06-12T09:00:00</releasedate>
<releasedate-utc>2014-06-12T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
- 860 -
API Command Categories
<day>3</day>
<price>2,013.00</price>
<retailprice>2,563.00</retailprice>
<releasedate>2014-06-13T09:00:00</releasedate>
<releasedate-utc>2014-06-13T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
<day>4</day>
<price>1,495.00</price>
<retailprice>1,944.00</retailprice>
<releasedate>2014-06-14T09:00:00</releasedate>
<releasedate-utc>2014-06-14T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
<day>5</day>
<price>1,030.00</price>
<retailprice>1,334.00</retailprice>
<releasedate>2014-06-15T09:00:00</releasedate>
<releasedate-utc>2014-06-15T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
<day>6</day>
<price>1,030.00</price>
<retailprice>1,334.00</retailprice>
<releasedate>2014-06-16T09:00:00</releasedate>
<releasedate-utc>2014-06-16T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
</pricing>
<pricing>
<phase>EAP</phase>
<day>7</day>
<price>1,030.00</price>
<retailprice>1,334.00</retailprice>
<releasedate>2014-06-17T09:00:00</releasedate>
<releasedate-utc>2014-06-17T16:00:00</releasedate-utc>
<ordercount>0</ordercount>
- 861 -
API Command Categories
</pricing>
</domain>
</domains>
<Command>PE_GETEAPPRICING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.453</ExecTime>
<RequestDateTime>5/6/2014 11:40:48 AM</RequestDateTime>
<debug/>
</interface-response>
Related commands
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
PE_GetPOPPrice
Description
Definition
Retrieve the wholesale price that this account pays for POP mail 10-paks.
Usage
Use this command to retrieve the wholesale price that this account pays for POP mail
10-paks.
- 862 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/ProductPricing.asp?tab=domainaddons
In the POP3 email paks row, the value in the Your cost column is supplied by the PE_
GetPOPPrice command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 863 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the wholesale price that account resellid pays for a POP
10-pak, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETPOPPRICE&uid=resellid&pw=resellpw
&responsetype=xml
In the response, a pop pricing value and an ErrCount value 0 confirm that the query was
successful:
Output
- 864 -
API Command Categories
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>8.203125E-02</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetPOP3
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l PE_SetPricing
l PurchasePOPBundle
PE_GetPremiumPricing
Description
Definition
Retrieve the premium pricing for a list of domains.
Usage
Use this command to retrieve the premium pricing for a list of domains.
Availability
- 865 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
SLDx X=1 to
Required Second level domain 8
DomainCount
- 866 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the premium pricings for a list of domains, and requests the
response in XML format.
Query
https://resellertest.enom.com/interface.asp?
command=PE_GetPremiumPricing&uid=resellid
&pw=resellpw&responsetype=xml&sld1=bike48n25&tld1=bike
&qname1=sunrise&sld2=bike48n01&tld2=ninja
&qname2=sunrise&producttype=register
- 867 -
API Command Categories
Output
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_DomainPurchase
- 868 -
API Command Categories
l Queue_GetDomains
l Queue_GetOrders
l Queue_GetOrderDetail
l GetAgreementPage
PE_GetProductPrice
Description
Definition
Retrieve the wholesale cost that this account pays for a product.
Usage
Use this command to retrieve wholesale pricing information for a single product.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/RenewalPricing.asp?tab=1
Each value in the Your Cost column could be retrieved using one call to the PE_GetPro-
ductPrice command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command =nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 869 -
API Command Categories
- 870 -
API Command Categories
- 871 -
API Command Categories
Parameter Description
Price Wholesale price that the UID pays for this product
- 872 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the price for registering a .com domain, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETPRODUCTPRICE&uid=resellid&pw=resellpw
&ProductType=10&tld=com&responsetype=xml
In the response, a price and an enabled status for the product confirm that the query was
successful:
Output
- 873 -
API Command Categories
</productprice>
<Command>PE_GETPRODUCTPRICE</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.1015625</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l PE_SetPricing
PE_GetResellerPrice
Description
Definition
Get the wholesale price that this account pays for one product, and tell whether that
product is enabled.
Usage
- 874 -
API Command Categories
Use this command to retrieve the price of one product. For example, you can use this
command to retrieve the price you pay for registering a .com name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-List.asp
On the home > pricing info page, each individual price can be retrieved using PE_
GetResellerPrice.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 875 -
API Command Categories
- 876 -
API Command Categories
- 877 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the price for registration of a .org domain name, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETRESELLERPRICE&uid=resellid&pw=resellpw
&tld=org&ProductType=10&responsetype=xml
The response indicates that a .org domain name is $8.95 per year:
Output
- 878 -
API Command Categories
<Server>ResellerTest</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l CommissionAccount
l GetBalance
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
PE_GetRetailPrice
Description
Definition
Get the Retail pricing for a specified product, and tell whether the product is enabled.
The Retail price is the price you charge to your retail customers; it is also the price you
charge your subaccounts unless you set prices specifically for each subaccount using
commands such as UpdateAccountPricing, GetSubAccountDetails, or PE_SetPricing.
Usage
Use this command to retrieve pricing for a single product. For example, you can use this
command to retrieve the price for renewing a .org name that you currently have set for
one retail subaccount.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 879 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 880 -
API Command Categories
- 881 -
API Command Categories
- 882 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 883 -
API Command Categories
Example
The following query requests the price for registering a .org name, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETRETAILPRICE&uid=resellid&pw=resellpw
&ProductType=10&responsetype=xml
<interface-response>
<productprice>
<price>15</price>
<productenabled>True</productenabled>
<minimumregistration>1</minimumregistration>
</productprice>
<Command>PE_GETRETAILPRICE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.140</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 3:45:37 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CommissionAccount
l GetBalance
- 884 -
API Command Categories
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRocketPrice
l PE_SetPricing
PE_GetRetailPricing
Description
Definition
Retrieve the retail prices that this account charges for all products, and their enabled
status.
"Retail" prices apply to retail customers of this account. They also apply to any sub-
accounts in which the prices the subaccount pays have not been set for that individual
subaccount using a command such as UpdateAccountPricing, GetSubAccountDetails,
or PE_SetPricing.
Usage
Use this command to display the full list of retail prices for this account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
On the my enom > settings page, the Default Account/Sub-Account Pricing section dis-
plays the query results for PE_GetRetailPricing.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 885 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 886 -
API Command Categories
Parameter Description
Product type for SSL certificates. Permitted values are:
211 SSL certificate - Comodo Essential
212 SSL certificate - Comodo Instant
214 SSL certificate - Comodo Essential Wildcard
213 SSL certificate - Comodo Premium Wildcard
221 SSL certificate - Comodo EV
222 SSL certificate - Comodo EV SGC
20 SSL certificate - GeoTrust QuickSSL Premium
ProductType for SSL certificates 21 SSL certificate - GeoTrust True BusinessID
24 SSL certificate - GeoTrust True BusinessID with EV
26 SSL certificate - GeoTrust QuickSSL
27 SSL certificate - GeoTrustTrueBizID Wildcard
23 SSL certificate - RapidSSL
180 SSL certificate - VeriSign Secure Site
181 SSL certificate - VeriSign Secure Site Pro
182 SSL certificate - VeriSign Secure Site EV
183 SSL certificate - VeriSign Secure Site Pro EV
Product type for Web hosting and Web site creation services.
Permitted values are:
50 Web hosting account with Access database
51 Web hosting component - 20GB bandwidth
52 Web hosting component - 1GB Web storage
53 Web hosting component - 250MB SQL database storage
54 Web hosting component - 10 POP mailboxes
55 Web hosting setup fee
ProductType for Web hosting and Web 56 Web hosting bandwidth overage, at per-1GB overage pro-
site creation services tection rate
57 Web hosting bandwidth overage fee, with upgrade
58 Web hosting component - 100MB POP storage
86 Web Site Creator without Web hosting - Basic
87 Web Site Creator without Web hosting - Full
88 Web Site Creator without Web hosting - eCommerce
90 Web Site Creator added to Web hosting - Basic
91 Web Site Creator added to Web hosting - Full
92 Web Site Creator added to Web hosting
- 887 -
API Command Categories
Parameter Description
Product type for all other services. Permitted values are:
47 URL forwarding
48 URL forwarding - renewal
65 Private label annual subscription
66 Private label annual renewal
72 ID Protect (Whois Privacy Protection)
73 ID Protect - renewal
140 Business Listing
141 Business Listing renewal
235 goMobi
ProductType for all other services
236 goMobi free trial
200 RichContent free trial
201 RichContent
215 Instant Reseller
216 Instant Reseller renewal
217 Instant Reseller upgrade
240 TRUSTe Privacy Policy
241 TRUSTe Privacy Policy renewal
242 TRUSTe Privacy Policy with Seal
243 TRUSTe Privacy Policy with Seal renewal
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the prices that account resellid
is charging for all products, and whether the
- 888 -
API Command Categories
https://resellertest.enom.com/interface.asp?
uid=resellid&pw=resellpw&command=PE_GetRetailPricing
&responsetype=xml
The response lists the prices for all products, and tells whether they are offered in this
account:
Output
- 889 -
API Command Categories
<productenabled>True</productenabled>
<producttype>45</producttype>
</product>
<product>
<price>29.95</price>
<productenabled>True</productenabled>
<producttype>47</producttype>
</product>
</pricestructure>
<Command>PE_GETRETAILPRICING</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>0</IsLockable>
<IsRealTimeTLD>0</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetResellerPrice
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRocketPrice
l PE_SetPricing
l UpdateAccountPricing
PE_GetRocketPrice
Description
Definition
- 890 -
API Command Categories
Get the pricing and enabled state for a Registry Rocket key.
Usage
Use this command to get the price for one product, for one top-level domain. For
example, you can use this command to retrieve the price for renewing a .org name. This
command is most useful to resellers who offer a restricted set of top-level domains.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/CCProcessingSignUp.asp
This command is not implemented on enom.com. However, on the registry rocket page,
the create link button returns similar information.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue &nextparamname=nextparamvalue
- 891 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Product types are: 10=register, 13=hosting, 14=hosting renew, 16=renew, 19=tran-
nsfer.
Example
The following query requests the Registry Rocket price for .org domain names, with
response in XML format:
Query
- 892 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=PE_GetRocketPrice&uid=resellid&pw=resellpw&tld=org
&ProductType=10&responsetype=xml
The response indicates that the price for .org names is $29.95 per year, and sales of .org
are enabled:
Output
Related commands
l CommissionAccount
l GetBalance
l GetWebHostingAll
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_SetPricing
- 893 -
API Command Categories
PE_GetTLDID
Description
Definition
Retrieve the ID number for a TLD.
Usage
Use this command to retrieve the ID number for a TLD.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 894 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the ID number for the .org TLD, and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_GETTLDID&uid=resellid&pw=resellpw
&tld=org&responsetype=xml
In the response, a value for the TLDID parameter confirms that the query was successful:
Output
- 895 -
API Command Categories
<productid>
<tldid>2</tldid>
</productid>
<Command>PE_GETTLDID</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+07.00</TimeDifference>
<ExecTime>0.1015625</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PE_SetPricing
l SetResellerTLDPricing
PE_SetPricing
Description
Definition
Set prices you charge subaccounts for our products and services. You can use this com-
mand to set any number of prices.
Usage
Use this command to set the prices you charge subaccounts for our products and ser-
vices. You can use this command to set any number of prices.
Availability
- 896 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
If setting sub-
account prices,
Party ID of the subaccount to set pricing
PartyID either PartyID or 40
for
LoginID is
Required
If setting sub-
account prices,
Login ID of the subaccount to set pricing
LoginID either PartyID or 20
for
LoginID is
Required
- 897 -
API Command Categories
- 898 -
API Command Categories
- 899 -
API Command Categories
- 900 -
API Command Categories
Required if setting
ResellerKey a Registry Rocket Registry Rocket key 40
price
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Either LoginID or PartyID is required. If LoginID is passed in then it will override the
PartyID if it is also
- 901 -
API Command Categories
l passed in.
l At least one Price must be supplied.
Example
The following query requests that the retail price for registering .org names be set at
$44.00 and for renewing .org names $45.00, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PE_SetPricing&uid=resellid&pw=resellpw
&ProductType1=10&TLD1=org&Enabled1=1&Price1=44
&ProductType2=16&TLD2=org&Enabled2=1&Price2=45
&responsetype=xml
In the response, the Status Successful and Errcount 0 confirm that the query suc-
cessfully reset 2 prices:
Output
Related commands
l AuthorizeTLD
l CommissionAccount
- 902 -
API Command Categories
l GetBalance
l GetTLDList
l GetWebHostingAll
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetPOPPrice
l PE_GetProductPrice
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l PE_GetTLDID
l RemoveTLD
l SetResellerServicesPricing
l SetResellerTLDPricing
l UpdateAccountPricing
Portal_GetAwardedDomains
Description
Definition
This command will get a list of domains awarded to watchlist users belonging to the par-
ent reseller.
Usage
This command will get a list of all domains that have been awarded to the resellers
watchlist users. Only domains that have not yet been marked as provisioned will be
returned by this command.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not utilized on enom.com as it is intended for partner integration
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 903 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 904 -
API Command Categories
Parameter Description
Next starting position to use for those paging through the res-
NextStartPosition
ults.
RegisterPrice The users registration price. This is the price that they paid.
The users registration price. This is the price that they would
RenewPrice
pay to renew the domain at your current pricing.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 905 -
API Command Categories
Example
The following query retrieves a single domain, and sends the response in XML format:
Query
http://resellertest.enom.com/interface.asp?
command=Portal_GetAwardedDomains&UID=resellid
&PW=resellpw&RecordCount=1&RecordOption=1&ResponseType=XML
In the response, the presence of Success with a value of True AND the ErrCount value 0
indicate that the query was successful:
Output
<interface-response>
<Domains>
<Domain>
<DomainName>mynewdomain.ninja</DomainName>
<EmailAddress>someguy@gmail.com</EmailAddress>
<ExpirationDate>5/28/2019</ExpirationDate>
<RegisterDate>5/28/2014</RegisterDate>
<ForeignLoginId>Fred Penner</ForeignLoginId>
<PortalDomainId>123456789</PortalDomainId>
<RegisterPrice>19.99</RegisterPrice>
<RenewPrice>19.99</RenewPrice>
<RegistrationPeriod>5</RegistrationPeriod>
<ResellerProvisioned>1</ResellerProvisioned>
<Reseller-
ProvisionedDate>5/29/2014</ResellerProvisionedDate>
<IsPremium>0</IsPremium>
<RegistrationStatus>Registered</RegistrationStatus>
</Domain>
<DomainCount>1</DomainCount>
<TotalDomainCount>10</TotalDomainCount>
<NextStartPosition>2</NextStartPosition>
- 906 -
API Command Categories
</Domains>
<Success>True</Success>
<Command>Portal_GetAwardedDomains</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.750</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>9efbb8e7-1cc3-4f2b-bbc2-cbe2517522aa</Track-
ingKey>
<RequestDateTime>5/30/2014 2:51:56 PM</RequestDateTime>
</interface-response>
Related commands
l PORTAL_GETTOKEN
l PORTAL_UPDATEAWARDEDDOMAINS
Portal_GetDomainInfo
Description
Definition
Get information about a domain registered through portal.
Usage
Use this command to get information about a domain registered through portal.
Availability
All resellers have access to this command.
- 907 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 908 -
API Command Categories
Parameter Description
RenewPrice Renewal price
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 909 -
API Command Categories
Example
The following query gets information about a domain registered through portal, and
requests the response in XML format.
Query
http://resellertest.enom.com/interface.asp?
command=portal_getdomaininfo&uid=resellid&pw=resellpw
&responsetype=xml&sld=domaintest&tld=camera
Output
- 910 -
API Command Categories
- 911 -
API Command Categories
<CCStateProvince>WA</CCStateProvince>
<CCCountry>US</CCCountry>
<CCPhone>+1.4252744500</CCPhone>
</Payment>
<Contacts>
<Registrant>
<RegistrantPartyID>{3c850aea-ff6b-e311-acb1-0050568631ab}
</RegistrantPartyID>
<RegistrantOrganizationName>-</RegistrantOrganizationName>
<RegistrantJobTitle>-</RegistrantJobTitle>
<RegistrantFirstName>Jim</RegistrantFirstName>
<RegistrantLastName>Smith</RegistrantLastName>
<RegistrantAddress1>1st Ave</RegistrantAddress1>
<RegistrantAddress2 />
<RegistrantCity>Kirkland</RegistrantCity>
<RegistrantCountry>US</RegistrantCountry>
<RegistrantStateProvince>WA</RegistrantStateProvince>
<Regis-
trantStateProvinceChoice>S</RegistrantStateProvinceChoice>
<RegistrantPostalCode>98033</RegistrantPostalCode>
<Regis-
trantE-
mailAddress>someone@domain.com</RegistrantEmailAddress>
<RegistrantPhone>+1.4252744500</RegistrantPhone>
<RegistrantPhoneExt />
<RegistrantFax />
</Registrant>
<AuxBilling>
<AuxBillingPartyID>{3c850aea-ff6b-e311-acb1-0050568631ab}
</AuxBillingPartyID>
<AuxBillingOrganizationName>-</AuxBillingOrganizationName>
<AuxBillingJobTitle>-</AuxBillingJobTitle>
<AuxBillingFirstName>Jim</AuxBillingFirstName>
<AuxBillingLastName>Smith</AuxBillingLastName>
<AuxBillingAddress1>1st Ave</AuxBillingAddress1>
<AuxBillingAddress2 />
<AuxBillingCity>Kirkland</AuxBillingCity>
<AuxBillingCountry>US</AuxBillingCountry>
<AuxBillingStateProvince>WA</AuxBillingStateProvince>
<AuxBillingStateProvinceChoice>S</AuxBillingStateProvinceCh-
oice>
<AuxBillingPostalCode>98033</AuxBillingPostalCode>
- 912 -
API Command Categories
<AuxBillingE-
mailAddress>someone@domain.com</AuxBillingEmailAddress>
<AuxBillingPhone>+1.4252744500</AuxBillingPhone>
<AuxBillingPhoneExt />
<AuxBillingFax />
<UseRegInfoAbove>True</UseRegInfoAbove>
<auxID>{3c850aea-ff6b-e311-acb1-0050568631ab}</auxID>
<regID>{3c850aea-ff6b-e311-acb1-0050568631ab}</regID>
</AuxBilling>
<Technical>
<TechnicalPartyID>{3c850aea-ff6b-e311-acb1-0050568631ab}
</TechnicalPartyID>
<TechnicalOrganizationName>-</TechnicalOrganizationName>
<TechnicalJobTitle>-</TechnicalJobTitle>
<TechnicalFirstName>Jim</TechnicalFirstName>
<TechnicalLastName>Smith</TechnicalLastName>
<TechnicalAddress1>1st Ave</TechnicalAddress1>
<TechnicalAddress2 />
<TechnicalCity>Kirkland</TechnicalCity>
<TechnicalCountry>US</TechnicalCountry>
<TechnicalStateProvince>WA</TechnicalStateProvince>
<Tech-
nicalStateProvinceChoice>S</TechnicalStateProvinceChoice>
<TechnicalPostalCode>98033</TechnicalPostalCode>
<Tech-
nic-
alEmailAddress>someone@domain.com</TechnicalEmailAddress>
<TechnicalPhone>+1.4252744500</TechnicalPhone>
<TechnicalPhoneExt />
<TechnicalFax />
</Technical>
<Admin>
<AdminPartyID>{3c850aea-ff6b-e311-acb1-0050568631ab}</Ad-
minPartyID>
<AdminOrganizationName>-</AdminOrganizationName>
<AdminJobTitle>-</AdminJobTitle>
<AdminFirstName>Jim</AdminFirstName>
<AdminLastName>Smith</AdminLastName>
<AdminAddress1>1st Ave</AdminAddress1>
<AdminAddress2 />
<AdminCity>Kirkland</AdminCity>
<AdminCountry>US</AdminCountry>
- 913 -
API Command Categories
<AdminStateProvince>WA</AdminStateProvince>
<AdminStateProvinceChoice>S</AdminStateProvinceChoice>
<AdminPostalCode>98033</AdminPostalCode>
<AdminEmailAddress>someone@domain.com</AdminEmailAddress>
<AdminPhone>+1.4252744500</AdminPhone>
<AdminPhoneExt />
<AdminFax />
</Admin>
</Contacts>
<Success>True</Success>
<Command>PORTAL_GETDOMAININFO</Command>
<APIType>API.NET</APIType>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.188</ExecTime>
<Done>true</Done>
<TrackingKey>7d438b0f-3fd1-4d5d-9da8-4af45468b-
d76</TrackingKey>
<RequestDateTime>5/22/2014 11:17:34 AM</RequestDateTime>
</interface-response>
Portal_GetToken
Description
Definition
Get an access token which allows a user to auto login to a tld portal.
Usage
Use this command to get an access token which allow users to auto login to a tld portal.
Availability
All resellers have access to this command.
- 914 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Portal User ID must be unique.
l The Email address has to be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Done True indicates this entire response has reached you suc-
- 915 -
API Command Categories
Parameter Description
cessfully
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves list of TLDs currently offered for this account, and requests
the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
command=PORTAL_GETTOKEN&UID=ResellID&PW=resellpw
&PortalUserID=uniqueUserLoginID&email=user@example.com
&ResponseType=XML
Output
<?xml version="1.0"?>
<interface-response>
<token>E8888BD8D1D9DDD98DC4D8D1DADEC4DD8C8D8BC4888ADA8FC48D-
8CDD8CD8DEDC</token>
<Command>PORTAL_GETTOKEN</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>blvdt229</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
- 916 -
API Command Categories
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.065</ExecTime>
<Done>true</Done>
<TrackingKey>4cca5db4-a074-4d8d-baa2-f3b1317f97ff</Track-
ingKey>
<RequestDateTime>9/26/2012 9:12:12 AM</RequestDateTime>
</interface-response>
Portal_UpdateAwardedDomains
Description
Definition
This command will update a set list of domains awarded as reseller provisioned.
Usage
Use this command to to update a single domain or a list of domains that have been awar-
ded to your customers through the portal as reseller provisioned and imported into your
system. Doing this will remove the domain from being able to be managed by the cus-
tomer through the portal, and will ensure that they will do so from your system.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not utilized on enom.com as it is intended for partner integration
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l A search term must be passed in.
l At least one item to update must be passed in.
Input parameters
Build the query string using this syntax:
- 917 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Note: This process is not reversible. Once a domain is marked as provisioned, it
will be removed from the portal and the end user will no longer be able to manage
the domain through the portal in any capacity.
Example
The following query updates 3 domains as "reseller provisioned" and sends the
response in XML format:
- 918 -
API Command Categories
Query
http://resellertest.enom.com/interface.asp?
command=Portal_UpdateAwardedDomains&UID=resellid
&PW=resellpw&domainlist=123456,7890123,4567890
&ResponseType=XML
In the response, the presence of Success with a value of True AND the ErrCount value 0
indicate that the query was successful:
Output
<interface-response>
<Success>True</Success>
<Command>Portal_UpdateAwardedDomains</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.750</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>9efbb8e7-1cc3-4f2b-bbc2-cbe2517522aa</Track-
ingKey>
<RequestDateTime>5/30/2014 2:51:56 PM</RequestDateTime>
</interface-response>
Related commands
l PORTAL_GETTOKEN
l PORTAL_GETAWARDEDDOMAINS
- 919 -
API Command Categories
PP_CancelSubscription
Description
Definition
This command flags a TRUSTe Privacy Policy subscription for deletion at the end of the
current billing period.
Usage
Use this command to flag a TRUSTe Privacy Policy subscription for deletion at the end
of the current billing period. The subscription will remain active until the next billing date.
If a customer wants to remove the TRUSTe Seal from their Web site before that date,
they can do so by removing the TRUSTe code snippet from their Web site source code.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
Click the domain name associated with the subscription you want to cancel. Click
Cancel Service. The Cancel Service Service button calls the PP_CancelSubscription
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 920 -
API Command Categories
- 921 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query flags a TRUSTe Privacy Policy subscription for cancelation, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_CancelSubscription&uid=resellid&pw=resellpw
&SubscriptionID=20&ReasonID=1&Comment=Not+needed
&responsetype=xml
In the response, a Success value true indicates that the query was successful:
Output
- 922 -
API Command Categories
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.250 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 9b15959c-52e3-4161-a708-782043c69f3e ]]>
</TrackingKey>
</interface-response>
Related commands
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
- 923 -
API Command Categories
PP_CheckUpgrade
Description
Definition
Use this command to trigger display of a dialog box that confirms that the end user
intends to substitute a Privacy Policy with Seal for an existing Privacy Policy
subscription.
Usage
This is a command that you can implement to support a warning or confirmation dialog
box in your UI, to confirm that a customer intends to consolidate a configured TRUSTe
Privacy Policy subscription with an unconfigured Privacy Policy with Seal subscription.
Most commonly, its used as a precursor to the PP_UpdateSubscriptionDetails com-
mand,
to confirm the users intent to merge an existing Privacy Policy subscription with a new
Privacy Policy with Seal subscription.
This API command is optional support for your UI. Regardless of whether you implement
this command, TRUSTe subscriptions that meet the configuration criteria (the customer
specifies the same domain name for a new Privacy Policy with Seal that is already
assigned to an existing Privacy Policy) will be consolidatedin effect, deleting the
Privacy Policy subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
- Click a Privacy Policy subscription that is identified by its associated domain name.
- Make a note of the domain name associated with this subscription.
- Click the browser Back button to return to the Privacy Policy list.
- 924 -
API Command Categories
- Click a Privacy Policy with Seal that is still labeled Awaiting Configuration.
- Fill in the domain name that you have noted for the Privacy Policy subscription, specify
an email address, and click Submit. In our implementation, the Submit button calls the
PP_CheckUpgrade command, and if the response includes IsUpgrade=true, a dialog
box inquires whether the user intends to consolidate two subscriptions. If the user clicks
OK in the dialog box, we call the PP_UpdateSubscriptionDetails command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 925 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests a check of whether a TRUSTe Privacy Policy subscription
qualifies as an upgrade, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_CheckUpgrade&uid=resellid&pw=resellpw
&SubscriptionID=22&DomainName=MyVeryOwnDomain.com
&EmailAddress=john.doe@resellerdocs.com&ResponseType=XML
- 926 -
API Command Categories
- 927 -
API Command Categories
<TrackingKey>
<![CDATA[ 7db66e5a-0f35-4fff-bc9a-f8ab9bf1bc56 ]]>
</TrackingKey>
</interface-response>
Related commands
l PP_CancelSubscription
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_GetCancelReasons
Description
Definition
This command retrieves a list of reasons for cancelling a subscription to TRUSTe Pri-
vacy Policy or TRUSTe Privacy Policy with Seal.
Usage
Use this command to retrieve a list of reasons for cancelling a subscription to TRUSTe
Privacy Policy or TRUSTe Privacy Policy with Seal.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
- 928 -
API Command Categories
In the Domain column, click a domain name or the Awaiting Configuration link. Click
Cancel Service. The Select Reason dropdown menu is populated by the PP_
GetCancelReasons API command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Done True indicates this entire response has reached you suc-
- 929 -
API Command Categories
Parameter Description
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of reasons for cancelling a Privacy Policy sub-
scription, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=pp_getcancelreasons&uid=resellid&pw=resellpw
&responsetype=xml
In the response, a list of cancellation reasons indicates that the query was successful:
Output
- 930 -
API Command Categories
</Command>
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
<![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.219 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ ffbee395-a3ae-4f31-ba8e-e5265be90bbe ]]>
</TrackingKey>
</interface-response>
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetControlPanelLoginURL
- 931 -
API Command Categories
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_GetControlPanelLoginURL
Description
Definition
Retrieve a URL to the TRUSTe control panel, including a 5-minute login token.
Usage
Use this command to provide a link to the TRUSTe control panel, logged in for the sub-
scription specified in the query string. The return URL includes a 5-minute login token.
For a more long-lived means of logging in, you can direct end users to trustem-
anager.com, where they can log in with their domain name and the password they chose
when configuring their TRUSTe subscription.
The TRUSTe control panel allows your customer to create a privacy policy, allows your
customer to notify TRUSTe that their Web site is ready for the certification scan for the
TRUSTe Seal, and displays code snippets for their privacy policy and Seal.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
All subscriptions also use this command to log into the TRUSTe control panel so that a
customer can build or edit their privacy policy. Click a domain name. The Login to my
control panel button uses the PP_GetControlPanelLoginURL command to log the user
into the TRUSTe control panel, to configure the Privacy Policy associated with the
domain name they clicked.
When a customer subscribes to Privacy Policy with Seal and configures subscription
details, our subscription list shows a Setup Required link until the customer configures
- 932 -
API Command Categories
their privacy policy and generates it for review. This link also calls the PP_GetCon-
trolPanelLoginURL command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 933 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a login URL for the TRUSTe control panel for one Privacy
Policy subscription, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_GetControlPanelLoginURL&uid=resellid&pw=resellpw
&DomainName=resellerdocs.com&responsetype=xml
In the response, the presence of a login URL, and an ErrCount value 0, indicate that the
query was successful:
Output
- 934 -
API Command Categories
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
<![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 1.172 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 9f4193ea-54d8-4163-8a57-3ec33c9fcc45 ]]>
</TrackingKey>
</interface-response>
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetStatuses
- 935 -
API Command Categories
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_GetStatuses
Description
Definition
This command retrieves a list of subscription statuses for TRUSTe Privacy Policy.
Usage
Use this command to retrieve a list of our subscription statuses for TRUSTe Privacy
Policy.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
The PP_GetStatuses command populates the Filter By dropdown menu.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
- 936 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of Privacy Policy subscription statuses, and sends
the response in XML format:
Query
- 937 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=pp_getstatuses&uid=resellid&pw=resellpw
&responsetype=xml
In the response, a list of statuses indicates that the query was successful:
Output
- 938 -
API Command Categories
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_GetSubscriptionDetails
Description
Definition
Retrieve details for one TRUSTe Privacy Policy subscription.
Usage
Use this command to retrieve details for one TRUSTe Privacy Policy subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 939 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 940 -
API Command Categories
Parameter Description
subscription
- 941 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves details about a TRUSTe Privacy Policy subscription, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_GetSubscriptionDetails&uid=resellid&pw=resellpw
&SubscriptionID=20&responsetype=xml
In the response, subscription details and an ErrCount value 0 indicate that the query was
successful:
Output
- 942 -
API Command Categories
<StatusId>2</StatusId>
<PPSubscriptionId>20</PPSubscriptionId>
<Type>TRUSTe Privacy Policy + Seal</Type>
<Renew>true</Renew>
<HasPassword>false</HasPassword>
<PolicyStatus>New</PolicyStatus>
</PrivacyPolicySubscriptionDetails>
<Command>
<![CDATA[ PP_GETSUBSCRIPTIONDETAILS ]]>
</Command>
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
<![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.141 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
- 943 -
API Command Categories
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_GetSubscriptions
Description
Definition
Retrieve a list of the Privacy Policy subscriptions in this account.
Usage
Use this command to retrieve a list of the Privacy Policy subscriptions in this account,
along with configuration and status information for each subscription. This command
allows you to sort and filter the results.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
The PP_GetSubscriptions command populates the list on this page. It also sorts and fil-
ters the list based on the filter selected in the Filter by dropdown menu, and sort order
selected by clicking the column headers.
- 944 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 945 -
API Command Categories
Identification number for this Privacy Policys current status: 1 Awaiting Configuration
StatusID
5 Billing Failed 4 Pending Renewal 2 Service Active 6 Service Disabled
Identification number for this Privacy Policy subscription Type of Privacy Policy sub-
scription:
PPSubscriptionID
TRUSTe Privacy Policy
TRUSTe Privacy Policy with Seal
- 946 -
API Command Categories
Customer has accessed their code snippets on the TRUSTe control panel. Customer
Verified_Viewed
can return to control panel as often as needed to retrieve code snippets.
Total number of Privacy Policy subscriptions in this account that satisfy the filtering
TotalCount
criterion in the query string
The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) val-
ErrCount
ues.
Error messages explaining the failure. These can be presented as is back to the cli-
ErrX
ent.
Done True indicates this entire response has reached you successfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query string retrieves a list of Privacy Policy subscriptions in this account,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=pp_getsubscriptions&uid=resellid
&pw=resellpw&responsetype=xml
- 947 -
API Command Categories
In the response, the presence of a TotalCount value, and an ErrCount value 0, indicate
that the query was successful:
Output
<interface-response>
<Subscriptions>
<Subscription>
<PublisherID>208</PublisherID>
<SubscriptionID>2787</SubscriptionID>
<Email>EndUserEmailAddress@example.com</Email>
<DomainName>news.yahoo.com</DomainName>
<SubscriptionName>FriendlyName21</SubscriptionName>
<Status>Service Active</Status>
<NextBillingDate>07/22/2009</NextBillingDate>
</Subscription>
<Subscription>
<PublisherID>208</PublisherID>
<SubscriptionID>2757</SubscriptionID>
<Email>EndUserEmailAddress@example.com</Email>
<DomainName>example.com</DomainName>
<SubscriptionName>FriendlyName3</SubscriptionName>
<Status>Service Active</Status>
<NextBillingDate>07/19/2009</NextBillingDate>
</Subscription>
.
.
.
<TotalCount>133</TotalCount>
</Subscriptions>
<Command>RC_GETSUBSCRIPTIONS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.234</ExecTime>
<Done>true</Done>
- 948 -
API Command Categories
<debug/>
<TrackingKey>43389105-0bba-4fb2-9486-17b5cfc0322a</Track-
ingKey>
<RequestDateTime>12/13/2011 12:54:55 AM</RequestDateTime>
</interface-response>
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_ReactivateSubscription
Description
Definition
Remove the cancellation flag from a TRUSTe Privacy Policy subscription that has been
flagged for cancellation.
Usage
Use this command to remove the cancellation flag from a TRUSTe Privacy Policy sub-
scription that has been flagged for cancellation.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
- 949 -
API Command Categories
In the row of a subscription in status Cancellation Pending, the Reactivate Now link calls
the
PP_ReactivateSubscription command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
ErrCount The number of errors if any occurred. If greater than 0 check the
- 950 -
API Command Categories
Parameter Description
Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query removes the cancellation flag from a TRUSTe Privacy Policy sub-
scription, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_ReactivateSubscription&uid=resellid&pw=resellpw
&SubscriptionID=20&responsetype=xml
In the response, a Success value true indicates that the query was successful:
Output
- 951 -
API Command Categories
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
- 952 -
API Command Categories
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_UpdateSubscriptionDetails
l PP_ValidatePassword
PP_UpdateSubscriptionDetails
Description
Definition
Configure or update subscription details for TRUSTe Privacy Policy subscription.
Usage
Use this command to configure or update the subscription details for a TRUSTe Privacy
Policy subscription:
Associate a domain name with the subscription (note that once a domain name has
been configured, it cannot be changed).
Configure or update the email address that will appear in your privacy policy.
Configure or update the password that the end customer uses to log into trustem-
anager.com (our portal which redirects them to the TRUSTe Privacy Policy control
panel).
Availability
This command is available only to ETP resellers
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-privacy/manage.aspx
Click a TRUSTe Privacy Policy subscription that is in status Awaiting Configuration. On
the configuration page, the Submit button calls the PP_UpdateSubscriptionDetails com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
- 953 -
API Command Categories
Input parameters
- 954 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query configures subscription details for a TRUSTe Privacy Policy sub-
scription, and returns the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PP_UpdateSubscriptionDetails&uid=resellid
&pw=resellpw&SubscriptionID=40&DomainName=Example.com
&EmailAddress=John.Doe@resellerdocs.com&ResponseType=XML
In the response, a Success value true indicates that the query was successful:
Output
- 955 -
API Command Categories
- 956 -
API Command Categories
</interface-response>
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_ValidatePassword
PP_ValidatePassword
Description
Definition
Use this command to validate the password for a TRUSTe Privacy Policy subscription,
when a user logs into the TRUSTe control panel through a page you build.
Usage
Use this command when you want to build your own login portal for the TRUSTe control
panel.
This command supports one of the three means we have created to give your customers
access to the TRUSTe control panel:
l Auto-login: The PP_GetControlPanelLoginURL command retrieves an auto-login
URL with 5-minute token. This URL opens TRUSTes control panel.
l White-labeled portal: We provide trustemanager.com, a white-labeled portal that
allows your customer to log into TRUSTes control panel using their domain name
and password.
l Your own portal: You can build a page that accepts the domain name and pass-
- 957 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The TRUSTe Privacy Policy subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 958 -
API Command Categories
Parameter Description
subscription in this account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following submits a domain name associated with a TRUSTe subscription, and a
password, and inquires whether the pair are valid for logging into trustemanager.com (or
the portal you have built to use in place of trustemanager.com):
Query
https://resellertest.enom.com/interface.asp?
command=PP_ValidatePassword&uid=resellid&pw=resellpw
&DomainName=resellerdocs.com&SubscriptionPassword=tester
&ResponseType=XML
- 959 -
API Command Categories
<interface-response>
<Success>
<![CDATA[ True ]]>
</Success>
<Command>
<![CDATA[ PP_VALIDATEPASSWORD ]]>
</Command>
<Language>
<![CDATA[ eng ]]>
</Language>
<ErrCount>
<![CDATA[ 0 ]]>
</ErrCount>
<ResponseCount>
<![CDATA[ 0 ]]>
</ResponseCount>
<MinPeriod />
<MaxPeriod>
<![CDATA[ 10 ]]>
</MaxPeriod>
<Server>
<![CDATA[ sjl21wresell01 ]]>
</Server>
<Site>
<![CDATA[ enom ]]>
</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>
<![CDATA[ +0.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.094 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ ad261088-6b11-4ea6-83c2-6d3cc4d616fe ]]>
</TrackingKey>
</interface-response>
- 960 -
API Command Categories
Related commands
l PP_CancelSubscription
l PP_CheckUpgrade
l PP_GetCancelReasons
l PP_GetControlPanelLoginURL
l PP_GetStatuses
l PP_GetSubscriptionDetails
l PP_GetSubscriptions
l PP_ReactivateSubscription
l PP_UpdateSubscriptionDetails
Preconfigure
Description
Definition
Configure the extended attributes for the Active domains in a shopping cart. Most
commonly, extended attributes are added for certain country codes, including .us,
.ca, .co.uk, and .org.uk.
Usage
Use this command when registering domains that require extended attributes (inform-
ation required by some registries for some TLDs). To retrieve extended attributes, use
the GetExtAttributes command.
This command operates only if you use our shopping cart, and only on the domains in
the cart that have status Active. If you use the Purchase command instead of our shop-
ping cart, supply the extended attributes in the Purchase command.
Optionally, you can also use this command to configure many universal attributes for
domains in your shopping cart that are in status Active. Preconfigurable attributes
include the Auto Renew setting, Registrar-Lock setting, IDN codes, name servers, host
records, access passwords, and contacts.
Many of the universal attributes that this command can set in a cart can also be set for all
future registrations by using the UpdateCusPreferences command.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 961 -
API Command Categories
Constraints
The query must meet the following requirements:
l This command operates only if you use our shopping cart, and only on the
domains in the cart that have status Active.
l The login ID and password must be valid.
l There must be at least one configurable domain in the cart.
l The extended attributes (configuration parameters) you provide in the query must
match those required for the current TLD. For example, configuring a .us name
requires that you provide the attributes for .us, not those for .ca.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 962 -
API Command Categories
Max
Parameter Status Description
Size
tAttributes return supplies parameter names
tagged as <Name> and permitted values tagged
as <Value>
Required for
PUNY
International Domain Name code for each lan-
encoded
guage used by a domain in the cart that has
names that use
IDNX X = 1 to Num- status Active. To retrieve the Active domains in
characters 3
berOfLanguages the cart, use command GetCartContent . For a
other than the
list of IDN codes, go to http://www.enom.-
English alpha-
com/resellers/newdocumentation.asp
bet, numbers,
and hyphen
Required if you
want to use Names of the name servers a domain is using.
NSX X=1 . . . 12 2
name servers Maximum of 12 name servers.
other than ours
- 963 -
API Command Categories
Max
Parameter Status Description
Size
MX Mail. Can be a host name under this domain
name or the name of a mail server
MXE Mail Easy (email forwarding)
TXT Text (SPF) record
Either
ExpressCheck- If ExpressCheckout=1, the accounts default
out or all four contacts will be applied. If ExpressCheckout=0
ExpressCheckout 1
Opt* para- or is not used, supply contact information using
meters are the Opt* and ContactType* parameters below.
Required
- 964 -
API Command Categories
Max
Parameter Status Description
Size
trant contact as the Registrant contact for this
meters are domain
Required UseExisting Use the Registrant contact inform-
ation supplied in this query string
- 965 -
API Command Categories
Max
Parameter Status Description
Size
ContactTypeState Optional Contacts state 60
Optional for
most TLDs;
ContactTypeZip Contacts postal code 16
Required for
.org
- 966 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l A fully qualified domain name is expressed in the format hostname.SLD.TLD..
Note that the trailing period is an essential component of a fully qualified domain
name.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query supplies the extended attributes for resellerdocs.us and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=preconfigure&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=us&Load=2&us_nexus=c11
&us_purpose=p3&PreConfigDNS=default
&ExpressCheckout=1&responsetype=xml
- 967 -
API Command Categories
Related commands
l AddContact
l Contacts
l GetContacts
- 968 -
API Command Categories
l GetExtAttributes
l GetWhoisContact
Purchase
Description
Definition
Purchase a domain name or Premium Domain in real time, or put in a real time order into
the pre-registration queue for an EAP domain.
Usage
The Purchase command enables direct real-time purchase of a domain name or
Premium Domain. The Purchase command bypasses the shopping cart and the queuing
delay associated with it.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
The Purchase command is typically used for a single-name purchase and returns an
immediate success/failure response.
Most commonly, the Purchase command is used by resellers who maintain their own
databases.
Usage notes for .eu and .be
When you register a .eu or .be domain name, we recommend that you always provide
Registrant contact information that is separate from Billing contact information; dont use
the same as Billing default.
Tip: If the Billing and Registrant contact information are the same, we recommend chan-
ging the use or spelling of abbreviations in the street address to help our system recog-
nize that it needs to create multiple contacts. Separating the Registrant and Billing
information makes it easier to update Registrant contact information in the future.
Usage notes for Premium Domains
Because of the high prices for some Premium Domains, we offer you a wider variety of
payment methods than for most purchases:
l You can pay immediately using your account balance or credit card, just as you do
for non-premium domains (but note that we place a maximum on credit card trans-
actions).
- 969 -
API Command Categories
l For Premium Domains, you can also pay by wire transfer, or you can pay later
using your account balance. Use the UseWireTransfer parameter in the Purchase
command to defer payment. When youre ready to pay, either wire your payment,
or use the NM_ProcessOrder command to pay with your account balance. Just be
aware that we will not release the Premium Domain to your account until we
receive payment.
Availability
All resellers can sell domain names that are available at the Registry, but only our
direct ETP resellers can sell Premium Domains.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/cart/purchase.aspx?
The Purchase command is not implemented on www.enom.com. However, on the
Review
Your Order page, the Submit Order button calls InsertNewOrder , a similar command
that initiates order creation. The difference is that InsertNewOrder acquires contents of
the shopping cart and puts them in a queue for checkout; the Purchase command
bypasses the shopping cart and the queue and submits an order in real time.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be a reseller account directly under
eNom, and must have
l signed a credit card agreement with us.
l The domain name(s) to be purchased must be valid. (See requirements under the
Check command.)
l eNom must be licensed to sell the names you attempt to register (eNom is not
licensed with the
l Registries for all TLDs).
l Name servers for .us names must be located in the United States.
l .co.uk and .org.uk names must have at least two name servers.
- 970 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
Optional. Required for Specify which EAP day you are intending
EapDay purchasing an EAP to purchase. Supported values are between 1
domain 1 and 7.
- 971 -
API Command Categories
Max
Parameter Status Description
Size
Specify UseDNS=default to use our name
Either UseDNS or servers (most of the services that we
UseDNS 7
NSX is Required provide require our name servers). See
Note.
- 972 -
API Command Categories
Max
Parameter Status Description
Size
must be done after the order completes.
- 973 -
API Command Categories
Max
Parameter Status Description
Size
End users IP address. This is used in fraud
Required if using our checking, as part of our order processing
EndUserIP 15
credit card processing service. Use format
NNN.NNN.NNN.NNN.
- 974 -
API Command Categories
Max
Parameter Status Description
Size
attributes are required
OR if you supply one
of the other core Regis-
trant attributes (see
Note)
Required if extended
attributes are required
OR if you supply one
RegistrantLastName Registrant last name 60
of the other core Regis-
trant attributes (see
Note)
Regis-
Optional Registrant organization 60
trantOrganizationName
Required if param
Regis-
RegistrantJobTitle trantOr- Registrant job title 60
ganizationName is
used
Required if extended
attributes are required
OR if you supply one
RegistrantAddress1 Registrant Address 60
of the other core Regis-
trant attributes (see
Note)
Required if extended
attributes are required
OR if you supply one
RegistrantCity Registrant city 60
of the other core Regis-
trant attributes (see
Note)
Required if extended
attributes are required
OR if you supply one
RegistrantStateProvince Registrant state or province 60
of the other core Regis-
trant attributes (see
Note)
- 975 -
API Command Categories
Max
Parameter Status Description
Size
names or when you
supply one of the other
core Registrant attrib-
utes
Required if extended
attributes are required
OR if you supply one Registrant country. The twocharacter coun-
RegistrantCountry 60
of the other core Regis- try code is a permitted format
trant attributes (see
Note)
Required if extended
attributes are required
OR if you supply one
RegistrantEmailAddress Registrant email address 128
of the other core Regis-
trant attributes (see
Note)
Required if extended
Registrant phone. Required format is
attributes are required
+CountryCode.PhoneNumber, where Coun-
OR if you supply one
RegistrantPhone tryCode and PhoneNumber use only 20
of the other core Regis-
numeric characters and the + is URLen-
trant attributes (see
coded as a plus sign (%2B).
Note)
- 976 -
API Command Categories
Max
Parameter Status Description
Size
ganizationName
ContactTypeStateProvinc-
Optional ContactType state or province 60
e
- 977 -
API Command Categories
Max
Parameter Status Description
Size
ContactType (see numeric characters and the + is URLen-
Note) coded as a plus sign (%2B).
ContactTypeContact Returned if new contacts were created with this query string
Create date of this domain when response code is 200 and pro-
RegistryCreateDate
cessing is in real time.
- 978 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l If using our credit card option ALL registrant and credit card information is required.
l For most TLDs (those that dont require extended attributes), Registrant contact
information is optional: if not supplied, it is inherited from the Billing contact.
However, if you supply any one of the core Registrant values, you must supply
them all. The core Registrant values are:
l RegistrantFirstName
l RegistrantLastName
l RegistrantAddress1
l RegistrantCity
l RegistrantCountry
l RegistrantEmailAddress
l RegistrantPhone
- 979 -
API Command Categories
Example
The following query requests the purchase of domain name resellerdocs2.net, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=Purchase&uid=resellid&pw=resellpw
&sld=resellerdocs2&tld=net
&RegistrantOrganizationName=Reseller%20Documents%20Inc.
&RegistrantFirstName=john&RegistrantLastName=doe
&RegistrantAddress1=111%20Main%20St.
&RegistrantCity=Hometown&RegistrantStateProvince=WA
&RegistrantStateProvinceChoice=S&RegistrantPostalCode=98003
&RegistrantCountry=United+States
&RegistrantEmailAddress=john%2Edoe%40resellerdocs%2Ecom
&RegistrantPhone=%2B1.5555555555
&RegistrantFax=%2B1.5555555556&ResponseType=XML
The response includes the three components that indicate a successful transaction: an
order ID indicates success at the registrar level, and the RRPCode value of 200 and
RRP text with a success message indicate success at the Registry level:
Output
<interface-response>
<OrderID>157781021</OrderID>
<TotalCharged>8.95</TotalCharged>
<RegistrantPartyID>{1C3E82CA-FE3F-E011-B28A-005056BC7747}
</RegistrantPartyID>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully -
157781021</RRPText>
<Command>PURCHASE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
- 980 -
API Command Categories
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>4.907</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 3:58:42 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddBulkDomains
l Check
l PurchaseServices
PurchaseHosting
Description
Definition
Subscribe to our domain name hosting services, while leaving the registration of the
domain name at another registrar. This is a real-time command.
Usage
Use this command to purchase domain name hosting services in real time, while leaving
the registration of a domain name at another registrar.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
To purchase DNS hosting using the shopping art and order queue, use the AddToCart
command.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not imThis command is not implemented on eNom.com, but is the real-
time analog to two commands that are. On our site, we use AddToCart to allow a cus-
- 981 -
API Command Categories
tomer to specify that they want to purchase DNS Hosting, and InsertNewOrder to submit
the order.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be an ETP reseller account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Optional overall, but Permitted values are yes and no. The
Required for credit card supplied in this query string
resellers who have is charged only if UseCreditCard=yes.
a credit card pro- If this param is omitted, or if the value
UseCreditCard cessing agreement supplied is anything other than yes, the 3
with us AND want account balance rather than the credit
to use our CC pro- card is debited for this transaction. This
cessing to charge is true even if the query string includes
- 982 -
API Command Categories
Required if
Type of credit card. Permitted values
CardType UseCreditCard=yes 20
are Visa, Mastercard, AmEx, Discover
Required if
CreditCardNumber UseCreditCard=yes Customer's credit card number 128
Required if
CreditCardExpMonth UseCreditCard=yes Credit card expiration month 2
Required if
CreditCardExpYear UseCreditCard=yes Credit card expiration year 4
Required if
CVV2 UseCreditCard=yes Credit card verification code 4
- 983 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Additional params for contact information can be passed by replacing Registrant in
the param names above with Tech, Admin or AuxBilling.
l If using our credit card option ALL registrant and credit card information is required.
- 984 -
API Command Categories
Example
The following query orders and pays for one year of DNS hosting for the site reseller-
docs.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=purchasehosting&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&numyears=1
&RegistrantAddress1=111+Main+St.+&RegistrantCity=Hometown
&RegistrantCountry=USA
&RegistrantEmailAddress=test@here.net
&RegistrantFirstName=John&RegistrantLastName=Doe
&RegistrantPhone=+1.5555555555
&RegistrantPostalCode=99999&Renewname=1
&UseCreditCard=yes&EndUserIP=127.0.0.1
&CreditCardNumber=4111111111111111
&CreditCardExpMonth=05&CreditCardExpYear=2005
&CCName=John+Doe&CardType=visa
&ChargeAmount=12&responsetype=xml
Output
<interface-response>
<OrderID>157781022</OrderID>
<Command>PURCHASEHOSTING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>2.125</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>672bb050-769a-4562-82a8-d1b6dae96077</Track-
ingKey>
<RequestDateTime>12/9/2011 4:01:09 AM</RequestDateTime>
- 985 -
API Command Categories
</interface-response>
Related commands
l ExtendDomainDNS
l DeleteHostedDomain
l GetHosts
l SetHosts
PurchasePOPBundle
Description
Definition
Purchase, in real time, a pak of 10 POP Email accounts for the specified domain name.
Usage
Use this command to purchase, in real time, a pak of 10 POP Email accounts for the spe-
cified domain name.
We recommend the POP3 mail service for parties who want to be able to send mail from
their domain name (instead of, for example, a yahoo or hotmail senders address), and
for parties who want to manage multiple email accounts as a body (rather than having
everyones email forwarded to scattered locations).
After you sell a POP Email bundle, you can set up users with the SetUpPOP3User com-
mand.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameID=152533676
On the POP3 Mail page, the add an Email Pak button calls the PurchasePOPBundle
command.
- 986 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be an ETP reseller account.
l The domain name must belong to this account.
l This command can be used only for purchasing POP paks for reseller accounts.
Retail accounts must
l use a queue-based shopping cart process.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 987 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests 1 pak of 10 POP3 mailboxes for resellerdocs.com, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PurchasePOPBundle&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&Quantity=1&responsetype=xml
In the response, the return of an orderid value and a bundleid value confirm a successful
query:
Output
<interface-response>
<orderid>157781024</orderid>
<Bundles>
<BundleID>30823</BundleID>
</Bundles>
- 988 -
API Command Categories
<BundleCount>1</BundleCount>
<Command>PURCHASEPOPBUNDLE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>1.265</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 4:02:14 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetDotNameForwarding
l GetForwarding
l GetMailHosts
l GetPOP3
l GetPOPExpirations
l GetPOPForwarding
l ModifyPOP3
l PurchaseHosting
l PurchaseServices
l RenewPOPBundle
l SetDotNameForwarding
l SetPOPForwarding
l SetUpPOP3User
- 989 -
API Command Categories
PurchasePreview
Description
Definition
Preview a shopping cart order.
Usage
Use this command to view the items that will be purchased if you check out now.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/Cart.asp
On the cart page, the checkout button calls the PurchasePreview command. It creates
the list of items on the checkout page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 990 -
API Command Categories
StatusID Status ID
- 991 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following requests a preview of account resellid and an inventory of its shopping
cart, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=purchasepreview&uid=resellid
&pw=resellpw&responsetype=xml
The response gives some general information about the account, plus the current con-
tents of the shopping cart:
Output
<interface-response>
<Purchase-Summary>
<PremDomainSalesAmount/>
<Reseller>True</Reseller>
<Balance>2454.8</Balance>
<AvailableBalance>2083.85</AvailableBalance>
<DomainCount>0</DomainCount>
<DotComPrice>8.95</DotComPrice>
<DotNetPrice>8.95</DotNetPrice>
<DotOrgPrice>8.95</DotOrgPrice>
<DotCcPrice>24.95</DotCcPrice>
<DotTvPrice>39.95</DotTvPrice>
<TotalPrice>0.00</TotalPrice>
<TotalDiscount>0</TotalDiscount>
</Purchase-Summary>
<Command>PURCHASEPREVIEW</Command>
<Language>eng</Language>
- 992 -
API Command Categories
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.984</ExecTime>
<Done>true</Done>
<RequestDateTime>12/9/2011 4:03:28 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddBulkDomains
l AddToCart
l DeleteFromCart
l GetCartContent
l InsertNewOrder
l UpdateCart
PurchaseServices
Description
Definition
Purchase one of our services in real time.
The PurchaseServices command allows you to purchase one service each time you run
the query.
Usage
Use this command to purchase one value-added service in real time, as opposed to
going through a shopping cart and our order queue. Most commonly, real-time com-
mands are used by resellers who maintain their own databases.
Our credit card services are available for ID Protect and DNS hosting.
- 993 -
API Command Categories
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/Checkout.asp
The PurchaseServices command is not implemented on www.enom.com. Its func-
tionality is most similar to the combined functionality of AddToCart and InsertNewOrder.
The difference is that AddToCart and InsertNewOrder can put multiple items into a shop-
ping cart and then put items selected from that cart into a queue for checkout, whereas
the PurchaseServices command purchases a single item in real time.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Some products are available to only some TLDs. For example, ID Protect is not
available for .us.
l To use our credit card processing (available only for ID Protect, Business Listing,
and DNS hosting in the PurchaseServices suite of products), this must be an ETP
reseller account that has signed a credit card agreement with us.
Input parameters
Click a link in the table below to go directly to a specific product:
Input parameters for ID Protect
Input parameters for SSL Certificates
Input parameters for TRUSTe Privacy Policy
Input parameters for VeriSign Trust Seal
Input parameters for GeoTrust Anti-Malware
Input parameters for SiteLock
Input parameters for RichContent
- 994 -
API Command Categories
Required for
TLD Top-level domain name (extension). 15
WPPS
Optional for
Number of years to subscribe to ID Pro-
NumYears WPPS; default is 1 2
tect
- 995 -
API Command Categories
- 996 -
API Command Categories
- 997 -
API Command Categories
Certificate-VeriSign-Secure-Site-EV
Certificate-VeriSign-Secure-Site-Pro-EV
Certificate-Comodo-UCC-DV
Certificate-Comodo-UCC-OV
ResponseType Optional in all Format of response. Permitted values are Text (default), HTML,
4
cases or XML.
- 998 -
API Command Categories
- 999 -
API Command Categories
- 1000 -
API Command Categories
- 1001 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1002 -
API Command Categories
- 1003 -
API Command Categories
Required for
TLD Top-level domain name (extension). 15
BusListing
Optional for
Number of years to subscribe to ID Pro-
NumYears BusListing; default 2
tect. Permitted values are 1 to 10.
is 1
- 1004 -
API Command Categories
- 1005 -
API Command Categories
- 1006 -
API Command Categories
Required for
Top-level domain name (extension). For
LWSCBasic,
TLD LWSC*, this is the domain WSC will be 15
LWSCFull, and
associated with.
LWSCECom
- 1007 -
API Command Categories
- 1008 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Required for
TLD Top-level domain name (extension). 15
DNSHosting
Optional for
DomainPassword Set a password on the domain name 60
DNSHosting
Optional for
RenewName Set to 1 to auto-renew the name 1
DNSHosting
ChargeAmount Required for our Amount to charge for each year of DNS 6
- 1009 -
API Command Categories
- 1010 -
API Command Categories
- 1011 -
API Command Categories
Parameter Description
Our identification number for the Domain Name associated
SubscriptionID with this GoMobi purchase; included for Service=GoMobi and
GoMobiFreeTrial
Our identification number for this POP pak; included for Ser-
BundleID
vice=POP3
Cert ID for the cert purchased in this order; included for any
CertID
cert purchase
Notes
l A fully qualified domain name is expressed in the format hostname.SLD.TLD..
Note that the period at the
l end is an essential component of a fully qualified domain name.
- 1012 -
API Command Categories
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds three POP mail paks to domain resellerdocs.com and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=PURCHASESERVICES&uid=resellid&pw=resellpw
&Service=POP3&sld=resellerdocs&tld=com
&Quantity=3&responsetype=xml
In the response, the presence of an OrderID and the ErrCount value 0 confirm that the
query was successful:
Output
- 1013 -
API Command Categories
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.5429688</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l Forwarding
l GetHomeDomainList
l Purchase
l PurchaseHosting
l PurchasePOPBundle
l RenewServices
l SetHosts
PushDomain
Description
Definition
Push a domain name into another account.
Usage
Use this command to transfer a domain name from one eNom account to another.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Push.asp?DomainNameID=152533676
On the push a domain page, the submit button calls the PushDomain command.
- 1014 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The account to which the domain name is being pushed must be under eNom or
one of its resellers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1015 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that the domain name resellerdocs2.net be pushed from
account resellid to account ichiro, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=pushdomain&uid=resellid&pw=resellpw
&sld=resellerdocs2&tld=net&accountid=ichiro
&responsetype=xml
- 1016 -
API Command Categories
<interface-response>
<Push>
<domainname sld="resellerdocs2" tld="net" id="152533887">
resellerdocs2.net
</domainname>
<PushDomain>1</PushDomain>
</Push>
<Command>PUSHDOMAIN</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
Queue_DomainPurchase
Description
Definition
Purchase a domain in a specified queue. Note, these orders will be processed once the
queue closes.
Usage
- 1017 -
API Command Categories
Use this command to purchase a domain in a specified queue. Note, these orders will be
processed once the queue closes.
Premium Domain
A unique, memorable or noteworthy name might be considered as a premium domain.
This type of domain will be more expensive depending on the name and TLD. If Queue_
DomainPurchase returns error:
"CustomerSuppliedPrice is required for mydomain.bike"
this domain is considered as the premium domain. The exact price for this domain must
be declared in the parameter module as CustomerSuppliedPrice. Use the PE_GetPremi-
umPricing command to retrieve the price.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tld-queue/pages/manage/purchase.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 1018 -
API Command Categories
Max
Parameter Status Description
Size
Collection of domain orders, grouped in domain module(s).
Each parameters for a domain are separated by pipe sym-
bol or "|". Multiple domain entry is allowed by adding comma
or "," between each domain module. Use the PE_GetPremi-
umPricing command to retrieve the premium domain price
for CustomerSuppliedPrice. Domain module format:
QName= [phase] | SLD= [sld] | TLD= [tld] | ExtAttributes |
Signed_Mark_Data | CustomerSuppliedPrice Example:
ItemList Required ItemList- ?
t=QName=Sunrise|SLD=IWantToBeA|TLD=ninja|ninja_
name=Super+Samurai|ninja_number=007|signed_mark_
data=Shogun, QName-
e=Sunrise|SLD=Training|TLD=ninja|ninja_name-
e=Jim+Smith|signed_mark_
data=DkOnNp...CustomerSuppliedPrice=65.00 Note:
please use URL Encoding for ListItem or the entire API
string to avoid any unexpected results.
Required if
Amount UseCred- Amount to charge for this order. Format: DDD.CC 8
itCard=Yes
Required if using
CCName our credit card pro- Cardholder's name 60
cessing
Required if using
12-
CCNumber our credit card pro- Customer's credit card number
8
cessing
Required if using
CCExpMonth our credit card pro- Credit card expiration month. Format: MM 2
cessing
Required if using
CCExpYear our credit card pro- Credit card expiration year. Format: YYYY 4
cessing
- 1019 -
API Command Categories
Max
Parameter Status Description
Size
our credit card pro-
cessing
Required if using
CCAddress our credit card pro- Credit card billing address 60
cessing
Required if using
CCCity our credit card pro- Credit card billing city 60
cessing
Required if using
CCStateProvin-
our credit card pro- Credit card billing state or province 60
ce
cessing
Required if using
CCZip our credit card pro- Credit card billing postal code 15
cessing
Required if using
CCCountry our credit card pro- Credit card billing country (2 letter code) Format: XX 60
cessing
- 1020 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query purchases a .NINJA domain name from the corresponding sunrise
queue, and requests the response in XML format.
Query
NON-PREMIUM - without Signed Mark Data
https://resellertest.enom.com/interface.asp?
UID=resellid&PW=resellpw&ResponseType=xml
&Command=Queue_DomainPurchase&ItemList=qname
%3dsunrise%7csld%3dmydomain%7ctld%3dninja
%7csigned_mark_data%3d
https://resellertest.enom.com/interface.asp?
UID=resellid&PW=resellpw&ResponseType=xml
&Command=Queue_DomainPurchase&ItemList=qname%3dsunrise
%7csld%3dbike48N12%7ctld%3dninja%7csigned_mark_data
%3dDQo8......TaW1cmU%2bPC9zbWQ6c2dEFmdGVyPg0KIClnTWFyaz4
%3d%7cCustomerSuppliedPrice%3d365.00
Output
- 1021 -
API Command Categories
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_GetDomains
l Queue_GetOrders
l Queue_GetOrderDetail
l PE_GetPremiumPricing
l GetAgreementPage
- 1022 -
API Command Categories
Queue_GetDomains
Description
Definition
Retrieve a list of domains currently in the specified queue for the account.
Usage
Use this command to retrieve a list of domains currently in the specified queue in the
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tld-queue/pages/manage/preorders.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1023 -
API Command Categories
- 1024 -
API Command Categories
Parameter Description
NewTLDPending Number of orders in Pending status
OrderID Order ID
TLDID TLD ID
Price Price
QID Queue ID
StatusID Status ID
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1025 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of domains currently in the queue, and requests the
response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetDomains&DisplayDomains=true
Output
- 1026 -
API Command Categories
<Price>55.00</Price>
<QID>57</QID>
<QName>Sunrise B</QName>
<StatusID>139</StatusID>
<StatusName>Awaiting Submission</StatusName>
</Domain>
<Domain>
<OrderID>157910451</OrderID>
<DomainName>teacher.ninja</DomainName>
<TLDID />
<TLDName>NINJA</TLDName>
<TLDDesc></TLDDesc>
<DateStart>6/12/2013 2:32 PM</DateStart>
<DateEnd>6/28/2013 2:32 PM</DateEnd>
<Price>55.00</Price>
<QID>57</QID>
<QName>Sunrise B</QName>
<StatusID>139</StatusID>
<StatusName>Awaiting Submission</StatusName>
</Domain>
</Domains>
<ItemCount>120</ItemCount>
<ItemTotal>120</ItemTotal>
</Queue_GetDomains>
<Command>QUEUE_GETDOMAINS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.375</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>6/3/2013 3:55:35 PM</RequestDateTime>
</interface-response>
- 1027 -
API Command Categories
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_DomainPurchase
l Queue_GetOrders
l Queue_GetOrderDetail
l PE_GetPremiumPricing
l GetAgreementPage
Queue_GetExtAttributes
Description
Definition
Retrieve a list of extended attributes for a specific queue.
Usage
Use this command to retrieve a list of extended attributes for a specific queue.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tld-queue/pages/preconfigure.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1028 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1029 -
API Command Categories
Example
The following query retrieves a list of extended attributes for a TLD available in a queue,
and requests the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetExtAttributes&QIDList=53
Output
- 1030 -
API Command Categories
</Attributes>
</Queue>
</Queues>
</Queue_GetExtAttributes>
<Command>QUEUE_GETEXTATTRIBUTES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.156</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>4/30/2013 4:12:07 PM</RequestDateTime>
</interface-response>
Related commands
l Queue_GetInfo
l Queue_DomainPurchase
l Queue_GetDomains
l Queue_GetOrders
l Queue_GetOrderDetail
l PE_GetPremiumPricing
l GetAgreementPage
Queue_GetInfo
Description
Definition
Retrieve a list of all queues, which can be fitered as appropriate.
Usage
- 1031 -
API Command Categories
Use this command to retrieve a list of all queues, which can be fitered as appropriate.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tlds/watchlist.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1032 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1033 -
API Command Categories
Example
The following query retrieves a list of queues for .NINJA, and requests the response in
XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml
&Command=Queue_GetInfo&FilterTLD=Ninja
Output
- 1034 -
API Command Categories
<EndDate>2013-10-28T14:32:21</EndDate>
<AnnouncementDate>2013-02-05T08:00:00</AnnouncementDate>
</Queue>
<TotalRecords>1</TotalRecords>
</Queue_GetInfo><Command>QUEUE_GETINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>4/30/2013 3:43:35 PM</RequestDateTime>
</interface-response>
Related commands
l Queue_GetExtAttributes
l Queue_DomainPurchase
l Queue_GetDomains
l Queue_GetOrders
l Queue_GetOrderDetail
l PE_GetPremiumPricing
l GetAgreementPage
Queue_GetOrderDetail
Description
Definition
Retrieve a detailed queue domain order.
Usage
- 1035 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1036 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1037 -
API Command Categories
Example
The following query retrieve a list of queue domain order history, and requests the
response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=XML
&Command=Queue_GetOrderDetail&OrderID=157896057
Output
- 1038 -
API Command Categories
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>6/5/2013 3:40:56 PM</RequestDateTime>
</interface-response>
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_DomainPurchase
l Queue_GetDomains
l Queue_GetOrders
l PE_GetPremiumPricing
l GetAgreementPage
Queue_GetOrders
Description
Definition
Retrieve a list of queue domain order history.
Usage
Use this command to retrieve a list of queue domain order history.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/reports.aspx
- 1039 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
StatusID Status ID
- 1040 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err (1 to ErrCount) values
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieve a list of queue domain order history, and requests the
response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=XML
&Command=Queue_GetOrders
Output
- 1041 -
API Command Categories
<Success>0</Success>
<Failed>0</Failed>
<Pending>1</Pending>
<OrderDate>4/11/2013 5:11 PM</OrderDate>
</Order>
</Orders>
<ItemCount>1</ItemCount>
<ItemTotal>1</ItemTotal>
</Queue_GetOrders>
<Command>QUEUE_GETORDERS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>3.047</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>6/5/2013 3:27:10 PM</RequestDateTime>
</interface-response>
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_DomainPurchase
l Queue_GetDomains
l Queue_GetOrderDetail
l PE_GetPremiumPricing
l GetAgreementPage
- 1042 -
API Command Categories
RAA_GetInfo
Description
Definition
Get Registrar Accreditation Agreement (RAA) information for a contact change.
Usage
Use this command to get RAA information for a contact change.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/default.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1043 -
API Command Categories
*NOTE: only one (1) RAA parameter is required to be passed in. If more than one of the
RAA parameters are present in the query string, the first value based on the order below
will be processed (other values will be ignored):
l DomainName
l VerificationCode
l FirstName, LastName, EmailAddress
- 1044 -
API Command Categories
Parameter Description
ResultText Result description
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query gets RAA information for a contact change in various types, and
requests the response in XML format.
Query
Passing DomainName
You will only get back what information you passed in and was used for the API Call.
If you send in DomainName you would only get back the domain name in the output,
the other parameters if sent are cleared and not used or returned.
https://resellertest.enom.com/interface.asp?
command=raa_getinfo&uid=resellid&pw=resellpw
&domainname=testingdomain.com&responsetype=xml
Passing VerificationCode
You will only get back what information you passed in and was used for the API Call.
- 1045 -
API Command Categories
If you send in VerificationCode you would only get back the verification code
in the output, the other parameters if sent are cleared and not used or returned.
https://resellertest.enom.com/interface.asp?
command=raa_getinfo&uid=resellid&pw=resellpw
&verificationcode=1558f096-9202-4b21-81d6-9f34d207514d
&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=raa_getinfo&uid=resellid&pw=resellpw
&firstname=Joe&lastname=Tester
&emailaddress=joetester@test.com&responsetype=xml
Output
Passing DomainName
- 1046 -
API Command Categories
<Email>
<To> joetester@test.com</To>
<SendDate>12/3/2013 7:45:00 AM</SendDate>
</Email>
<Email>
<To> joetester@test.com</To>
<SendDate>12/4/2013 12:45:00 PM</SendDate>
</Email>
</EmailsSent>
<Command>RAA_GETINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.031</ExecTime>
<Done>true</Done>
<TrackingKey>9769b21b-5e3f-42fb-88d2-e470f4b4-
fa5f</TrackingKey>
<RequestDateTime>12/4/2013 7:57:44 AM</RequestDateTime>
</interface-response>
Passing VerificationCode
- 1047 -
API Command Categories
<SuspensionDate/>
<ToBeSuspendedDate>12/18/2013 7:35:57 AM</ToBeSus-
pendedDate>
<ResultText/>
<EmailsSent>
<Email>
<To> joetester@test.com</To>
<SendDate>12/3/2013 7:45:00 AM</SendDate>
</Email>
<Email>
<To> joetester@test.com</To>
<SendDate>12/4/2013 12:45:00 PM</SendDate>
</Email>
</EmailsSent>
<Command>RAA_GETINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.031</ExecTime>
<Done>true</Done>
<TrackingKey>9769b21b-5e3f-42fb-88d2-e470f4b4-
fa5f</TrackingKey>
<RequestDateTime>12/4/2013 7:57:44 AM</RequestDateTime>
</interface-response>
- 1048 -
API Command Categories
<EmailAddress>joetester@test.com</EmailAddress>
<IsSuspended>False</IsSuspended>
<IsPendingSuspension>True</IsPendingSuspension>
<SuspensionDate/>
<ToBeSuspendedDate>12/18/2013 7:35:57 AM</ToBeSus-
pendedDate>
<ResultText/>
<EmailsSent>
<Email>
<To> joetester@test.com</To>
<SendDate>12/3/2013 7:45:00 AM</SendDate>
</Email>
<Email>
<To> joetester@test.com</To>
<SendDate>12/4/2013 12:45:00 PM</SendDate>
</Email>
</EmailsSent>
<Command>RAA_GETINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.031</ExecTime>
<Done>true</Done>
<TrackingKey>9769b21b-5e3f-42fb-88d2-e470f4b4-
fa5f</TrackingKey>
<RequestDateTime>12/4/2013 7:57:44 AM</RequestDateTime>
</interface-response>
Related commands
l RAA_GetInfo
l RAA_ResendNotification
l RPT_GetReport
- 1049 -
API Command Categories
RAA_ResendNotifications
Description
Definition
Resend Registrar Accreditation Agreement (RAA) notification email for a contact
change.
Usage
Use this command to resend RAA notification email for a contact change.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/default.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1050 -
API Command Categories
*NOTE: only one (1) RAA parameter is required to be passed in. If more than one of the
RAA parameters are present in the query string, the first value based on the order below
will be processed (other values will be ignored):
l DomainName
l VerificationCode
l FirstName, LastName, EmailAddress
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1051 -
API Command Categories
Example
The following query resends RAA notification email for a contact change in various
types, and requests the response in XML format.
Query
Passing DomainName
https://resellertest.enom.com/interface.asp?
command=raa_resendnotification&uid=resellid&pw=resellpw
&domainname=testdomain.com&responsetype=xml
Passing VerificationCode
https://resellertest.enom.com/interface.asp?
command=raa_resendnotification&uid=resellid&pw=resellpw
&verificationcode=1558f096-9202-4b21-81d6-9f34d207514d
&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=raa_resendnotification&uid=resellid&pw=resellpw
&firstname=Joe&lastname=Tester
&emailaddress=joetester@test.com&responsetype=xml
Output
- 1052 -
API Command Categories
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.368</ExecTime>
<Done>true</Done>
<TrackingKey>b708ed6c-7ba1-427d-a467-3015b4373e5b</Track-
ingKey>
<RequestDateTime>12/4/2013 8:25:02 AM</RequestDateTime>
</interface-response>
Related commands
l RAA_GetInfo
l RAA_ResendNotification
l RPT_GetReport
RC_CancelSubscription
Description
Definition
Cancel a RichContent subscription.
Usage
Use this command to cancel a RichContent subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Click a Subscription link. At the bottom of the RichContent Manager page, click Cancel
this service. At the bottom of the form, the Cancel Service button calls the RC_
CancelSubscription command.
- 1053 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscription must be associated with this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1054 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query cancels a RichContent subscription and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_CancelSubscription&uid=resellid&pw=resellpw
&SubscriptionID=2811&ReasonID=1
&Comments=No%20longer%20needed&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 1055 -
API Command Categories
Related commands
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_FreeTrialCheck
Description
Definition
- 1056 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l Reseller accounts can generally have one free trial for each email address that has
not previously
l subscribed to RichContent (although we reserve the right to end free trials for
accounts that appear to be
l abusing the free trials).
l Retail accounts are limited to one free trial.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1057 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query checks whether a RichContent free trial is available for a domain
name, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
Command=RC_FreeTrialCheck&uid=resellid&pw=resellpw
- 1058 -
API Command Categories
&email=john.doe@example.com&responsetype=xml
Related commands
l RC_CancelSubscription
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
- 1059 -
API Command Categories
RC_GetLoginToken
Description
Definition
Retrieve the URL for the RichContent control panel.
Usage
Use this command to retrieve the URL for the RichContent control panel. Using this com-
mand allows your customers to instantly link to the control panel to integrate the
RichContent into their sites without interruption.
Using this command logs your customers in to RichContentWidget.com as a branded
site. If you prefer to build your own custom-branded control panel, contact your reseller
sales representative.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
The Login to the control panel link launches the RC_GetLoginToken command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent account must belong to this login ID.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1060 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1061 -
API Command Categories
Example
The following query retrieves a RichContent login token and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_GetLoginToken&uid=resellid&pw=resellpw
&PublisherID=208&responsetype=xml
- 1062 -
API Command Categories
</interface-response>
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_GetSubscriptionDetails
Description
Definition
Retrieve information on one RichContent subscription.
Usage
Use this command to retrieve information on one RichContent subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Clicking on any subscription name launches the RC_GetSubscriptionDetails command.
Constraints
The query must meet the following requirements:
- 1063 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1064 -
API Command Categories
Parameter Description
Status of this RichContent subscription. Possible values: 1
Status Service Active 2 Service Disabled 3 Pending Cancellation 4
Policy Violation
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves details for one RichContent subscription and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_GetSubscriptionDetails&uid=resellid
&pw=resellpw&SubscriptionID=1817&responsetype=xml
- 1065 -
API Command Categories
In the response, subscription information and an ErrCount value 0 indicate that the query
was successful:
Output
- 1066 -
API Command Categories
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_GetSubscriptions
Description
Definition
Retrieve a list of RichContent subscriptions for a domain name account.
Usage
Use this command to retrieve a list of RichContent subscriptions for an account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
The RC_GetSubscriptions command populates the table on this page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1067 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1068 -
API Command Categories
Parameter Description
SubscriptionID Identification number for this RichContent subscription
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of RichContent subscriptions for this domain name
account, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_GetSubscriptions&uid=resellid&pw=resellpw
&responsetype=xml
- 1069 -
API Command Categories
In the response, a list of Subscriptions and an ErrCount value 0 indicate that the query
was successful:
Output
- 1070 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.188</ExecTime>
<Done>true</Done>
<debug />
<TrackingKey>80f3b325-4694-4038-bb9b-8b641d69a932</Track-
ingKey>
</interface-response>
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_RebillSubscription
Description
Definition
Rebill a RichContent subscription for which the initial billing failed because of insuf-
ficient account balance.
Usage
When a billing for RichContent fails because of an insufficient account balance, use this
command to rebill.
- 1071 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/reports.aspx
In the Periodic Billing History Report section, click Run Report. Any RichContent sub-
scriptions that are in their rebill period but have not rebilled successfully appear in this
list. Clicking the Rebill link runs the RC_RebillSubscription command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscription must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1072 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query attempts to rebill the account for the specified RichContent sub-
scription, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_RebillSubscription&uid=resellid&pw=resellpw
&SubscriptionID=3974&responsetype=xml
- 1073 -
API Command Categories
In the response, an ErrCount value 0 indicates that the query executed successfully. A
Success value True indicates that this rebill attempt was successful. In this example, the
Success value False is due to an insufficient account balance:
Output
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
- 1074 -
API Command Categories
RC_ResetPassword
Description
Definition
When the customer has forgotten their password, create a new password and email it to
the email address associated with this RichContent subscription.
Usage
Use this command when a customer has forgotten the password to their RichContent
control panel. This command generates a new password and emails it to the customer.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Clicking the Forgot your password? link launches the RC_ResetPassword command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent identification number must be associated with this domain name
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1075 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query generates a new password and sends it to the customer, and sends
the response in XML format:
- 1076 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=RC_ResetPassword&uid=resellid&pw=resellpw
&PublisherID=208&responsetype=xml
In the response, the Success value True indicates that the query was successful:
Output
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_SetBillingCycle
- 1077 -
API Command Categories
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_SetBillingCycle
Description
Definition
Specify the billing cycle for a RichContent subscription.
Usage
Specify the billing cycle for a RichContent subscription. This command also allows you
to choose whether to bill now for the new billing cycle or wait until the next posted billing
date.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Click on any subscription name. Making changes in the Modify your Billing Cycle
options section and then clicking Save Changes launches the RC_SetBillingCycle com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscription must be associated with this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 1078 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
- 1079 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets the billing cycle for a RichContent subscription to 12 months,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_SetBillingCycle&uid=resellid&pw=resellpw
&SubscriptionID=2787&Months=12&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 1080 -
API Command Categories
<Done>true</Done>
<debug />
<TrackingKey>651aca03-b767-488e-aab9-d969c431c584</Track-
ingKey>
</interface-response>
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetPassword
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
RC_SetPassword
Description
Definition
Set a user-specified password for all RichContent subscriptions associated with one
email address.
Usage
Use this command to set a user-specified password for the RichContent subscriptions
associated with one email address.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
- 1081 -
API Command Categories
Click on any subscription name. In the Subscription Settings section, changing the pass-
word and then clicking Save Settings launches the RC_SetPassword command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscriptions must be associated with this domain name
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1082 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the password for the set of RichContent subscriptions that
are associated with a single email address, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_SetPassword&uid=resellid&pw=resellpw
&PublisherID=207&CurrentPassword=asdasdaf
&NewPassword=NewPassword208&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 1083 -
API Command Categories
In the response, a Success value True indicates that the query was successful:
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetSubscriptionDomain
l RC_SetSubscriptionName
- 1084 -
API Command Categories
RC_SetSubscriptionDomain
Description
Definition
Associate a domain name with a RichContent subscription.
Usage
Use this command to associate a domain name with a RichContent subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Click on any subscription name. In the Subscription Settings section, supplying a
domain name and then clicking Save Settings launches the RC_SetSub-
scriptionDomain command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscription must be part of this domain name account.
l Our system does not validate for the existence of the source domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1085 -
API Command Categories
ResultText Result of this query; this text corresponds to the result code
TrackingKey Tracking identifier for this query string, for our logging
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1086 -
API Command Categories
Example
The following query sets the domain for a RichContent subscription and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_SetSubscriptionDomain&uid=resellid&pw=resellpw
&SubscriptionID=2787&SourceDomain=news.yahoo.com
&responsetype=xml
In the response, the Success value True indicates that the query was successful:
Output
- 1087 -
API Command Categories
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionName
RC_SetSubscriptionName
Description
Definition
Specify a user-created display name for this RichContent subscription.
Usage
Use this command to specify a display name for this RichContent subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/richcontent/manage.aspx
Click on any subscription name. In the Subscription Details section, clicking edit, then
supplying a subscription name, and then clicking Save Settings launches the RC_
SetSubscriptionName command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The RichContent subscription must be associated with this domain name account.
- 1088 -
API Command Categories
l RichContent subscription names must be unique to this domain name account, but
do not need to be
l unique relative to the entire RichContent system.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1089 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query assigns a new user-specified display name to a RichContent sub-
scription and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RC_SetSubscriptionName&uid=resellid
&pw=resellpw&SubscriptionID=2787
&NewSubscriptionName=FriendlyName21
&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
- 1090 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt02</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.203</ExecTime>
<Done>true</Done>
<debug />
<TrackingKey>8e8ff6af-9c62-49a9-9e5c-7f4fe7b-
b41a5</TrackingKey>
</interface-response>
Related commands
l RC_CancelSubscription
l RC_FreeTrialCheck
l RC_GetLoginToken
l RC_GetSubscriptionDetails
l RC_GetSubscriptions
l RC_RebillSubscription
l RC_ResetPassword
l RC_SetBillingCycle
l RC_SetPassword
l RC_SetSubscriptionDomain
RefillAccount
Description
Definition
Add funds to your account using a credit card.
Usage
To add funds to your account, set parameter Debit=True and include the credit card para-
meters.
- 1091 -
API Command Categories
To remove your credit card information from our database, set parameter Debit=True and
omit the credit card parameters.
To retrieve your account balance without adding funds, and to retrieve the current credit
card information for the account, set parameter Debit=False.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/RefillAccount.asp
At the bottom of the Credit Card section, the submit button calls the RefillAccount com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The account must be a reseller account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1092 -
API Command Categories
Required to add
Credit card type. Options are AmEx, Dis-
CCType funds to this 10
cover, MasterCard, Visa.
account
Required to add
Credit card holders name as imprinted
CCName funds to this 60
on the credit card
account
Required to add
CCNumber funds to this 16-digit credit card number 16
account
Required to add
Month in which credit card expires, in
CCMonth funds to this 2
MM format
account
Required to add
Year in which credit card expires, in
CCYear funds to this 4
YYYY format
account
Required to add
Optional Street address as shown on
CCAddress funds to this 60
credit card bill
account
- 1093 -
API Command Categories
Required to add
State or province as shown on credit card
CCStateProvince funds to this 60
bill
account
Required to add
Zip code or postal code as shown on
CCZip funds to this 16
credit card bill
account
Required to add
Country of credit card billing address,
CCCountry funds to this 2
expressed as 2-character country code
account
- 1094 -
API Command Categories
Parameter Description
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML
l in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds $100.00 to the account balance for resellid. It uses a card dif-
ferent from the one stored for the account, passes the credit card information using the
secure HTTPS protocol, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=REFILLACCOUNT&uid=resellid&pw=resellpw
&CCAmount=100&CCType=MasterCard&CCName=JohnDoe
&CCNumber=5200520052005200&CCMonth=02
&CCYear=2013&cvv2=200&ccaddress=100+Main+St.
&CCStateProvince=WA&cczip=99999&debit=true
&CCCountry=us&CCPhone=+1.5555559999&ResponseType=xml
- 1095 -
API Command Categories
<FName>John</FName>
<LName>Doe</LName>
<Reseller>1</Reseller>
<CCTRANSRESULT>APPROVED</CCTRANSRESULT>
<ResellerRefill>Transactions processed suc-
cessfully.</ResellerRefill>
<CreditCardStatus>Successful</CreditCardStatus>
<CCYear>2004</CCYear>
<CCMonth>2</CCMonth>
<CCNumber>************5200</CCNumber>
<CCName>JohnDoe</CCName>
<PaymentType>MasterCard</PaymentType>
<CCAddress>100 Main St.</CCAddress>
<CCCity>Hometown</CCCity>
<CCStateProvince>WA</CCStateProvince>
<CCCountry>us</CCCountry>
<CCPhoneDial />
<CCPhone>5555559999</CCPhone>
<CCZip>99999</CCZip>
</RefillAccount>
<Command>REFILLACCOUNT</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>0</IsLockable>
<IsRealTimeTLD>0</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetBalance
l GetTransHistory
l UpdateNotificationAmount
- 1096 -
API Command Categories
RegisterNameServer
Description
Definition
Register a domain name server.
Usage
Use this command to register one of your own servers as a domain name server.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/RegNameServer.asp
On the register a name server page, the submit button calls the RegisterNameServer
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The server you register must use a domain name that is in your account.
l eNom must be licensed with the Registry in which you want to register a name
server; you can only register name servers for TLDs that we support.
l The registrar lock for the domain must be set to off while you register a name
server. You can switch the registrar lock back on (and we recommend that you do
so) once the name server is registered.
l Name servers for .us names must be located in the United States.
l .co.uk and .org.uk names must have at least two name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
- 1097 -
API Command Categories
¶mname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1098 -
API Command Categories
Example
The following query requests that the computer with IP address 127.0.0.1, known as ns1.-
nameservices.com, be registered as a name server. The query requests the response in
XMLL format:
Query
https://resellertest.enom.com/interface.asp?
command=registernameserver&uid=resellid&pw=resellpw
&add=true&nsname=dns1.resellerdocs.com
&ip=127.0.0.1&responsetype=xml
In the response, the RRP code of 200 and success message in the RRP text indicate a
successful registration:
Output
- 1099 -
API Command Categories
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNS
l GetDNSStatus
l ModifyNS
l ModifyNSHosting
l UpdateNameServer
RemoveTLD
Description
Definition
Remove TLDs from your list of authorized TLDs that you offer to your resellers and retail
customers. Or, revert to our default list, which includes all TLDs that we support.
Usage
Use this command to remove TLDs from your custom list of authorized TLDs that you
offer to your resellers and retail customers. This command controls the list of TLDs we
send you for registrations, renewals, and transfers.
This command does not function unless you have previously used the AuthorizeTLD
command to authorize TLDs. It will not remove TLDs if your account is using our default
list.
If you run RemoveTLD with one TLD, our system starts with your current list, removes
the single TLD, and leaves the rest. If you remove all TLDs from your list of authorized
TLDs, your account will revert to our default list (all TLDs that we support).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/RenewalPricing.asp?tab=1
If you remove TLDs from your authorized list, refreshing this page will reflect the change.
- 1100 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l You can only remove TLDs that you added using the AuthorizeTLD command.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1101 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query removes TLDs .us and .ca from resellids list of authorized TLDs,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=removetld&uid=resellid&pw=resellpw
&domainlist=us,ca&responsetype=xml
In the response, the list of TLDs and the ErrCount value of 0 confirm that the query was
successful:
Output
- 1102 -
API Command Categories
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<ExecTime>1.191406</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l AuthorizeTLD
l GetTLDList
l PE_SetPricing
l SetResellerTLDPricing
RemoveUnsyncedDomains
Description
Definition
Remove out-of-sync domains from a specified Magic Folder, or from all Magic Folders in
the account.
Usage
Use this command to remove out-of-sync domains from a specified Magic Folder, or from
all Magic Folders in the account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 1103 -
API Command Categories
https://resellertest.enom.com/domains/folder-control-pan-
el/default.asp?FolderName=AAAaa
The Remove Names button calls the RemoveUnsyncedDomains command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1104 -
API Command Categories
Parameter Description
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query removes out-of-sync domains from one folder, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=RemoveUnsyncedDomains&uid=resellid
&pw=resellpw&FolderName=Master-Magic&responsetype=XML
In the response, a Result value 1 indicates that the query was successful:
Output
- 1105 -
API Command Categories
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l UpdateDomainFolder
RenewPOPBundle
Description
Definition
Renew the annual subscription on a POP mail 10-pak in real time.
Usage
Use this command to renew, in real time, the annual subscription on a POP mail 10-pak.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
- 1106 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameID=152533676
The add years button behaves similarly to the RenewPOPBundle command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l This command is available for reseller accounts only. Retail accounts must use the
queue-based
l shopping cart process to renew POP bundles.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1107 -
API Command Categories
- 1108 -
API Command Categories
Requiredfor our
CreditCardNumber Credit card number 128
CC processing
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1109 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query renews POP pak 5105 for 1 year and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=renewpopbundle&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&pakid=5105
&quantity=1&responsetype=xml
In the response, an OrderID value and an ErrCount value 0 confirm that the query was
successful:
Output
- 1110 -
API Command Categories
Related commands
l Extend
l GetPOP3
l GetPOPExpirations
l GetRenew
l Purchase
l PurchasePOPBundle
l RenewServices
RenewServices
Description
Definition
Renew one value-added service in real time.
Usage
Use this command to renew one value-added service in real time, as opposed to going
through our shopping cart.
This real-time command currently supports ID Protect and DNS hosting.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The service must currently be subscribed for this domain. If not already subscribed,
do so using the PurchaseServices or AddToCart commands.
- 1111 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Optional; default is
NumYears Number of years to renew this service 2
1
- 1112 -
API Command Categories
Required our CC
CreditCardNumber Credit card number 128
processing
- 1113 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query renews ID Protect for two years and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=renewservices&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&service=WPPS
&numyears=2&responsetype=xml
In the response, an order ID number confirms that the query was successful:
Output
- 1114 -
API Command Categories
<interface-response>
<OrderID>157405437</OrderID>
<Command>RENEWSERVICES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.797</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l PurchaseServices
l RenewPOPBundle
RPT_GetReport
Description
Definition
Retrieve an itemized list of one type of activity in a domain name account.
Usage
Use this command to retrieve a list of one of the following types of account activity in a
domain name account: registrations, renewals, transfers, private label, subaccounts,
accounting, or expiring names.
Availability
All resellers have access to this command.
- 1115 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/newReports.asp
When you choose one of the seven report types listed above under Usage, the view
report button calls the RPT_GetReport command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The beginning date for reports must be no earlier than 6 months before today.
l The ResponseType must be XML. You can parse the XML response after receiv-
ing it.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1116 -
API Command Categories
Optional; default is
the last day of the First date to include in the report. Must
BeginDate month, two months be no earlier than six months before 10
before the current today. Use format MM/DD/YYYY
month
Optional; default is
RecordsToReturn 100 if Down- Number of items to return in this report. 8
load=False
- 1117 -
API Command Categories
Results specific to this report type. The results, and return para-
ReportResults
meters, vary by report type.
Commission Commission
- 1118 -
API Command Categories
Parameter Description
LoginID Login ID to which this order was delivered
In the full list of results, the start position of the next page of
NewStartPosition
results
In the full list of results, the position of the first result listed on
ThisStartPosition
this page
In the full list of results, the position of the last result listed on
ThisEndPosition
this page
In the full list of results, the position of the previous page of res-
PreviousStartPosition
ults
ShowPrevious Should this page show a link to the previous page of results?
ShowNext Should this page show a link to the next page of results?
ShowPaging Should this page show links to previous and next results?
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1119 -
API Command Categories
Example
The following query requests a list of registrations for the period 12/1/2009 to 1/1/2010,
and sends the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
command=RPT_GETREPORT&uid=resellid&pw=resellpw
&ReportType=0&BeginDate=12/01/2010&EndDate=01/01/2011
&responsetype=xml
Output
<interface-response>
<rpt>
<rptString>Registrations | Renewals | Transfers In | Priv-
ate Label |
Sub-Accounts | Accounting | Expiring Domains | | | | Pri-
cing Editor Updates |
Transfers Out | | Business Listing Bulk Update | | Business
Listing
Domain Update | Transactions | Order History | Periodic
Billing History | |
Premium Registration | Monthly Invoices | Invoice History |
Invoice Detail |
List of Invoices | Top Watchlist TLDs | Watchlist Summary |
Top Watchlists |
All Watchlists | All Watchlist Details | Domain Name His-
tory |
Domain Verification/Suspension
</rptString>
<threemopast>9/12/2011</threemopast>
<sixmopast>6/12/2011</sixmopast>
<begindate>12/6/2011</begindate>
<enddate>12/12/2011</enddate>
<option>
<reporttype id="0" name="Registrations"></reporttype>
<reporttype id="1" name="Renewals"></reporttype>
<reporttype id="2" name="Transfers In"></reporttype>
<reporttype id="11" name="Transfers Out"></reporttype>
<reporttype id="3" name="Private Label"></reporttype>
<reporttype id="4" name="Sub-Accounts"></reporttype>
- 1120 -
API Command Categories
- 1121 -
API Command Categories
TLD="com" CreationDate="2011-12-09T03:25:06.657"
ExpDate="2012-12-09T11:25:00" PaidAmount="8.9500"
BilledToCust="0.0000"/>
<row OrderID="157781021" SLD="resellerdocs12312"
TLD="net" CreationDate="2011-12-09T03:58:41.283"
ExpDate="2012-12-09T03:58:00" PaidAmount="8.9500"
BilledToCust="0.0000"/>
</rptrawxml>
<NewThisMonth>3</NewThisMonth>
<AverageRegPeriod>1.000000</AverageRegPeriod>
</results>
</rpt>
<Command>RPT_GETREPORT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.422</ExecTime>
<Done>true</Done>
<RequestDateTime>1/6/2014 4:16:19 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccounts
l GetTransHistory
- 1122 -
API Command Categories
SendAccountEmail
Description
Definition
Email subaccount login information to the billing contact of record.
Usage
Use this command to email subaccount login information to the billing contact for that
subaccount.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The subaccount must be a child of this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1123 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sends an email to the owner of the subaccount, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SendAccountEmail&uid=resellid&pw=resellpw
&loginID=resellidsub&account=659-fs-2869&responsetype=xml
- 1124 -
API Command Categories
In the response, an ErrCount value 0 confirms that the query was successful:
Output
<interface-response>
<Command>SENDACCOUNTEMAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.125</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 10:31:43 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAccountPassword
l GetAccountValidation
l GetSubAccounts
ServiceSelect
Description
Definition
Enable and disable services for a domain. You can also use this command to retrieve
the current settings for a service.
Usage
Use this command to enable or disable email (MX or MXE), DNS, Web Site Creator,
Web hosting, ID Protect services for a domain.
Use this command to create a Web Site Creator account.
- 1125 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l One query can select only one service. You must repeat the query for each service
you want to select.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
Required; if Service
is used without
Permitted values are: WSB (Web Site
NewOptionID and
Creator and Web hosting services)
Service Update, the 15
EmailSet (email services) WPPS (ID
response gives the
Protect Whois Privacy Protection)
current setting Ser-
vice type.
- 1126 -
API Command Categories
Required if Ser-
vice=WSB and Name of the Web hosting account to
HostAccount 14
NewOptionID=1066 enable or disable.
- 1127 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query enables email services, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=serviceselect&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com&newoptionid=1114
&service=emailset&update=True&responsetype=xml
The response indicates that email services have changed from option 1048 (no email) to
1114 (POP3/WebMail plus email forwarding):
- 1128 -
API Command Categories
Output
<interface-response>
<ParkingEnabled>False</ParkingEnabled>
<ServiceSelect>
<domainname sld="resellerdocs" tld="com" domain-
nameid="152533676"
>resellerdocs.com</domainname>
<service name="emailset">
<option name="1048"/>
<option name="1051"/>
<option name="1054"/>
<option name="1105"/>
<option name="1114"/>
</service>
<current-svc>1114</current-svc>
</ServiceSelect>
<Command>SERVICESELECT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.500</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>a0987545-ce87-4455-9965-559cbae-
f1d1e</TrackingKey>
<RequestDateTime>12/11/2011 10:37:40 PM</RequestDateTime>
</interface-response>
Related commands
l GetWPPSInfo
l GetIPResolver
l ModifyNS
l PE_SetPricing
- 1129 -
API Command Categories
l SetHosts
l SetIPResolver
l SetResellerServicesPricing
SetCatchAll
Description
Definition
Set a forwarding address for any emails addressed to nonexistent mailboxes.
Usage
Use this command to forward email addressed to nonexistent email addresses under a
domain name. The domain name must be in our system, but the forwarding address
does not need to be.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameId=152533676
The Catch-All Email box at the bottom of the page uses the SetCatchAll command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The ForwardTo address does not need to be in our system.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1130 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1131 -
API Command Categories
Example
The following query forwards any email addressed to nonexistent mailboxes for this
domain name, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SetCatchAll&uid=resellid&pw=resellpw
&sld=resellerdocs&tld=com
&ForwardTo=john.doe@resellerdocs.com&responsetype=xml
In the response, the presence of the CatchAll email address you supplied confirms that
the query was successful:
Output
<interface-response>
<CatchAll>john.doe@resellerdocs.com</CatchAll>
<Command>SETCATCHALL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.375</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 10:39:46 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeletePOP3
l Forwarding
l GetCatchAll
l GetDotNameForwarding
- 1132 -
API Command Categories
l GetForwarding
l GetPOP3
l GetPOPForwarding
l SetDotNameForwarding
l SetPOPForwarding
l SetUpPOP3User
SetCustomerDefinedData
Description
Definition
Enter data fields defined by you, and the corresponding data.
Usage
Use this command to create a storage place for data fields that do not currently exist.
Also use this command to put data into those custom data fields. This command allows
you to add data one field at a time.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1133 -
API Command Categories
Required if Type=2
TLD Top-level domain name (extension) 15
- 1134 -
API Command Categories
Parameter Description
as-is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a new data field labeled FavoriteCuisine and assigns a
value Italian for this account.:
Query
https://resellertest.enom.com/interface.asp?
command=SetCustomerDefinedData&uid=resellid&pw=resellpw
&ObjectID=1&Type=1&Key=FavoriteCuisine&Value=Italian&
DisplayFlag=0&EnteredBy=John&responsetype=xml
In the response, the value 0 for ErrCount confirms that the query executed successfully:
Output
<interface-response>
<Command>SETCUSTOMERDEFINEDDATA</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
- 1135 -
API Command Categories
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.313</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 10:44:27 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l DeleteCustomerDefinedData
l GetCustomerDefinedData
SetDNSHost
Description
Definition
Dynamically updates the IP address of the host computer in our name server records.
Usage
Use this command to update the IP address of a host that does not have a static IP
address.
If possible, use this command in a secure mode: https instead of http.
Availability
All customers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1136 -
API Command Categories
Input parameters
Build the query string using this syntax:
Query
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1137 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as-is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query uses a secure server to set the host for resellerdocs.com. Because
the query string does not specify the IP, the command sets the IP to that from which the
server received the query:
Query
https://resellertest.enom.com/interface.asp?
command=SetDNSHost&zone=resellerdocs.com&
DomainPassword=tester&responsetype=xml
The error count value 0 confirms that the DNS host was set successfully:
Output
- 1138 -
API Command Categories
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetHosts
l GetRegHosts
l SetHosts
SetDomainSRVHosts
Description
Definition
Create or edit SRV host records for a domain name.
Usage
Use this command to create or edit SRV (service) records for a domain name.
This command deletes all previously existing SRV records for the domain name. You
must include all SRV records that you want to end up with, in the query string.
SRV records are required for some newer Internet protocols such as SIP and XMPP.
Some other protocols support, but do not require, SRV records.
This command allows a user to supply the components of an SRV record that are dis-
cretionary, then adds TTL, Class, and formatting to produce a complete SRV record.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-pan-
el/default.asp?DomainNameID=152533676
The save button calls the SetDomainSRVHosts command.
- 1139 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain name must use our name servers.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1140 -
API Command Categories
- 1141 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query keeps an existing SRV record and adds a new record, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SETDOMAINSRVHOSTS&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&HostID1=17217418&Service1=imap&
Protocol1=TCP&Priority1=10&Weight1=50&Port1=1&
Target1=imap.resellerdocs.com.&HostID2=&Service2=xmpp&
Protocol2=UDP&Priority2=10&Weight2=50&Port2=98&
Target2=xmpp.resellerdocs.com.&ResponseType=XML
In the response, the Success value True and the ErrCount value 0 confirm that the query
was successful. In addition, the response specifies the numbers of SRV records that
were added, changed, and deleted:
Output
<interface-response>
<InsertedCount>0</InsertedCount>
<UpdatedCount>0</UpdatedCount>
<DeletedCount>0</DeletedCount>
<Success>true</Success>
<Command>SETDOMAINSRVHOSTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
- 1142 -
API Command Categories
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.188</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 11:15:59 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetDomainInfo
l GetDomainSRVHosts
l GetHosts
l SetHosts
SetDomainSubServices
Description
Definition
Update settings for domain services (active or inactive for email forwarding host
records).
Usage
Use this command to enable or disable services. (e.g., Host or email forwarding
records).
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
- 1143 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
HostRecords 1, 0 or empty
- 1144 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0, check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XMLin your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets the subservices of a domain and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=setdomainsubservices&uid=resellid&pw=resellpw&
sld=resellerdocs2&tld=net&ActivateForwarding=1&
ActivateHostRecords=1&responsetype=xml
In the response, the SetDomainServices value Successful and the ErrCount value of 0
confirm that services have been set successfully:
Output
- 1145 -
API Command Categories
<SetDomainServices>Successful</SetDomainServices>
</DomainServices>
<Command>SETDOMAINSUBSERVICES</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetDomainSubServices
l GetIPResolver
l ServiceSelect
l SetIPResolver
SetDotNameForwarding
Description
Definition
Set the email forwarding address for a .name domain.
Usage
Use this command if you want to use the .name Registrys email forwarding feature (you
can also use eNoms email forwarding with .name domains).
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
On the domain names menu, click my domains, and then click a .name domain.
- 1146 -
API Command Categories
On the domain control panel of the .name domain, scroll down to Email Settings.
Click the .name email button.
On the Manage this domain's ".NAME email forward" settings page, the save changes
button calls the SetDotNameForwarding command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain must have a .name TLD.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1147 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTMLor ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
John Doe registers domain john.doe.name, which automatically includes the email
address john@doe.name. The following query forwards email addressed to john@-
doe.name to john.doe@resellerdocs.com, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=setdotnameforwarding&uid=resellid&pw=resellpw&
sld=john.doe&tld=name&ForwardTo=john.doe@resellerdocs.com&
responsetype=xml
- 1148 -
API Command Categories
Related commands
l Forwarding
l GetCatchAll
l GetDotNameForwarding
l GetForwarding
l PurchasePOPBundle
l SetUpPOP3User
SetFilePermissions
Description
Definition
Set write permissions on Web hosting folders.
Usage
Allow or deny write permissions for Web hosting folders.
Availability
All resellers have access to this command.
- 1149 -
API Command Categories
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password
resellwebpw.
http://webhostingtest.ehost-services.com/websites/advanced.asp?Path=/testdir
The Write access allowed check box sets the value, and the SAVE NEW FOLDER
SETTINGS button calls the SetFilePermissions command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
l The SetFilePermissions command applies to subdirectories but not to root.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1150 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query grants write access for directory testdir, and sends the response in
XML format:
Query
https://resellertest.enom.com/interface.asp?
command=setfilepermissions&uid=resellid&pw=resellpw&
hostaccount=resellwebid&directory=testdir&
WriteAccess=On&responsetype=xml
- 1151 -
API Command Categories
In the response, the Successful value True and the ErrCount value 0 confirm that the
query was successful:
Output
Related commands
l AddDomainHeader
l AddHostHeader
l CreateHostAccount
l DisableFolderApp
l EnableFolderApp
l GetFilePermissions
l IsFolderEnabled
l ListWebFiles
l MetaBaseGetValue
l MetaBaseSetValue
l WebHostCreateDirectory
- 1152 -
API Command Categories
SetHosts
Description
Definition
Set host records for a domain name.
Usage
Use this command to change the host records for a domain name.
This command deletes the existing host records before replacing them with the host
records included in the query string. To avoid unpleasant surprises for the user, some
resellers use the GetHosts command to retrieve existing host records, and populate the
SetHosts query string with existing host records while also allowing the user to add or
delete host records.
To set SRV records, use the SetDomainSRVHosts command.
To enable or disable email, use the ServiceSelect command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/HostConfig.asp?DomainNameID=152533676
On the host settings page, the save changes button calls the SetHosts command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l This command deletes your existing host records before replacing them with the
records you include in the query string. See Usage note, above.
Input parameters
Build the query string using this syntax:
- 1153 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1154 -
API Command Categories
Notes
l A fully qualified domain name is expressed in the format hostname.SLD.TLD..
Note that the period at the end is an essential component of a fully qualified
domain name.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1155 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
l On executing this command, the MX records are not deleted. But all other hosts are
deleted and re-created as required.
Example
The following query sets four host records for resellerdocs.com. The results:
lresellerdocs.com forwards mail to IP address 66.150.5.189.
l photos.resellerdocs.com points to domain name photos.msn.com
Query
https://resellertest.enom.com/interface.asp?
command=sethosts&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&HostName1=@&RecordType1=A&
Address1=66.150.5.189&HostName2=photos&RecordType2=CNAME&
Address2=photos.msn.com.&HostName3=yahoo&RecordType3=URL&
Address3=204.71.200.72&HostName4=msn&RecordType4=FRAME&
Address4=http://www.msn.com&responsetype=xml
The error count value of 0 confirms that hosts have been set successfully:
Output
- 1156 -
API Command Categories
Related commands
l GetHosts
l GetMetaTag
l GetRegHosts
l GetSPFHosts
l PurchaseServices
l SetDomainSRVHosts
l SetDNSHost
l SetSPFHosts
l UpdateMetaTag
SetIPResolver
Description
Definition
Update IP Resolver settings.
Usage
Use this command to set information for the NameMyComputer service.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://re-
sellertest.enom.com/domains/IPResolverConfig.asp?DomainNameID=152533676
On the name my computer page, the save changes button calls the SetIPResolver com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1157 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1158 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets information for the Name My Computer service, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SetIPResolver&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&ClientUserID=12345678&
HostName=home&ServiceID=1&responsetype=xml
- 1159 -
API Command Categories
</domainname>
<IPResolver>
<ip-resolver-id />
<orig-host-name />
<host-name>home</host-name>
<client-user-id>
<![CDATA[ 12345678 ] ]>
</client-user-id>
<service-id>1</service-id>
<offine-url>
<![CDATA[ ] ]>
</offine-url>
<data-errors />
</IPResolver>
<SetIPResolver>Successful</SetIPResolver>
</SetIPResolver>
<Command>SETIPRESOLVER</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>eNom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetIPResolver
l ServiceSelect
SetPakRenew
Description
Definition
Set the auto-renew behavior for a POP email pak.
Usage
Use this command to set auto-renew behavior for an individual POP pak.
- 1160 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameId=152533676
At the bottom of the section for each POP pak, the Attempt to auto-renew check box calls
the SetPakRenew command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The POP pak bundle ID must belong to this domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1161 -
API Command Categories
AutoPakRenew Auto-renew setting for the pak. Values are 1 (on) or 0 (off)
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query turns the POP pak auto-renew setting for bundle 5105 on, and
sends the response in XML format:
Query
- 1162 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=SETPAKRENEW&uid=resellid&pw=resellpw&
DomainNameID=152533676&bundleid=5105&
AutoPakRenew=1&ResponseType=XML
In the response, the error count of 0 and absence of error messages confirm that the
query was successful:
Output
<interface-response>
<PakUpdated>5105</PakUpdated>
<AutoPakRenew>1</AutoPakRenew>
<Command>SETPAKRENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.156</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 11:33:42 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetPOP3
l GetRenew
l SetRenew
l UpdateCusPreferences
- 1163 -
API Command Categories
SetPassword
Description
Definition
Set a password for a domain name.
Usage
Use this command to set a password for access to a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://re-
sellertest.enom.com/domains/SubAccountConfig.asp?DomainNameID=152533676
On the domain password page, the save changes button calls the SetPassword com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain name password must use ASCII characters, and must be 6 to 60 char-
acters in length.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1164 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1165 -
API Command Categories
Example
The following query sets the domain password for resellerdocs.com as resellerdocspw,
and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
com-
mand=setpassword&uid=resellid&pw=resellpw&sld=resellerdocs&
tld=com&domainpassword=resellerdocspw&responsetype=xml
<interface-response>
<Command>SETPASSWORD</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.344</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 11:35:47 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
- 1166 -
API Command Categories
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetRegLock
l SetRenew
l StatusDomain
l ValidatePassword
SetPOPForwarding
Description
Definition
Create, change, or delete an email forwarding address for a domain name.
Usage
Use this command to create, update, or delete email forwarding records for a domain
name.
This command can be used to configure email forwarding addresses for both our POP
mail and our email forwarding services.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/MailConfig.asp?DomainNameID=152533676
The save changes button calls the SetPOPForwarding command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1167 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1168 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates an email forwarding record: Email addressed to sales@re-
sellerdocs.com will be forwarded to info@resellerdocs.com. The query string also
requests a response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SETPOPFORWARDING&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&username=sales&
Email=resellerdocs.com&forwardTo=info@resellerdocs.com&
Enable=1&StatusFlags=1&ResponseType=xml
In the response, the Success value 1 indicates that the query was successful:
Output
- 1169 -
API Command Categories
Related commands
l DeletePOP3
l GetCatchAll
l GetPOP3
l GetPOPForwarding
l PurchasePOPBundle
l SetUpPOP3User
SetRegLock
Description
Definition
Set the registrar lock for a domain name.
Usage
- 1170 -
API Command Categories
Set the registrar unlock value to 0 to prevent unauthorized transfer of a domain name to
another registrar.
Set the registrar unlock value to 1 to allow unrestricted transfer of a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Man-
ager.aspx?DomainNameID=152533676
On the Domain Name Maintenance page, the check box marked Do not allow this
name to be transferred sets the value for the UnlockRegistrar parameter, and the save
changes button calls the SetRegLockcommand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1171 -
API Command Categories
Identification number for this query, for our history and error
TrackingKey
logs.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that the registrar lock be set (unlockregistrar set to false),
and requests the response in XML format:
Query
- 1172 -
API Command Categories
https://resellertest.enom.com/interface.asp?
com-
mand=setreglock&uid=resellid&pw=resellpw&sld=resellerdocs&
tld=com&unlockregistrar=0&responsetype=xml
In the response, an ErrCount value 0 indicates that the query was successful:
Output
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
- 1173 -
API Command Categories
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRenew
l StatusDomain
l ValidatePassword
SetRenew
Description
Definition
Set the auto-renew flag for a domain name.
Usage
Use this command with RenewFlag set to 1 to renew the domain registration auto-
matically. Use this command with RenewFlag set to 0 to require the owner to actively
renew.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Domain-Man-
ager.aspx?DomainNameID=152533676
On the Domain Name Maintenance page, the check box marked Renew the registration
sets the value for the RenewFlag parameter, and the save changes button calls the
SetRenew command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1174 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1175 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that resellerdocs.com renew automatically, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=setrenew&uid=resellid&pw=resellpw&sld=resellerdocs&
tld=com&renewflag=1&responsetype=xml
The response confirms that the autorenew flag is set successfully (RenewName=1):
Output
- 1176 -
API Command Categories
<interface-response>
<RenewName>True</RenewName>
<Success>True</Success>
<Command>SETRENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.266</ExecTime>
<Done>true</Done>
<RequestDateTime>12/11/2011 11:40:17 PM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l Extend
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l InsertNewOrder
l SetPakRenew
l SetPassword
l SetRegLock
l StatusDomain
l UpdateExpiredDomains
l ValidatePassword
- 1177 -
API Command Categories
SetResellerServicesPricing
Description
Definition
Set the prices you charge your reseller for services.
Usage
Use this command to set prices you charge a subaccount for services.
This command differs from the GetSubAccountDetails command in that the SetReseller-
ServicesPricing command allows you to set pricing of any combination of services,
SetResellerServicesPricing does not require you to simultaneously convert an account
to reseller status, and SetResellerServicesPricing does not require you to set all service
prices in a single query.
To cover all the functionality of the GetSubAccountDetails command without its restric-
tions, use SetResellerTLDPricing, and SetResellerServicesPricing.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-Manage.asp?Account=107-vm-2729
The save changes button calls the SetResellerServicesPricing command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1178 -
API Command Categories
Either SubUID or
Login ID of the subaccount to set pricing
SubUID Account is 20
for.
Required
- 1179 -
API Command Categories
Parameter Description
Command Name of command executed
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query sets prices for services-wholesale prices that resellid charges sub-
account 443-up-6579 and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SETRESELLERSERVICESPRICING&uid=resellid&
pw=resellpw&account=443-up-6579&pop3=19.95&responsetype=xml
In the response, the list of prices that match those you set, and the ErrCount value 0,
indicate that the query was successful:
Output
- 1180 -
API Command Categories
</services>
<servicescount>2</servicescount>
<Command>SETRESELLERSERVICESPRICING</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>enom</Site>
<IsLockable>0</IsLockable>
<IsRealTimeTLD>0</IsRealTimeTLD>
<ExecTime>0.6875</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetSubAccounts
l PE_SetPricing
l SetResellerTLDPricing
SetResellerTLDPricing
Description
Definition
Set the prices you charge your resellers for domain names. You can use this command
to set any number of prices.
Usage
Use this command to set prices you charge your resellers for domain names.
We recommend that you use SetResellerTLDPricing for setting prices charged to sub-
accounts. The GetSubAccountDetails command also offers this functionality, but with
much stricter requirements on the query string.
- 1181 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/SubAccount-Manage.asp?Account=107-vm-2729
The save changes button calls the SetResellerTLDPricing command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The subaccount must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Either SubUID or
Login ID of the subaccount to set pricing
SubUID Account is 20
for.
Required
- 1182 -
API Command Categories
- 1183 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets prices for some TLDs and services in account resellid, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SETRESELLERTLDPRICING&uid=resellid&
pw=resellpw&account=443-up-6579&comprice=12.95&
comrenew=12.95&comtransfer=12.95&netprice=12.95&
netrenew=12.95&nettransfer=12.95&orgprice=8.95&
orgrenew=8.95&orgtransfer=8.95&wpps=8.50&pop3=19.95&
responsetype=xml
In the response, the list of TLDs and services and their prices, and the ErrCount value 0,
confirm that the query was successful:
Output
- 1184 -
API Command Categories
Related commands
l AuthorizeTLD
l GetSubAccountDetails
l GetSubAccounts
l GetTLDList
- 1185 -
API Command Categories
l PE_GetTLDID
l PE_SetPricing
l RemoveTLD
l SetResellerServicesPricing
SetSPFHosts
Description
Definition
Create or update Sender Policy Framework (SPF) host records for a domain name.
Usage
Use this command to create or update SPF host records for a domain name.
The SetSPFHosts command creates or updates one record per query. To set more than
one SPF host record per query, use the SetHosts command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/HostConfig.asp?DomainNameID=152533676
The host records setup section behaves similarly to the SetSPFHosts command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1186 -
API Command Categories
- 1187 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, sendResponseType=HTMLor ResponseType=XMLin your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query sets SPF host records for domain resellerdocs.com and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SETSPFHOSTS&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&HostName=test&
Address=v%3dspf1%20mx%20ptr%20a:regular%20a:hostnames
%20a:po%20mx:MX%20mx:servers%20mx:to%20ip4:63.251.174.113
%20include:myISP.net%20include:mydomain.com%20-all&
RecordType=txt&mxPref=&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
<interface-response>
<Command>SETSPFHOSTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.485</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 12:54:35 AM</RequestDateTime>
- 1188 -
API Command Categories
<debug></debug>
</interface-response>
Related commands
l GetHosts
l GetSPFHosts
l SetHosts
SetUpPOP3User
Description
Definition
Set up a POP3 mailbox for your domain.
Usage
Use this command when you have purchased a POP3 email pak (see
PurchasePOPBundle) and want to set up mailboxes for your domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/POPConfig.asp?DomainNameID=152533676
On the POP3 Mail page, below the Add users to this Email Pak box, the save changes
button calls the SetUpPOP3User command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l A POP mail pak must have been purchased for the domain and the correct
BundleID supplied.
- 1189 -
API Command Categories
l There must be at least one mailbox available in the email pak (BundleID) ref-
erenced.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1190 -
API Command Categories
POP3 password.
PasswordX is indexed, starting with
PasswordX Required 50
Password1. You can configure multiple
user names in a single query string
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1191 -
API Command Categories
Example
The following query creates mailbox james@resellerdocs.com and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SetupPop3user&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&BundleID=5134&UserName1=james&
Password1=resellpw&DisplayName1=James+Doe&responsetype=xml
In the response, the value 0 for parameter ErrCount indicates that the query was suc-
cessful:
Output
<interface-response>
<Success>True</Success>
<AccountsCreated>1</AccountsCreated>
<AccountsFailed>0</AccountsFailed>
<Command>SETUPPOP3USER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>8.547</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>37bb5652-5250-4483-a877-368f2e-
b7674f</TrackingKey>
<RequestDateTime>12/12/2011 12:57:20 AM</RequestDateTime>
</interface-response>
- 1192 -
API Command Categories
Related commands
l DeleteAllPOPPaks
l DeletePOP3
l DeletePOPPak
l Forwarding
l GetCatchAll
l GetDotNameForwarding
l GetForwarding
l GetMailHosts
l GetPOP3
l GetPOPForwarding
l ModifyPOP3
l PurchasePOPBundle
l SetDotNameForwarding
l SetUpPOP3User
SL_AutoRenew
Description
Definition
Set the Auto Renew flag for a SiteLock subscription.
Usage
Use this command to set the Auto Renew flag for a SiteLock subscription.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-lock/details.aspx?id=11
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The SiteLock subscription must belong to this account.
- 1193 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1194 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query sets the Auto Renew flag for a SiteLock subscription, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SL_AutoRenew&UID=resellid&PW=resellpw&
ResponseType=XML&SLID=11&AutoRenew=True
Output
<?xml version="1.0"?>
<interface-response>
<SiteLockAutoRenew>
<SLID>11</SLID>
<AutoRenew>True</AutoRenew>
</SiteLockAutoRenew>
<Success>True</Success>
<Command>SL_AUTORENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.016</ExecTime>
<Done>true</Done>
- 1195 -
API Command Categories
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>3/11/2012 10:35:29 AM</RequestDateTime>
</interface-response>
Related commands
l GetProductSelectionList
l SL_Configure
l SL_GetAccountDetail
l SL_GetAccounts
SL_Configure
Description
Definition
Configure a SiteLock subscription.
Usage
Use this command to configure a SiteLock subscription after initial purchase.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-lock/details.aspx?id=11
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The SiteLock subscription must belong to this account.
- 1196 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1197 -
API Command Categories
Parameter Description
as-is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0, the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise, pro-
cess the returned parameters as defined above.
Example
The following query configures a SiteLock subscription after initial purchase, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SL_Configure&UID=resellid&PW=resellpw&
ResponseType=XML&SLID=11&DomainName=mydomain.com&
Email=owner@mydomain.com
Output
<?xml version="1.0"?>
<interface-response>
<SiteLockConfigure>
<SLID>11</SLID>
<DomainName>mydomain.com</DomainName>
<EmailAddress>owner@mydomain.com</EmailAddress>
</SiteLockConfigure>
<Success>True</Success>
<Command>SL_CONFIGURE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
- 1198 -
API Command Categories
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site> <IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.200</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>3/11/2012 11:11:11 PM</RequestDateTime>
</interface-response>
Related commands
l GetProductSelectionList
l SL_AutoRenew
l SL_GetAccountDetail
l SL_GetAccounts
SL_GetAccountDetail
Description
Definition
Retrieve detailed information for one SiteLock subscription.
Usage
Use this command to retrieve detailed information for a SiteLock subscription.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-lock/details.aspx?id=11
- 1199 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The SiteLock subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1200 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0, the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise, pro-
cess the returned parameters as defined above.
Example
The following query retrieves detailed information for one SiteLock subscription, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SL_GetAccountDetail&UID=resellid&PW=resellpw&
ResponseType=XML&SLID=11
Output
<?xml version="1.0"?>
<interface-response>
<SiteLockAccountDetail>
<SLID>11</SLID>
<ProdType>262</ProdType>
<ProdDesc>SiteLock Premium</ProdDesc>
<DomainName><![CDATA[mydomain.com]]></DomainName>
<EmailAddress><![CDATA[owner@mydomain.com]]></EmailAddress>
<StatusID>2</StatusID>
<StatusDesc>Service Active</Status>
<SubStatusID/>
<SubStatusDesc/>
<OrderID>157776111</OrderID>
<ReferenceID>519325</ReferenceID/>
<OrderDate>03/14/2012</OrderDate>
<ConfigDate>04/16/2012</ConfigDate>
<FulfillmentDate>04/16/2012</FulfillmentDate/>
<ExpirationDate>04/16/2013</ExpirationDate>
<ValidityPeriod>12</ValidityPeriod>
<AutoRenew>True</AutoRenew>
- 1201 -
API Command Categories
<LoginURL><![CDATA[https://www.s-
itelock.com/rlogin.php?token=
393179cee551e0c147b5fe5a2e7d7c34]]></LoginURL>
</SiteLockAccountDetail>
<Success>True</Success>
<Command>SL_GETACCOUNTDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.219</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>1/11/2012 11:59:51 AM</RequestDateTime>
</interface-response>
Related commands
l GetProductSelectionList
l SL_AutoRenew
l SL_Configure
l SL_GetAccounts
SL_GetAccounts
Description
Definition
Retrieve a list of SiteLock subscriptions for this login ID.
Usage
Use this command to retrieve a list of SiteLock subscriptions for this login ID.
- 1202 -
API Command Categories
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-lock/manage.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The SiteLock subscription must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1203 -
API Command Categories
SubStatusID/SubStatusDesc. Permitted
values are:
1: Auto Renew Off
2: Billing Failed CC
3: Billing Failed Balance
- 1204 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0, the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise, pro-
cess the returned parameters as defined above.
Example
The following query retrieves a list of SiteLock account for this login ID, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SL_GetAccounts&UID=resellid&PW=resellpw&
ResponseType=XML&PagingPageSize=5&Prodtype=262&
SortBy=StatusID
- 1205 -
API Command Categories
Output
- 1206 -
API Command Categories
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>3/11/2012 2:06:27 PM</RequestDateTime>
</interface-response>
Related commands
l GetProductSelectionList
l SL_AutoRenew
l SL_Configure
l SL_GetAccountDetail
StatusDomain
Description
Definition
Get information about the status of a single domain name: registrar, expiration date, and
whether it is in your account.
Usage
Use this command when you have received an RRPCode value of 724 when attempting
to register a domain. The response for the Purchase command gives additional inform-
ation explaining the 724 code.
For other aspects of domain status, use the GetDomainStatus command for the fastest
response.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 1207 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The query returns an error if the domain does not belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1208 -
API Command Categories
Parameter Description
OrderID ID number of the most recent order that included this domain.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XMLin your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query requests information about domain resellerdocs.com, and requests
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=statusdomain&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&responsetype=xml
<interface-response>
<DomainStatus>
<DomainName>resellerdocs.com</DomainName>
<Registrar>Known</Registrar>
- 1209 -
API Command Categories
<InAccount>1</InAccount>
<ExpDate>6/10/2019 3:56:56 PM</ExpDate>
<OrderID/>
</DomainStatus>
<RRPCode>200</RRPCode>
<RRPText>Command completed successfully</RRPText>
<Command>STATUSDOMAIN</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.453</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 12:59:00 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetDomainStatus
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l ValidatePassword
- 1210 -
API Command Categories
SubAccountDomains
Description
Definition
List the domains in a subaccount.
Usage
Use this command to list the domains in a subaccount.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/subaccount-list.asp
In the list of subaccounts, click any Enter link. Clicking the X domain names link pro-
duces a similar result to using the SubAccountDomains command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The subaccount must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1211 -
API Command Categories
NS-Status YES indicates that this domain uses our default name servers
Position in the overall list of the last domain returned with this
EndPosition
query
- 1212 -
API Command Categories
Parameter Description
OrderBy Sorting parameter for names
Position in the overall list of the first domain returne d with this
StartPosition
query
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XMLin your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query returns the registered (iown) domain names in the subaccount, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SUBACCOUNTDOMAINS&uid=resellid&pw=resellpw&
Account=493-yp-5836&tab=iown&responsetype=xml
- 1213 -
API Command Categories
Output
- 1214 -
API Command Categories
<Command>SUBACCOUNTDOMAINS</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>e</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+03.00</TimeDifference>
<ExecTime>0.2109375</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l CreateAccount
l CreateSubAccount
l GetSubAccountDetails
l GetSubAccountPassword
l GetSubAccounts
l GetSubaccountsDetailList
SynchAuthInfo
Description
Definition
Synchronize a domains EPP key with the Registry, and optionally email it to the regis-
trant.
Usage
Use this command to create a new EPP key, synchronize the key with the Registry, and
optionally email it to the registrant.
Availability
- 1215 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1216 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query synchronizes the EPP key between the Registry and our database,
emails the EPP key to the registrant of record in our database, and sends the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=SynchAuthInfo&UID=resellid&pw=resellpw&
sld=resellerdocs&tld=com&EmailEPP=True&
- 1217 -
API Command Categories
RunSynchAutoInfo=True&ResponseType=xml
Related commands
l TP_CreateOrder
TEL_AddCTHUser
Description
Definition
This command creates a CTH account with a username, domain, zone, and simple
record.
Usage
- 1218 -
API Command Categories
Use this command to create a new Community TelHosting (CTH) account for .tel dir-
ectory records.
Use this command to configure a .tel domain after it is registered.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/domain_tel.as-
px?tab=update&DomainNameID=152768051&sld=resellerdocs&tld=tel
If this form initially displays with all fields blank (due to a domain name transfer or push,
or when the preconfiguration information was invalid), clicking the save button calls the
TEL_AddCTHUser command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this domain name account.
l The domain name must be a .tel domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1219 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a new CTH user account, and sends the response in XML
format:
- 1220 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=TEL_AddCTHUser&uid=resellid&pw=resellpw&
domainname=susantest20091128-1.tel&
username=susan1&password=susanpassword&
email=susan@enom.com&responsetype=xml
In the response, a success value true confirms that the query was successful:
Output
Related commands
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_IsCTHUser
- 1221 -
API Command Categories
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
TEL_GetCTHUserInfo
Description
Definition
This command retrieves information on the CTH account information associated with a
domain name.
Usage
Use this command to retrieve information on the CTH account information associated
with a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/
domain_tel.aspx?tab=update&DomainNameID=152768051&sld=resellerdocs&tld=tel
The TEL_GetCTHUserInfo command populates this page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The domain name must be a .tel domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1222 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1223 -
API Command Categories
Example
The following query creates a new CTH user account, and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_GetCTHUserInfo&uid=resellid&pw=resellpw
&domainname=resellerdocs.tel&responsetype=xml
In the response, a status value success confirms that the query was successful:
Output
<interface-response>
<tel_getcthuserinfo>
<username>Susan2</username>
<email>susan@enom.com</email>
<status>success</status>
</tel_getcthuserinfo>
<Command>TEL_GETCTHUSERINFO</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.000</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>b0c88377-05c6-45b5-bef7-1f9102c7a105</Track-
ingKey>
<RequestDateTime>12/12/2011 1:51:15 AM</RequestDateTime>
</interface-response>
- 1224 -
API Command Categories
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_IsCTHUser
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
TEL_GetCTHUserList
Description
Definition
Retrieve a list of CTH accounts.
Usage
Use this command to retrieve a list of CTH accounts, for example, to populate a drop-
down menu.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
Put a .tel domain name in the shopping cart.
https://resellertest.enom.com/cart/preconfigure.aspx
The Select an existing username link displays a dropdown menu populated by the TEL_
GetCTHUserList command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1225 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Contact email address for this CTH account. You can have
Email
more than one CTH account using the same email address
The .tel domain name for which you are creating a CTH
DomainName
account
- 1226 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query retrieves a list of CTH account usernames and sends the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_GetCTHUserList&uid=resellid&
pw=resellpw&responsetype=xml
In the response, a list of usernames and an ErrCount value 0 confirm that the query
string was successful:
Output
<interface-response>
<tel_getcthuserlist>
<users>
<user>
<username>Susan2</username>
<password>tester</password>
<email>susan@enom.com</email>
<domainname/>
</user>
<user>
<username>Susan7</username>
<password>tester</password>
<email>susan@enom.com</email>
<domainname/>
</user>
<user>
<username>testviji</username>
- 1227 -
API Command Categories
<password>testviji</password>
<email>test123@gmail.com</email>
<domainname/>
</user>
</users>
</tel_getcthuserlist>
<Command>TEL_GETCTHUSERLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>280cada8-f988-4bed-b0ed-b834e610b0a1</Track-
ingKey>
<RequestDateTime>12/12/2011 1:52:59 AM</RequestDateTime>
</interface-response>
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetPrivacy
l TEL_IsCTHUser
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
TEL_GetPrivacy
Description
Definition
Retrieve the current setting for displaying private CTH contact information.
- 1228 -
API Command Categories
Usage
Use this command to retrieve the current for displaying private CTH contact information.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/domain_tel.as-
px?tab=update&DomainNameID=152768051&sld=resellerdocs&tld=tel
The response from this command populates the Privacy Settings section on the .TEL Set-
tings page.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this domain name account.
l The domain name must be a .tel domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1229 -
API Command Categories
TelWhoisType Is this CTH contact type for a natural person or a legal person.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the privacy setting and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_GetPrivacy&uid=resellid&pw=resellpw&
DomainName=resellerdocs.tel&responsetype=xml
In the response, a Success value true confirms that the query executed successfully:
Output
- 1230 -
API Command Categories
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_IsCTHUser
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
TEL_IsCTHUser
Description
Definition
Check the existence of a CTH account username.
Usage
- 1231 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1232 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query checks whether a username exists, and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_IsCTHUser&uid=resellid&pw=resellpw&
username=Example2&responsetype=xml
- 1233 -
API Command Categories
In the response, a userexists value confirms that the query executed successfully:
Output
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_UpdateCTHUser
l TEL_UpdatePrivacy
- 1234 -
API Command Categories
EL_UpdateCTHUser
Description
Definition
Change the domain name, email address, or password associated with a CTH account.
Usage
Use this command to change the domain name, email address, or password associated
with a CTH account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/domain_tel.as-
px?tab=update&DomainNameID=152768051&sld=resellerdocs&tld=tel
If this form contains data when first displayed, clicking the save button calls the TEL_
UpdateCTHUser command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must be a .tel domain.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1235 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1236 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the CTH account associated with the specified domain
name, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_UpdateCTHUser&uid=resellid&pw=resellpw&
username=Example7&password=tester&
domainname=resellerdocs.tel&
email=john.doe@example.com&responsetype=xml
In the response, the Success value true confirms that the query was successful:
Output
- 1237 -
API Command Categories
</interface-response>
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_IsCTHUser
l TEL_UpdatePrivacy
TEL_UpdatePrivacy
Description
Definition
This command changes the privacy settings for .tel Whois contact information.
Usage
Use this command to change the privacy settings for .tel Whois contact information.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/domain_tel.as-
px?tab=update&DomainNameID=152768051&sld=resellerdocs&tld=tel
Changing the Privacy Settings and clicking save calls the TEL_UpdatePrivacy com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this domain name account.
- 1238 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1239 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the privacy settings for a .tel domain name and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TEL_UpdatePrivacy&uid=resellid&pw=resellpw&
domainname=resellerdocs.tel&telwhoistype=natural_person&
telpublishwhois=no&responsetype=xml
In the response, the Success value true confirms that the query executed successfully:
Output
- 1240 -
API Command Categories
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.531</ExecTime>
<Done>true</Done>
<debug />
<TrackingKey>6eab0016-ef6b-467e-bee6-60b45ed6a3e1</Track-
ingKey>
</interface-response>
Related commands
l TEL_AddCTHUser
l TEL_GetCTHUserInfo
l TEL_GetCTHUserList
l TEL_GetPrivacy
l TEL_IsCTHUser
l TEL_UpdateCTHUser
TLD_AddWatchlist
Description
Definition
Add a list of domain(s) to an existing the watchlist or create new watchlist with these
domains. An empty watchlist cannot be created.
Usage
Use this command to add a list of domain(s) to an existing the watchlist or create new
watchlist with these domains. An empty watchlist cannot be created.
LIST
You can create LIST(s) for organizing or managing watchlist domain names. Each LIST
consist of a ListID, ListName and ListEmail.
- 1241 -
API Command Categories
Each account has a default LIST (ListID=0 ), containing domains to watch. Domains can
appear in multiple LISTS. The default LIST cannot be deleted and email address cannot
be changed.
Example:
Operational/Logic Table:
Note:
l No = input parameter is not declared
l Yes = input parameter is declared and has value
l - = input parameter could be declared or not declared. Does not affect the end res-
ult
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tlds/watchlist.aspx
- 1242 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Format:
blogging.ninja
*.ninja
blogging.*
- 1243 -
API Command Categories
Done True indicates this entire response has reached you suc-
- 1244 -
API Command Categories
Parameter Description
cessfully
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds domain(s) to the watchlist, and requests the response in XML
format.
Query
Add to default watchlist
https://resellertest.enom.com/interface.asp?
command=TLD_Addwatchlist&UID=ResellID&PW=resellpw&
ResponseType=XML&
DomainList=blogging.ninja,*.ninja,blogging.*&
ListID=&ListName=&ListEmail=
https://resellertest.enom.com/interface.asp?
command=TLD_AddWatchlist&UID=ResellID&PW=resellpw&
ResponseType=XML&
domainlist=blogging.ninja,*.ninja,blogging.*&
ListID=&ListName=Customer1&ListEmail=clark@kent.com
https://resellertest.enom.com/interface.asp?
command=TLD_AddWatchlist&UID=ResellID&PW=resellpw&
ResponseType=XML&
domainlist=blogging.ninja,*.ninja,blogging.*&
- 1245 -
API Command Categories
ListID=16&ListName=&ListEmail=
Output
Add to default watchlist
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ID>74670</ID>
<DomainName><![CDATA[ blogging.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]></ResultMessage>
</Item>
<Item>
<ID>74671</ID>
<DomainName><![CDATA[ domain.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]></ResultMessage>
</Item>
.....
<FailCount>0</FailCount>
<SuccessCount>3</SuccessCount>
<TotalRecords>3</TotalRecords>
<Type>Account</Type>
<ListID>0</ListID>
<ListName />
<ListEmail />
</TLD_Watchlist>
<Command>TLD_ADDWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.594</ExecTime>
- 1246 -
API Command Categories
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/16/2012 2:52:25 PM</RequestDateTime>
</interface-response>
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ID>74681</ID>
<DomainName><![CDATA[ blogging.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]> </ResultMessage>
</Item>
<Item>
<ID>74682</ID>
<DomainName><![CDATA[ domain.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]> </ResultMessage>
</Item>
.....
<FailCount>0</FailCount>
<SuccessCount>3</SuccessCount>
<TotalRecords>3</TotalRecords>
<Type>Account</Type>
<ListID>33</ListID>
<ListName>customer1</ListName>
<ListEmail>clark@kent.com</ListEmail>
</TLD_Watchlist>
<Command>TLD_ADDWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
- 1247 -
API Command Categories
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.594</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/16/2012 2:52:25 PM</RequestDateTime>
</interface-response>
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ID>74698</ID>
<DomainName><![CDATA[ blogging.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]> </ResultMessage>
</Item>
<Item>
<ID>74699</ID>
<DomainName><![CDATA[ domain.ninja ]]></DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]> </ResultMessage>
</Item>
.....
<FailCount>0</FailCount>
<SuccessCount>3</SuccessCount>
<TotalRecords>3</TotalRecords>
<Type>Account</Type>
<ListID>33</ListID>
<ListName>customer1</ListName>
<ListEmail>superman@dailyplanet.com</ListEmail>
</TLD_Watchlist>
<Command>TLD_ADDWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
- 1248 -
API Command Categories
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.594</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/16/2012 2:52:25 PM</RequestDateTime>
</interface-response>
Related commands
l TLD_DeleteWatchlist
l TLD_GetCategory
l TLD_GetWatchlist
l TLD_GetTLD
l TLD_GetAgreementPage
TLD_DeleteWatchlist
Description
Definition
Delete a set of domains from a LIST or delete an entire LIST from the watchlist. Deleting
all domains in a LIST does not delete the LIST
Usage
Use this command to delete a set of domains from a LIST or delete an entire LIST from
the watchlist. Deleting all domains in a LIST does not delete the LIST
LIST
You can create LIST(s) for organizing or managing watchlist domain names. Each LIST
consists of a ListID, ListName and ListEmail.
Each account has a default LIST (ListID=0 ), containing domains to watch. Domains can
appear in multiple LISTS. The default LIST cannot be deleted and email address cannot
be changed.
Example:
- 1249 -
API Command Categories
Operational/Logic Table:
Note:
l No = input parameter is not declared
l Yes = input parameter is declared and has value
l - = input parameter could be declared or not declared. Does not affect the end res-
ult
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tlds/watchlist.aspx
The Delete button calls the TLD_DeleteWatchlist command.
- 1250 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1251 -
API Command Categories
Parameter Description
Success Success status for deleting domain name from the Watchlist
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query deletes list of domain(s) or a LIST from the Watchlist, and requests
the response in XML format.
Query
Delete domain(s)
https://resellertest.enom.com/interface.asp?
command=TLD_DeleteWatchlist&UID=ResellID&PW=resellpw&
ResponseType=XML&Action=DeleteListItem&
WatchlistIDList=73995&ListID=23
Delete LIST
- 1252 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=TLD_DeleteWatchlist&UID=ResellID&PW=resellpw&
ResponseType=XML&Action=DeleteList&
WatchlistIDList=&ListID=23
Output
Delete domain(s)
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ID>73995</ID>
<DomainName>73995</DomainName>
<Success>True</Success>
<ResultMessage><![CDATA[ ]]></ResultMessage />
</Item>
<FailCount>0</FailCount>
<SuccessCount>1</SuccessCount>
<TotalRecords>1</TotalRecords>
<Type>Account</Type>
<Action>DELETELISTITEM</Action>
<ListID>23</ListID>
</TLD_Watchlist>
<Command>TLD_DELETEWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.141</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/16/2012 3:55:55 PM</RequestDateTime>
</interface-response>
- 1253 -
API Command Categories
Delete LIST
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Type>Account</Type>
<Action>DELETELISTITEM</Action>
<ListID>4</ListID>
</TLD_Watchlist>
<Command>TLD_DELETEWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.141</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/16/2012 3:55:55 PM</RequestDateTime>
</interface-response>
Related commands
l TLD_AddWatchlist
l TLD_GetCategory
l TLD_GetWatchlist
l TLD_GetTLD
l TLD_GetAgreementPage
TLD_GetTLD
Description
Definition
- 1254 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1255 -
API Command Categories
TLD Category. Each TLD may have more than one category.
CategoryNames The first category in this list (comma delimited format) is the
Primary
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1256 -
API Command Categories
Example
The following query retrieves list of TLDs currently offered for this account, and requests
the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
command=TLD_GetTLD&UID=ResellID&PW=resellpw&
ResponseType=XML
Output
<?xml version="1.0"?>
<interface-response>
<TLD_GetTLD>
<TLD>
<Name><![CDATA[ ABOGADO ]]></Name>
<CategoryNames>Services</CategoryNames>
<NativeIDN><![CDATA[ ]]></NativeIDN>
<Description><![CDATA[ ]]></Description>
<TLDStatusID>1</TLDStatusID>
<TLDStatusDesc><![CDATA[ Awaiting Evaluation ]]
></TLDStatusDesc>
</TLD>
......<cut>......
<TLD>
<Name><![CDATA[ xn--io0a7i ]]></Name>
<CategoryNames>IDN,Technology</CategoryNames>
<NativeIDN><![CDATA[ ]]></NativeIDN>
<Description>
<![CDATA[ The string of " " means network. It is a col-
lection
of hardware components and computers interconnected by com-
munication
channels that allow sharing of resources and information.
]]>
</Description>
<TLDStatusID>1</TLDStatusID>
<TLDStatusDesc><![CDATA[ Awaiting Evaluation ]]
></TLDStatusDesc>
</TLD>
<TotalRecords>678</TotalRecords>
- 1257 -
API Command Categories
</TLD_GetTLD>
<Command>TLD_GETTLD</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.967</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/17/2012 11:11:11 AM</RequestDateTime>
</interface-response>
Related commands
l TLD_AddWatchlist
l TLD_DeleteWatchlist
l TLD_GetCategory
l TLD_GetWatchlist
l TLD_GetAgreementPage
TLD_GetWatchlist
Description
Definition
Retrieve a list of domains currently in a Watchlist LIST in this account.
Usage
Use this command to retrieve a list of domains currently in a Watchlist LIST in this
account.
LIST
- 1258 -
API Command Categories
You can create LIST(s) for organizing or managing watchlist domain names. Each LIST
consists of a ListID, ListName and ListEmail.
Each account has a default LIST (ListID=0 ), containing domains to watch. Domains can
appear in multiple LISTS. The default LIST cannot be deleted and email address cannot
be changed.
Example:
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tlds/watchlist.aspx
The My Watchlist tab calls the TLD_GetWatchlist command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1259 -
API Command Categories
- 1260 -
API Command Categories
ListID List ID
- 1261 -
API Command Categories
Parameter Description
FilterByDomainName Filter by Domain Name value
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves list of domains currently added to the Watchlist in this
account, and requests the response in XML format.
Query
Get LIST domains
https://resellertest.enom.com/interface.asp?
command=tld_getwatchlist&uid=ResellID&pw=resellpw&
responsetype=xml&pagingpagesize=2&
- 1262 -
API Command Categories
tld=xn--nqv7f&ListID=0&Action=
Get LIST
https://resellertest.enom.com/interface.asp?
command=tld_getwatchlist&uid=ResellID&pw=resellpw&
responsetype=xml&pagingpagesize=2&tld=&
ListID=&Action=GetListID
Output
Get Watchlist domains
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ID>69018</ID>
<DomainName><![CDATA[ blogging.xn--nqv7f ]]></DomainName>
<SLD><![CDATA[ blogging ]]></SLD>
<TLD><![CDATA[ xn--nqv7f]]></TLD>
<NativeIDN><![CDATA[ blogging. ]]></NativeIDN>
<StatusID>1</StatusID>
<StatusDesc><![CDATA[ Watching ]]></StatusDesc>
<SubStatusID>0</SubStatusID>
<SubStatusDesc><![CDATA[ ]]></SubStatusDesc>
<TLDCategory><![CDATA[ IDN ]]></TLDCategory>
<TLDCategoryDesc><![CDATA[ ]]></TLDCategoryDesc>
<TLDStatusID>1</TLDStatusID>
<TLDStatusDesc><![CDATA[ Awaiting Evaluation ]]>
</TLDStatusDesc>
</Item>
.....
<ListID />
<ListName />
<ListEmail />
<SortBy>none</SortBy>
<SortByDirection>desc</SortByDirection>
<StartPosition>1</StartPosition>
<PagingPageSize>2</PagingPageSize>
<SLD />
- 1263 -
API Command Categories
<TLD>ninja</TLD>
<Category />
<DomainName />
<RecordsCount>2</RecordsCount>
<TotalRecords>9</TotalRecords>
<AllRecords>3023</AllRecords>
</TLD_Watchlist>
<Command>TLD_GETWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.967</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/23/2012 11:29:08 AM</RequestDateTime>
</interface-response>
<?xml version="1.0"?>
<interface-response>
<TLD_Watchlist>
<Item>
<ListID>0</ListID>
<ListName><![CDATA[ ]]></ListName>
<ListEmail><![CDATA[ ]]></ListEmail>
</Item>
<Item>
<ListID>18</ListID>
<ListName><![CDATA[ Customer1 ]]></ListName>
<ListEmail><![CDATA[ john@smith.com ]]></ListEmail>
</Item>
<SortBy>none</SortBy>
<SortByDirection>asc</SortByDirection>
- 1264 -
API Command Categories
<StartPosition>1</StartPosition>
<PagingPageSize>2</PagingPageSize>
<TotalRecords>125</TotalRecords>
</TLD_Watchlist>
<Command>TLD_GETWATCHLIST</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.967</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>7/23/2012 11:29:08 AM</RequestDateTime>
</interface-response>
Related commands
l TLD_AddWatchlist
l TLD_GetCategory
l TLD_DeleteWatchlist
l TLD_GetTLD
l TLD_GetAgreementPage
TLD_GetWatchlistTlds
Description
Definition
Retrieve a list of Tlds currently in a Watchlist LIST in this account.
Usage
Use this command to retrieve a list of Tlds currently in a Watchlist LIST in this account.
- 1265 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/tlds/watchlist.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1266 -
API Command Categories
Permitted values
True / False
IsOpen Optional
or
0/1
- 1267 -
API Command Categories
Parameter Description
SortByDirection Start Position value
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves list of domains currently added to the Watchlist in this
account, and requests the response in XML format.
Query
Get LIST
https://resellertest.enom.com/interface.asp?
command=tld_getwatchlisttlds&uid=ResellID&pw=resellpw&
responsetype=xml&pagingpagesize=2&tld=&ListID=&
Action=GetListID
Output
- 1268 -
API Command Categories
- 1269 -
API Command Categories
</TLDCategoryDesc>
<DomainCount>
<![CDATA[ 0 ]]>
</DomainCount>
</Item>
<Item>
<TLD>
<![CDATA[ AIRFORCE ]]>
</TLD>
<TLDCategoryDesc>
<![CDATA[ Awaiting Evaluation ]]>
</TLDCategoryDesc>
<DomainCount>
<![CDATA[ 0 ]]>
</DomainCount>
</Item>
<SortBy>none</SortBy>
<SortByDirection>desc</SortByDirection>
<StartPosition>1</StartPosition>
<PagingPageSize>5</PagingPageSize>
<TotalRecords>5</TotalRecords>
</TLD_WatchlistTlds>
<Command>TLD_GETWATCHLISTTLDS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresell01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.047</ExecTime>
<Done>true</Done>
<TrackingKey>89271891-f58d-4920-8b0d-ef0ce-
f6b8b6a</TrackingKey>
<RequestDateTime>3/11/2013 12:17:43 AM</RequestDateTime>
<debug/>
</interface-response>
- 1270 -
API Command Categories
Related commands
l TLD_AddWatchlist
l TLD_GetCategory
l TLD_DeleteWatchlist
l TLD_GetTLD
l TLD_GetAgreementPage
TLD_Overview
Description
Definition
Retrieve a detailed overview of a TLD.
Usage
Use this command to retrieve a detailed overview of a TLD.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/help/faq-tlds.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1271 -
API Command Categories
QID Queue ID
- 1272 -
API Command Categories
Parameter Description
RegistrationFee Queue registration fee
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query retrieves detailed overview of TLD, and requests the response in
XML format.
Query
https://resellertest.enom.com/interface.asp?
command=TLD_Overview&UID=ResellID&PW=resellpw&
ResponseType=XML&TLD=ninja
Output
- 1273 -
API Command Categories
- 1274 -
API Command Categories
Related commands
l Queue_GetInfo
l Queue_GetExtAttributes
l Queue_DomainPurchase
l Queue_GetDomains
l Queue_GetOrders
l Queue_GetOrderDetail
l GetAgreementPage
- 1275 -
API Command Categories
TM_Check
Description
Definition
Check a trademark claim for a domain name from Trademark Clearinghouse (TMCH).
Usage
Use this command to check a trademark claim for a domain name from Trademark Clear-
inghouse (TMCH).
The Lookup Key returns a value when 1 (one) or more claim(s) exist for the specified
domain name.
The key value is valid for up to 24 hours. The countdown starts immediately after this
command (TM_Check) is successfully executed.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/cart/default.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1276 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query checks a trademark claim for test---validate.claimsgatwo domain
name from Trademark Clearinghouse (TMCH), and requests the response in XML
- 1277 -
API Command Categories
format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml&
Command=TM_Check&SLD=test---validate&tld=claimsgatwo
Output
Related commands
l TM_Check
l TM_GetNotice
l TM_UpdateCart
- 1278 -
API Command Categories
TM_GetNotice
Description
Definition
Retrieve an itemized list of Trademark Clearinghouse (TMCH) Claims for an SLD using
a Lookup Key.
Usage
Use this command to retrieve an itemized list of Trademark Clearinghouse (TMCH)
Claims for an SLD using a Lookup Key.
tcnID (Trademark Clearinghouse Claims Notification ID) is valid for 24 to 48 hours. The
countdown starts immediately after TP_Check command is successfully executed.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/cart/default.aspx
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1279 -
API Command Categories
Street Address
City City
State State
Country Country
- 1280 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0, check
ErrCount
the Err (1 to ErrCount) values
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query retrieves an itemized list of Trademark Clearinghouse (TMCH)
Claims for an SLD using a Lookup Key, and requests the response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&SLD=test---validate&
ResponseType=xml&Command=TM_GetNotice&
LookupKey=2013112100%2f4%2f1%2fd%2fQdw2tSZ9X6FSqUH
Output
- 1281 -
API Command Categories
<Claim>
<MarkName>Test & Validate</MarkName>
<Holder Entitlement="owner">
<Org>Test Organization</Org>
<Address>
<Street>101 West Arques Avenue</Street>
<City>Sunnyvale</City>
<State>CA</State>
<ZipCode>10023-3241</ZipCode>
<Country>US</Country>
</Address>
<Email>info@example.example</Email>
</Holder>
<Jur Desc="United States of America" Country="US" />
<Class Desc="Musical instruments. " Num="15" />
<GoodsAndServices>guitar</GoodsAndServices>
</Claim>
<Claim>
<MarkName>Test & Validate</MarkName>
<Holder Entitlement="owner">
<Org>Test Organization</Org>
<Address>
<Street>101 West Arques Avenue</Street>
<City>Sunnyvale</City>
<State>CA</State>
<ZipCode>10023-3241</ZipCode>
<Country>US</Country>
</Address>
<Email>info@example.example</Email>
</Holder>
<Jur Desc="United States of America" Country="US" />
<Class Desc="Precious metals and their alloys and goods
in precious metals or coated therewith, not included
in other classes; jewellery, precious stones; horological
and chronometric instruments. " Num="14" />
<GoodsAndServices>Musical instruments</GoodsAndServices>
</Claim>
</TMNotice>
<Command>TM_GetNotice</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
- 1282 -
API Command Categories
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>1/10/2014 12:43:35 PM</RequestDateTime>
</interface-response>
Related commands
l TM_Check
l TM_GetNotice
l TM_UpdateCart
TM_UpdateCart
Description
Definition
Acknowledge and record the date time for a Trademark Clearinghouse (TMCH) Claims
ID for a domain in the shopping cart.
Usage
Use this command to acknowledge and record the date time for a Trademark Clear-
inghouse (TMCH) Claims ID a domain in the shopping cart.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/cart/default.aspx
- 1283 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid
Input parameters
- 1284 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0, check
ErrCount
the Err (1 to ErrCount) values
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query acknowledges and records the date time for a Trademark Clear-
inghouse (TMCH) Claims ID for a domain in the shopping cart, and requests the
response in XML format.
Query
https://resellertest.enom.com/interface.asp?
UID=ResellID&PW=resellpw&ResponseType=xml&
Command=TM_Notify&SLD=test---validate&
tcnID=bbbf6a2f0000000000000031553&
tcnAcceptDate=2014-01-10T08:00:00.0Z
Output
- 1285 -
API Command Categories
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.031</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</Track-
ingKey>
<RequestDateTime>1/10/2014 2:01:35 PM</RequestDateTime>
</interface-response>
Related commands
l TM_Check
l TM_GetNotice
l TM_UpdateCart
TP_CancelOrder
Description
Definition
Cancel a transfer order that has been submitted by eNom, but not yet processed by the
Registry.
Usage
Use this command to cancel the parts of a transfer order that has been submitted by us,
but not yet processed by the Registry (there is an interval of approximately 5 days
between the two events).
Availability
All resellers have access to this command.
Implementation on eNom.com
- 1286 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order must be valid and must belong to this account.
l A transfer order can be cancel only for domains that have a TransferOrderDetail
StatusID of 0, 9, 10,11, 12, 13, 28, or 29. Use TP_GetOrderDetail to retrieve the
statuses of each domain in the order.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1287 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l To be eligible for cancellation, each domain must be in one of the following
statuses. Retrieve an orders status by calling TP_GetOrder. Eligible Trans-
ferOrderDetail StatusIDs:
l 0 Transfer request created - awaiting fax
Example
The following query requests that transfer order ID 445413 be cancelled, and requests
the response in XML format:
Query
- 1288 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=TP_CancelOrder&uid=resellid&pw=resellpw&
transferOrderID=445413&responsetype=xml
In the response, the return value True for the Success parameter confirms the successful
cancellation of the order:
Output
Related commands
l PushDomain
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
- 1289 -
API Command Categories
TP_CreateOrder
Description
Definition
Transfer domains into an account. Accepts Fax and AutoVerification order types.
Usage
Use this command to create an order to transfer domains from another registrar to eNom
or one of its resellers.
You can also use this command to create but not submit a transfer order, using the
PreConfig parameter.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
When you transfer a .eu or .be domain name from another registrar, we recommend that
you always provide Registrant contact information that is separate from Billing contact
information; dont use the same as Billing default. Tip: If the Billing and Registrant con-
tact information are the same, we recommend changing the use or spelling of abbre-
viations in the street address to help our system recognize that it needs to create multiple
contacts. Separating the Registrant and Billing information makes it easier to update
Registrant contact information in the future.
Premium Domain
A unique, memorable or noteworthy name might be considered as a premium domain.
This type of domain will be more expensive depending on the name and TLD. If the TP_
CreateOrder command returns the error "CustomerSuppliedPrice is required",then this
domain is considered as a premium domain. The exact price for this domain must be
declared in the parameter CustomerSuppliedPrice. Use the PE_GetPremiumPricing
command to retrieve this price.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/TransferNew.asp
On the transfer a name page, the next button calls the TP_CreateOrder command.
- 1290 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be an ETP reseller account.
l All domain names in the order must be in top-level domains supported by this regis-
trar.
l To transfer EPP names, the query must include the authorization key from the
Registrar.
l When using the Fax order type, the registrant contact information must match the
current Whois registrant.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1291 -
API Command Categories
Optional;
RegistrantAddress1 Required for Fax Registrant address 60
orders
Optional
RegistrantAddress2 Required Fax Registrant additional address info 60
orders
Optional
RegistrantCity Required for Fax Registrant city 60
orders
- 1292 -
API Command Categories
Optional;
RegistrantEmailAddress Required for Fax Registrant email address 128
orders
Optional;
RegistrantFirstName Required for Fax Registrant first name 60
orders
Optional;
RegistrantLastName Required for Fax Registrant last name 60
orders
Optional;
RegistrantOrganizationName Required for Fax Registrant organization 60
orders
Required .org
names when you
RegistrantPostalCode supply new Registrant postal code 16
Registrant inform-
ation
- 1293 -
API Command Categories
Required our CC
CreditCardNumber Credit card number 128
processing
Required our CC
CVV2 Credit card verification code 4
processing
Required our CC
CCName Cardholders name 60
processing
Required our CC
CCAddress Credit card billing street address 60
processing
- 1294 -
API Command Categories
- 1295 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l Example of SLD and TLD params:
SLD1=first SLD
TLD1=first TLD
SLD2=second SLD
TLD2=secondTLD
l Additional params for contact information can be passed by replacing Registrant in
the param names above with Tech, Admin or AuxBilling.
l If UseContacts is set =1 and contact information is passed in the URL, current
Whois contacts are transferred and preconfigured contacts (passed in the URL) are
ignored.
l Automatic transfer of Whois information is available only for the largest registrars.
l An OrderType of Fax requires a signed fax to process the order, an OrderType of
Autoverification uses an electronic verification process to authorize and initiate the
transfer.
Example
The following query requests the creation of an autoverification transfer order, to transfer
domains resellerdocs2.net and resellerdocs3.info, and requests the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder&uid=resellid&pw=resellpw&
orderType=AutoVerification&sld1=resellerdocs2&
tld1=net&AuthInfo1=ros8enQi&sld2=resellerdocs3&tld2=info&
AuthInfo2=pkv7ihRb& domaincount=2&responsetype=xml
The response confirms the successful creation of transfer order 445413, and gives
details of the transfer:
Output
- 1296 -
API Command Categories
- 1297 -
API Command Categories
</interface-response>
Related commands
l PushDomain
l SynchAuthInfo
l TP_CancelOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_GetTLDInfo
l TP_ResendEmail
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetDetailsByDomain
Description
Definition
Get transfer order information for a domain using sld.tld.
Usage
Use this command to retrieve status information on one domain name that is in the pro-
cess of transferring.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/TransferStatus.asp?transferorderid=445431
- 1298 -
API Command Categories
On the Transfer Order Detail page, one row of the Domain Name table returns the same
information as one query using the TP_GetDetailsByDomain command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must be in a transfer order that belongs to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
- 1299 -
API Command Categories
Parameter Description
TransferOrderDetail status ID -- a number that indicates the
StatusIDX status of this domain in the transfer process. See Notes.
Indexed X when ResponseType=Text or HTML.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l TransferOrderDetail StatusID is the status of this domain in the transfer process:
l 0=Transfer request created - awaiting fax
l 5=Transferred successfully
ferred
l 22=Canceled - Domain is locked at current registrar
- 1300 -
API Command Categories
Example
The following query requests transfer information for resellerdocs2.net, and requests the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GetDetailsByDomain&uid=resellid&pw=resellpw&
sld=resellerdocs2&tld=net&responsetype=xml
The response confirms that resellerdocs2.net is part of transfer order ID 445413, and
gives current status of that order:
Output
<interface-response>
<TransferOrder>
<orderid>175581269</orderid>
<orderdate>9/27/2010 2:26:09 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175581275</orderid>
<orderdate>9/27/2010 2:46:50 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
- 1301 -
API Command Categories
<TransferOrder>
<orderid>175581278</orderid>
<orderdate>9/27/2010 3:43:14 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175581281</orderid>
<orderdate>9/27/2010 3:57:16 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175581284</orderid>
<orderdate>9/27/2010 3:57:54 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175581341</orderid>
<orderdate>9/27/2010 9:47:10 PM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175585289</orderid>
<orderdate>11/3/2010 7:22:14 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175585292</orderid>
<orderdate>11/3/2010 7:26:00 AM</orderdate>
- 1302 -
API Command Categories
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175587221</orderid>
<orderdate>11/19/2010 9:47:07 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175587224</orderid>
<orderdate>11/19/2010 9:47:40 AM</orderdate>
<statusid>32</statusid>
<statusdesc>Canceled - Invalid EPP/authorization key -
Please contact current registrar to obtain correct
key</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175598255</orderid>
<orderdate>4/5/2011 9:23:37 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175611182</orderid>
<orderdate>8/3/2011 1:15:05 PM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175611185</orderid>
<orderdate>8/3/2011 1:15:33 PM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
- 1303 -
API Command Categories
<orderid>175611188</orderid>
<orderdate>8/3/2011 1:17:35 PM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175611206</orderid>
<orderdate>8/3/2011 1:40:45 PM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175611212</orderid>
<orderdate>8/3/2011 1:45:08 PM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614428</orderid>
<orderdate>9/7/2011 8:03:46 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614431</orderid>
<orderdate>9/7/2011 8:05:15 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614434</orderid>
<orderdate>9/7/2011 9:01:15 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
- 1304 -
API Command Categories
<orderid>175614437</orderid>
<orderdate>9/7/2011 9:02:48 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614443</orderid>
<orderdate>9/7/2011 10:20:20 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614446</orderid>
<orderdate>9/7/2011 10:26:52 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614449</orderid>
<orderdate>9/7/2011 10:49:52 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614452</orderid>
<orderdate>9/7/2011 10:59:21 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614737</orderid>
<orderdate>9/12/2011 3:43:07 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
- 1305 -
API Command Categories
<orderid>175614740</orderid>
<orderdate>9/12/2011 6:05:53 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614743</orderid>
<orderdate>9/12/2011 6:06:14 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614788</orderid>
<orderdate>9/13/2011 1:06:08 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614791</orderid>
<orderdate>9/13/2011 3:44:19 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614794</orderid>
<orderdate>9/13/2011 6:55:03 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614797</orderid>
<orderdate>9/13/2011 7:07:26 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
- 1306 -
API Command Categories
<orderid>175614800</orderid>
<orderdate>9/13/2011 7:09:07 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614803</orderid>
<orderdate>9/13/2011 7:10:44 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175614806</orderid>
<orderdate>9/13/2011 7:11:41 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175615484</orderid>
<orderdate>9/22/2011 2:39:45 AM</orderdate>
<statusid>15</statusid>
<statusdesc>Canceled - cannot obtain domain contacts from
UWhois</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175619870</orderid>
<orderdate>11/6/2011 10:02:01 PM</orderdate>
<statusid>16</statusid>
<statusdesc>Canceled - domain contacts did not respond to
verification e-mail</statusdesc>
</TransferOrder>
<TransferOrder>
<orderid>175619873</orderid>
<orderdate>11/6/2011 10:02:12 PM</orderdate>
<statusid>16</statusid>
<statusdesc>Canceled - domain contacts did not respond to
verification e-mail</statusdesc>
</TransferOrder>
<TransferOrder>
- 1307 -
API Command Categories
<orderid>175619876</orderid>
<orderdate>11/6/2011 10:02:39 PM</orderdate>
<statusid>16</statusid>
<statusdesc>Canceled - domain contacts did not respond to
verification e-mail</statusdesc>
</TransferOrder>
<ordercount>38</ordercount>
<Command>TP_GETDETAILSBYDOMAIN</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+8.00</TimeDifference>
<ExecTime>0.141</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>c3f152ab-e92c-4de5-8193-1898f91a6b-
f9</TrackingKey>
<RequestDateTime>12/12/2011 1:59:03 AM</RequestDateTime>
</interface-response>
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResendEmail
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
- 1308 -
API Command Categories
TP_GetOrder
Description
Definition
Get a list of domains in a single transfer order.
Usage
Use this command to retrieve status information on each item in a transfer order.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/TransferStatus.asp
On the transfer a name page, clicking a link in the Transfer Order ID column calls the
TP_GetOrder command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order ID must be valid.
l The transfer order must have originated from this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1309 -
API Command Categories
- 1310 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTMLor ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
l TransferOrder StatusID:
l 0 Transfer request has been made
l 2 Order canceled
l 3 Order complete
l 4 Processing
l TransferOrderDetail StatusID:
l 0 Transfer request created - awaiting fax
ferred
l 22 Canceled - Domain is locked at current registrar, or is not yet 60 days old
l 27 Canceled by customer
- 1311 -
API Command Categories
Example
The following query requests transfer information for transfer order ID 445413, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GetOrder&uid=resellid&pw=resellpw&
TransferOrderID=445413&responsetype=xml
- 1312 -
API Command Categories
<sld>resellerdocs2</sld>
<tld>net</tld>
<statusid>9</statusid>
<statusdesc>Awaiting auto verification of transfer
request</statusdesc>
<price>8.95</price>
<usecontacts>0</usecontacts>
</transferorderdetail>
<transferorderdetail>
<transferorderdetailid>301771</transferorderdetailid>
<sld>resellerdocs3</sld>
<tld>info</tld>
<statusid>9</statusid>
<statusdesc>Awaiting auto verification of transfer
request</statusdesc>
<price>8.95</price>
<usecontacts>0</usecontacts>
</transferorderdetail>
<transferorderdetailcount>2</transferorderdetailcount>
</transferorder>
<Command>TP_GETORDER</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
- 1313 -
API Command Categories
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetOrderDetail
Description
Definition
Get information for a single domain on a transfer order.
Usage
Use this command to retrieve a long list of information on a single domain that is in the
process of transferring.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order detail ID must belong to a transfer order created under this
account.
l Input parameters
- 1314 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1315 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l TransferOrderDetail StatusID and StatusDesc:
l 0 Transfer request created - awaiting fax
ferred
l 22 Canceled - Domain is locked at current registrar, or is not yet 60 days old
l 27 Canceled by customer
- 1316 -
API Command Categories
Example
The following query requests information on transfer order detail (one item in a transfer
order) ID 301770, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GetOrderDetail&uid=resellid&pw=resellpw&
TransferOrderDetailID=301770&responsetype=xml
The response indicates that tranfer order detail ID 301770 is for the transfer of domain
resellerdocs2.net, and provides details of the order:
Output
- 1317 -
API Command Categories
<BillingPartyID>{BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629}
</BillingPartyID>
<BillingAddress1>111 Main Street</BillingAddress1>
<BillingAddress2 />
<BillingCity>Hometown</BillingCity>
<BillingCountry>US</BillingCountry>
<BillingE-
mailAddress>john.doe@resellerdocs.com</BillingEmailAddress>
<BillingFax>+1.5555555556</BillingFax>
<BillingFirstName>John</BillingFirstName>
<BillingJobTitle>President</BillingJobTitle>
<BillingLastName>Doe</BillingLastName>
<BillingOrganizationName>Reseller Documents Inc.</BillingOr-
ganizationName>
<BillingPhone>+1.5555555555</BillingPhone>
<BillingPostalCode>99999</BillingPostalCode>
<BillingStateProvince>WA</BillingStateProvince>
<BillingStateProvinceChoice>S</BillingStateProvinceChoice>
<BillingFullCountry>United States</BillingFullCountry>
<UseRegInfoAbove>True</UseRegInfoAbove>
<auxID />
<regID />
</Billing>
</contacts>
</transferorderdetail>
<Command>TP_GETORDERDETAIL</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
- 1318 -
API Command Categories
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResendEmail
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetOrderReview
Description
Definition
Retrieve information on a transfer order.
Usage
Use this command to retrieve information on a transfer order a request originated by
you to transfer a name into your account.
This command differs from the TP_GetOrderDetail command in that TP_GetOrderDetail
retrieves a larger set of information, including the status of the order and detailed contact
information.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order must have originated from this account.
Input parameters
Build the query string using this syntax:
- 1319 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
Lock Registrar lock setting that was specified in the transfer order
EPP Key associated with this domain. Some TLDs require this
AuthInfo
code to authorize a transfer
- 1320 -
API Command Categories
Parameter Description
TransferOrderDetailCount Number of domain names in this order
Yes indicates we have not yet received the EPP key (author-
ization code) for at least one domain in this order. If you use the
TP_CreateOrder command to begin an order, then allow cus-
AuthInfoStillRequired
tomers to supply authorization codes on a separate page
before using TP_SubmitOrder, you would use this value to
determine whether to display the auth code page.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests details on transfer order 465681 and sends the response
in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GetOrderReview&uid=resellid&
pw=resellpw&TransferOrderID=175623473&OrderType=Transfer
&responsetype=xml
- 1321 -
API Command Categories
Output
- 1322 -
API Command Categories
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetOrdersByDomain
Description
Definition
Retrieve transfer information for a domain name.
Usage
Use this command to list a history and status of transfer orders for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1323 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
- 1324 -
API Command Categories
Parameter Description
6 Order complete
7 Order canceled.
Indexed X when ResponseType=Text or HTML.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests transfer order information for domain name reseller-
docs2.net, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GetOrdersByDomain&uid=resellid&pw=resellpw&
sld=resellerdocs2&tld=net&responsetype=xml
- 1325 -
API Command Categories
<TransferOrder>
<transferorderid>445413</transferorderid>
<loginid>resellid</loginid>
<orderdate>7/29/2002 5:19:29 PM</orderdate>
<orderstatus>Processing</orderstatus>
<statusid>4</statusid>
</TransferOrder>
<ordercount>1</ordercount>
<Command>TP_GETORDERSBYDOMAIN</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetOrderStatuses
Description
Definition
- 1326 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand& uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1327 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l The OrderIDs returned can be used to call functions to view or update transfer
orders.
Example
The following query requests the status of all transfer orders by account resellid, and
requests the response in XML format:
Query
- 1328 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=TP_GetOrderStatuses&uid=resellid&
pw=resellpw&responsetype=xml
The response lists the status of every transfer order placed by resellid. The complete out-
put for transfer order ID 445413 is included here; details of other orders are abridged:
Output
- 1329 -
API Command Categories
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_GetTLDInfo
Description
Definition
Retrieve a list of information required for transferring domains, for each TLD.
Usage
Use this command to list the information that each Registry requires when domains are
transferred.
A typical use for this command is administrative. When your customers submit transfer
requests, you can use this command to guide you in what is required for processing the
orders.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1330 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command =nameofcommand& uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
- 1331 -
API Command Categories
Parameter Description
Is this TLD transferable. Indexed X when ResponseType=Text
TransferableX
or HTML.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of TLDs that satisfy QueryFlag=6-TLDs that are both
lockable and transferable-and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_GETTLDINFO&uid=resellid&pw=resellpw&
QueryFlag=6&ResponseType=XML
- 1332 -
API Command Categories
In the response, a list of TLDs and their characteristics, and an ErrCount value 0, confirm
that the query was successful:
Output
<interface-response>
<tldtable>
<tld>
<TLDID>0</TLDID>
<TLD>com</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>1</TLDID>
<TLD>net</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>2</TLDID>
<TLD>org</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>3</TLDID>
<TLD>cc</TLD>
- 1333 -
API Command Categories
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>4</TLDID>
<TLD>tv</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>5</TLDID>
<TLD>info</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>6</TLDID>
<TLD>biz</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
- 1334 -
API Command Categories
<TLDID>10</TLDID>
<TLD>us</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>15</TLDID>
<TLD>name</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>23</TLDID>
<TLD>ca</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>43</TLDID>
<TLD>br.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
- 1335 -
API Command Categories
</tld>
<tld>
<TLDID>44</TLDID>
<TLD>cn.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>45</TLDID>
<TLD>eu.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>46</TLDID>
<TLD>uk.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>47</TLDID>
<TLD>uk.net</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
- 1336 -
API Command Categories
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>48</TLDID>
<TLD>us.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>49</TLDID>
<TLD>uy.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>50</TLDID>
<TLD>hu.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>51</TLDID>
<TLD>no.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
- 1337 -
API Command Categories
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>52</TLDID>
<TLD>qc.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>53</TLDID>
<TLD>ru.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>54</TLDID>
<TLD>sa.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>55</TLDID>
<TLD>se.com</TLD>
<Protocol>EPP</Protocol>
- 1338 -
API Command Categories
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>56</TLDID>
<TLD>se.net</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>57</TLDID>
<TLD>za.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>58</TLDID>
<TLD>de.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>85</TLDID>
- 1339 -
API Command Categories
<TLD>mobi</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>86</TLDID>
<TLD>web.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>False</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>87</TLDID>
<TLD>jpn.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>False</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>91</TLDID>
<TLD>la</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
- 1340 -
API Command Categories
<tld>
<TLDID>92</TLDID>
<TLD>asia</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>93</TLDID>
<TLD>me</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>95</TLDID>
<TLD>abc</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>96</TLDID>
<TLD>xyz</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
- 1341 -
API Command Categories
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>97</TLDID>
<TLD>que</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>98</TLDID>
<TLD>ram</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>99</TLDID>
<TLD>woz</TLD>
<Protocol>RRP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>100</TLDID>
<TLD>tel</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
- 1342 -
API Command Categories
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>101</TLDID>
<TLD>pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>102</TLDID>
<TLD>aaa.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>103</TLDID>
<TLD>aca.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>105</TLDID>
<TLD>acct.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
- 1343 -
API Command Categories
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>106</TLDID>
<TLD>eng.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>107</TLDID>
<TLD>avocat.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>108</TLDID>
<TLD>bar.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>110</TLDID>
<TLD>jur.pro</TLD>
- 1344 -
API Command Categories
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>111</TLDID>
<TLD>recht.pro</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>False</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>200</TLDID>
<TLD>co</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>201</TLDID>
<TLD>com.co</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
- 1345 -
API Command Categories
<TLDID>202</TLDID>
<TLD>nom.co</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>203</TLDID>
<TLD>net.co</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>205</TLDID>
<TLD>pl</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>False</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>245</TLDID>
<TLD>com.pl</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>False</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>False</TransByFax>
- 1346 -
API Command Categories
</tld>
<tld>
<TLDID>246</TLDID>
<TLD>info.pl</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>False</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>247</TLDID>
<TLD>net.pl</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>False</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>248</TLDID>
<TLD>org.pl</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>False</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>False</TransByFax>
</tld>
<tld>
<TLDID>253</TLDID>
<TLD>gr.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
- 1347 -
API Command Categories
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>254</TLDID>
<TLD>us.org</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>256</TLDID>
<TLD>com.de</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>257</TLDID>
<TLD>ae.org</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>258</TLDID>
<TLD>ar.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
- 1348 -
API Command Categories
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>259</TLDID>
<TLD>gb.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>260</TLDID>
<TLD>gb.net</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
<tld>
<TLDID>261</TLDID>
<TLD>kr.com</TLD>
<Protocol>EPP</Protocol>
<AbleToLock>True</AbleToLock>
<RealTime>True</RealTime>
<Transferable>True</Transferable>
<HasAuthInfo>True</HasAuthInfo>
<TransByAutoVeri>True</TransByAutoVeri>
<TransByFax>True</TransByFax>
</tld>
</tldtable>
<tldcount>64</tldcount>
<Command>TP_GETTLDINFO</Command>
<Language>eng</Language>
- 1349 -
API Command Categories
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.875</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 3:35:09 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l AddToCart
l TP_CancelOrder
l TP_CreateOrder
l TP_GetOrderStatuses
l TP_SubmitOrder
l TP_UpdateOrderDetail
TP_ResendEmail
Description
Definition
Resend the Domain Transfer Request authorization email. This is the email we send to
the WhoIs contact on record at the Registry, requesting their authorization to transfer the
domain name into the account specified in this query string.
Usage
Use this command to resend the Domain Transfer Request email for a transfer. You
would typically use this command when the owner who is losing the domain updates
their email address after we have sent an initial authorization email.
- 1350 -
API Command Categories
This command can only be used between the time we send an initial Domain Transfer
Request email, and the time we receive a response.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must be one that is transferring into this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command =nameofcommand& uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
- 1351 -
API Command Categories
Notes
l If you are transferring a domain name between two of your own accounts at dif-
ferent registrars, you can reduce delays by updating your email address in the los-
ing account before you submit a transfer order.
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query resends confirmation emails for the transfer of resellerdocs3.info,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_RESENDEMAIL&uid=resellid&pw=resellpw&
SLD=resellerdocs3&tld=info&responsetype=xml
In the response, a Success value of True indicates that the query was successful:
Output
- 1352 -
API Command Categories
Related commands
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrderDetail
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
TP_ResubmitLocked
Description
Definition
Resubmit a request for a previously locked domain name.
Usage
- 1353 -
API Command Categories
Use this command after you have previously submitted a transfer request, received an
error message saying the domain was locked, and have had the registrant of the domain
unlock it. This command may also be used to resubmit a transfer that was rejected
because the domain was registered less than 60 days ago.
Availability
All resellers have access to this command.
Implementation on eNom.com
On the Transfer order detail page, the Resubmit locked domain link (when it is present)
calls the TP_ResubmitLocked command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order detail ID must be valid.
l The transfer order detail ID must belong to a domain that previously failed to trans-
fer because it was locked.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command =nameofcommand& uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
- 1354 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
Previously, account resellid had requested that a domain be transferred into this
account, and received an e-mail stating that the transfer could not complete because the
domain was locked. The owner of account resellid contacted the owner of the domain
and had the lock removed. The following query resubmits the transfer request, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_ResubmitLocked&uid=resellid&pw=resellpw&
TransferOrderDetailID=607291&responsetype=xml
The Success=True parameter value in the response, and the new TransferOrderID, con-
firm a successful request:
Output
- 1355 -
API Command Categories
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResendEmail
l TP_SubmitOrder
l TP_UpdateOrderDetail
l UpdatePushList
TP_SubmitOrder
Description
Definition
Submit a preconfigured transfer order.
Usage
- 1356 -
API Command Categories
Use this command to submit a transfer order that has been created and configured using
the TP_CreateOrder command, but not submitted. Domain names in this status appear
on the Pending orders page. When you pass credit card information with this command,
you must use the secure HTTPS protocol.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/TransferNew.asp
Enter a domain name and click Next.
On the Pending orders page, the submit button calls the TP_SubmitOrder command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l To use our credit card processing, this must be an ETP reseller account.
l The TransferOrderID must identify an order that has been successfully created but
not submitted.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1357 -
API Command Categories
Required our CC
CCName Cardholders name 60
processing
Required our CC
CreditCardNumber Credit card number 128
processing
Required our CC
CVV2 Credit card verification code 4
processing
Required our CC
CCName Cardholders name 60
processing
Required our CC
CCAddress Credit card billing street address 60
processing
- 1358 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
Transfer order 445440 was created with command TP_CreateOrder, with parameter
PreConfig=1. With that parameter value, the order was created and atransfer order ID
was assigned, but the order was not submitted instantly. The following query uses the
transfer order ID to submit the preconfigured order, and sends the response in XML
format:
- 1359 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=TP_SubmitOrder&uid=resellid&pw=resellpw&
TransferOrderID=445440&responsetype=xml
In the response, the error count of 0 indicates that the order was submitted successfully:
Output
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_GetTLDInfo
l TP_ResendEmail
l TP_ResubmitLocked
l TP_UpdateOrderDetail
l UpdatePushList
- 1360 -
API Command Categories
TP_UpdateOrderDetail
Description
Definition
Update a preconfigured transfer order before submitting the order.
Usage
Use this command to configure registrar lock, auto-renew, domain password, or contact
information for a domain name that is in the process of being transferred to eNom.
This command is typically used after an order has been created using the TP_
CreateOrder command with the parameter PreConfig=1. Once the transfer order has
been configured using this command, the next step is typically to use the TP_Sub-
mitOrder command, which causes the transfer order to be processed.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/TransferNew.asp
Enter a domain name and click next.
On the Pending orders page, click the domain name.
In the Editing transfer order for domain name box, the check boxes set the parameter val-
ues for the TP_UpdateOrderDetail command, and the next button calls the command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The transfer order detail ID must be valid and must be part of an order created
under this account.
l The transfer order must be in a StatusID of 5 (Order not submitted).
- 1361 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Optional;
RegistrantAddress1 Required Fax Registrant address 60
orders
Optional;
RegistrantCity Required Fax Registrant city 60
orders
Optional;
RegistrantCountry Required Fax Registrant country 60
orders
Optional;
Required Fax
orders and for
RegistrantEmailAddress Registrant email address 128
.org names for
which you are
supplying new
- 1362 -
API Command Categories
Optional;
RegistrantFirstName Required Fax Registrant first name 60
orders
Optional;
RegistrantLastName Required Fax Registrant last name 60
orders
Optional;
RegistrantOrganizationName Required Fax Registrant organization 60
orders
- 1363 -
API Command Categories
- 1364 -
API Command Categories
Parameter Description
AuxBilling* Auxilliary Billing contact data
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed.
l The parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
l To update Technical or Auxilliary Billing contacts submit the contact data by repla-
cing Registrant* param names with Tech* or AuxBilling* param names.
Example
The following query requests that for transfer order detail ID 301770, the registrar lock
and automatic renew options both be set to On. It also instructs that contact information
should remain unchanged, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TP_UpdateOrderDetail&uid=resellid&pw=resellpw&
TransferOrderDetailID=301770&Lock=On&Renew=On&
RegistrantUseContact=none&TechUseContact=none&
AuxBillingUseContact=none&responsetype=xml
- 1365 -
API Command Categories
The response indicates the successful setting of the registrar lock and automatic renew
options:
Output
- 1366 -
API Command Categories
<AuxBilling>None</AuxBilling>
<Tech>None</Tech>
<Admin>None</Admin>
<Billing>
<BillingPartyID>{BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629}
</BillingPartyID>
<BillingAddress1>111 Main Street</BillingAddress1>
<BillingAddress2 />
<BillingCity>Hometown</BillingCity>
<BillingCountry>US</BillingCountry>
<BillingE-
mailAddress>john.doe@resellerdocs.com</BillingEmailAddress>
<BillingFax>555-555-5556</BillingFax>
<BillingFirstName>John</BillingFirstName>
<BillingJobTitle>President</BillingJobTitle>
<BillingLastName>Doe</BillingLastName>
<BillingOrganizationName>Reseller Documents Inc.</BillingOr-
ganizationName>
<BillingPhone>555-555-5555</BillingPhone>
<BillingPostalCode>99999</BillingPostalCode>
<BillingStateProvince>WA</BillingStateProvince>
<BillingStateProvinceChoice>S</BillingStateProvinceChoice>
<BillingFullCountry>United States</BillingFullCountry>
<UseBelowAuxInfo>True</UseBelowAuxInfo>
<auxID />
<regID>{BB4A2DE1-6485-45CB-A4FC-EE39BA0C1629}</regID>
</Billing>
</contacts>
</transferorderdetail>
<success>True</success>
<Command>TP_UPDATEORDERDETAIL</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
- 1367 -
API Command Categories
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrderReview
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_GetTLDInfo
l TP_ResubmitLocked
l TP_SubmitOrder
l UpdatePushList
TS_AutoRenew
Description
Definition
Set the Auto Renew flag for a Trust Seal subscription.
Usage
Use this command to set the Auto Renew flag for a Trust Seal subscription.
In the eNom web site, we only display the Auto Renew setting for subscriptions in status
Service Active, but our API allows you to set the Auto Renew flag at any time.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-seals/manage.aspx
For any Trust Seal subscription with status Service Active, click the link in the Domain
column. The current Auto Renew setting displays, and the Save Changes button
launches the TS_AutoRenew command.
- 1368 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Trust Seal subscription must belong to this login ID.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Parameter Description
Identification number for the Trust Seal subscription being set
TSID
with this query string
- 1369 -
API Command Categories
Parameter Description
New setting for the Auto Renew flag for this Trust Seal sub-
AutoRenew
scription
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query turns off the Auto Renew flag for a Trust Seal subscription, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TS_AutoRenew&uid=resellid&pw=resellpw&TSID=167
&AutoRenew=False&responsetype=xml
In the response, a Success value True indicates that the query was successful:
Output
<interface-response>
<TSID>167</TSID>
- 1370 -
API Command Categories
<AutoRenew>False</AutoRenew>
<Success>True</Success>
<Command>TS_AUTORENEW</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.297</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>94cb5b25-986c-4737-8438-531b-
c29e6b58</TrackingKey>
<RequestDateTime>12/12/2011 4:06:12 AM</RequestDateTime>
</interface-response>
Related commands
l TS_Configure
l TS_GetAccountDetail
l TS_GetAccounts
TS_Configure
Description
Definition
Configure a VeriSign Trust Seal account.
Usage
Use this command to configure a Verisign Trust Seal subscription after initial purchase.
When the user submits this configuration, VeriSign performs two checks before issuing a
Trust Seal: an identity verification, then an initial malware scan.
Availability
- 1371 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The VeriSign Trust Seal account must belong to this login ID.
l VeriSign will only allow one Trust Seal to be associated with a domain.
l Trust Seal is available for any domain name; the domain does not need to be
registered or hosted with us.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1372 -
API Command Categories
- 1373 -
API Command Categories
- 1374 -
API Command Categories
- 1375 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
- 1376 -
API Command Categories
Example
The following query configures a Trust Seal subscription and submits it to VeriSign for
verification, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
&command=TS_Con-
figure&UID=resellid&PW=resellpw&ProdType=185&
TSID=167&Domain=resellerdocs.com&UserType=Organization&
SubmitApproval=true&AdminOrgName=Acme&
AdminJobTitle=President&AdminFName=John&AdminLName=Doe&
AdminAddress1=100+Main&AdminCity=Townsville&
AdminStateProvinceChoice=S&AdminStateProvince=ME&
AdminPostalCode=10001&AdminCountry=US&
AdminPhone=%2B207.5555556&
AdminEmailAddress=john.doe@example.com&
TechOrgName=Acme&TechJobTitle=WebMaster&
TechFName=Jake&TechLName=Doe&
TechAddress1=100+Main&TechCity=Townsville&
TechStateProvinceChoice=S&TechStateProvince=ME&
TechPostalCode=10001&TechCountry=US&
TechPhone=%2B207.5555556&
TechEmailAddress=jake.doe@example.com&ResponseType=xml
In the response, a Status value true indicates that the query was successful:
Output
<interface-response>
<TSID>167</TSID>
<Domain>resellerdocs.com</Domain>
<UserType>organization</UserType>
<Status>True</Status>
<Detail>Missing or Invalid Field: PartnerOrderID</Detail>
<Command>TS_CONFIGURE</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
- 1377 -
API Command Categories
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>2.078</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>008894e1-011c-4744-9c41-3ac6119f671b</Track-
ingKey>
<RequestDateTime>12/12/2011 4:08:45 AM</RequestDateTime>
</interface-response>
Related commands
l TS_AutoRenew
l TS_GetAccountDetail
l TS_GetAccounts
TS_GetAccountDetail
Description
Definition
Retrieve detailed information for one VeriSign Trust Seal account.
Usage
Use this command to retrieve information for one Verisign Trust Seal subscription.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/web-site-seals/manage.aspx
When you click a link in the Domains column, TS_GetAccountDetail populates the detail
page.
- 1378 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Trust Seal account must belong to this login ID.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1379 -
API Command Categories
Parameter Description
Expiration Expiration date of this Trust Seal
- 1380 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query retrieves details for a Trust Seal subscription and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=TS_GetAccountDetail&uid=resellid&pw=resellpw&
TSID=167&responsetype=xml
In the response, a Success status True, and details for this Trust Seal subscription, indic-
ate that the query was successful:
Output
<interface-response>
<TSID>167</TSID>
<Domain>resellerdocs.com</Domain>
<UserType>Organization</UserType>
<ProdDesc>Symantec Safe Site</ProdDesc>
<Status>Pending Verification</Status>
<Expiration>7/8/2013 2:07:48 PM</Expiration>
<AutoRenew>False</AutoRenew>
<BillingCycle>Yearly</BillingCycle>
<Price>720.0000</Price>
- 1381 -
API Command Categories
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID>0</ChildTrustSealID>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<OriginalFulfillmentDate/>
<TrustScript/>
<Success>True</Success>
<Message/>
<OrderState>Order is ready to be vetted. Orders can be in
this state for
as much as several days.</OrderState>
<Contacts>
<Admin>
<PartyID>f1e76208-ba24-e111-a3f0-005056bc7747</PartyID>
<Organization>Acme</Organization>
<JobTitle>President</JobTitle>
<FirstName>John</FirstName>
<LastName>Doe</LastName>
<Address1>100 Main</Address1>
<Address2></Address2>
<City>Townsville</City>
<StateProvinceChoice>S</StateProvinceChoice>
<StateProvince>ME</StateProvince>
<PostalCode>10001</PostalCode>
<Country>US</Country>
<Phone>+207.5555556</Phone>
<Fax></Fax>
<EmailAddress>john.doe@example.com</EmailAddress>
</Admin>
<Technical>
<PartyID>f2e76208-ba24-e111-a3f0-005056bc7747</PartyID>
<Organization>Acme</Organization>
<JobTitle>WebMaster</JobTitle>
<FirstName>Jake</FirstName>
<LastName>Doe</LastName>
<Address1>100 Main</Address1>
<Address2></Address2>
<City>Townsville</City>
<StateProvinceChoice>S</StateProvinceChoice>
<StateProvince>ME</StateProvince>
<PostalCode>10001</PostalCode>
<Country>US</Country>
<Phone>+207.5555556</Phone>
- 1382 -
API Command Categories
<Fax></Fax>
<EmailAddress>jake.doe@example.com</EmailAddress>
</Technical>
</Contacts>
<Command>TS_GETACCOUNTDETAIL</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.969</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>d8e20e2b-9303-471f-a492-294cde686c76</Track-
ingKey>
<RequestDateTime>12/12/2011 4:10:14 AM</RequestDateTime>
</interface-response>
Related commands
l TS_AutoRenew
l TS_Configure
l TS_GetAccounts
TS_GetAccounts
Description
Definition
Retrieve a list of Verisign Trust Seal subscriptions for this login ID.
Usage
Use this command to retrieve a list of Verisign Trust Seal subscriptions for this login ID.
Availability
- 1383 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1384 -
API Command Categories
Parameter Description
TSID Identification number for this VeriSign Trust Seal subscription
Identification number for the order in which this Trust Seal sub-
OrderID
scription was purchased
- 1385 -
API Command Categories
Parameter Description
ProdType In the summary for this list, the product type filter for the list
Status In the summary for this list, the status filter for the list
In the overall sorted list, the start position of the Trust Seal sub-
StartPosition
scriptions included in this response
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query retrieves the VeriSign Trust Seal subscriptions associated with a
login ID, and sends the response in XML format:
Query
- 1386 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=TS_GetAccounts&uid=resellid&pw=resellpw&
responsetype=xml
In the response, the presence of a Status node and an ErrCount value of 0 indicate that
the query was successful:
Output
<interface-response>
<TrustSealAccounts>
<Account>
<TSID>169</TSID>
<Domain></Domain>
<ProdType>185</ProdType>
<OrderID>157555347</OrderID>
<Status>Awaiting Configuration</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2011 3:17 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>169</OriginalTrustSealID>
</Account>
<Account>
<TSID>170</TSID>
<Domain></Domain>
<ProdType>185</ProdType>
<OrderID>157555350</OrderID>
<Status>Awaiting Configuration</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2013 3:47 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>170</OriginalTrustSealID>
</Account>
<Account>
<TSID>171</TSID>
<Domain></Domain>
- 1387 -
API Command Categories
<ProdType>185</ProdType>
<OrderID>157555350</OrderID>
<Status>Awaiting Configuration</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2013 3:47 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>171</OriginalTrustSealID>
</Account>
<Account>
<TSID>172</TSID>
<Domain></Domain>
<ProdType>185</ProdType>
<OrderID>157555350</OrderID>
<Status>Awaiting Configuration</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2013 3:47 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>172</OriginalTrustSealID>
</Account>
<Account>
<TSID>141</TSID>
<Domain>09erfedrtik.com</Domain>
<ProdType>185</ProdType>
<OrderID>157550839</OrderID>
<Status>Pending Verification</Status>
<AutoRenew>True</AutoRenew>
<Expiration>6/28/2011 5:10 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>141</OriginalTrustSealID>
</Account>
<Account>
<TSID>165</TSID>
<Domain>rameshwar.com</Domain>
- 1388 -
API Command Categories
<ProdType>185</ProdType>
<OrderID>157555327</OrderID>
<Status>Service Expired</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2011 12:39 PM</Expiration>
<RenewalStatus>Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate>7/9/2010 12:00 AM</Ori-
ginalFulfillmentDate>
<OriginalTrustSealID>165</OriginalTrustSealID>
</Account>
<Account>
<TSID>166</TSID>
<Domain>ranosys.com</Domain>
<ProdType>185</ProdType>
<OrderID>157555330</OrderID>
<Status>Service Expired</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2011 1:11 PM</Expiration>
<RenewalStatus>Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate>7/9/2010 12:00 AM</Ori-
ginalFulfillmentDate>
<OriginalTrustSealID>166</OriginalTrustSealID>
</Account>
<Account>
<TSID>149</TSID>
<Domain>ranosys.com</Domain>
<ProdType>185</ProdType>
<OrderID>157553834</OrderID>
<Status>Service Canceled</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/2/2011 3:09 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>149</OriginalTrustSealID>
</Account>
<Account>
- 1389 -
API Command Categories
<TSID>167</TSID>
<Domain>resellerdocs.com</Domain>
<ProdType>185</ProdType>
<OrderID>157555337</OrderID>
<Status>Pending Verification</Status>
<AutoRenew>False</AutoRenew>
<Expiration>7/8/2013 2:07 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>167</OriginalTrustSealID>
</Account>
<Account>
<TSID>168</TSID>
<Domain>resellerdocs.com</Domain>
<ProdType>185</ProdType>
<OrderID>157555345</OrderID>
<Status>Awaiting Configuration</Status>
<AutoRenew>True</AutoRenew>
<Expiration>7/8/2013 2:35 PM</Expiration>
<RenewalStatus>Not Available for Renewal</RenewalStatus>
<ParentTrustSealID>0</ParentTrustSealID>
<ChildTrustSealID></ChildTrustSealID>
<OriginalFulfillmentDate></OriginalFulfillmentDate>
<OriginalTrustSealID>168</OriginalTrustSealID>
</Account>
</TrustSealAccounts>
<ProdType>185</ProdType>
<Status>all</Status>
<StartPosition>1</StartPosition>
<RecordsToReturn>25</RecordsToReturn>
<Sortby>domain</Sortby>
<Ascending>1</Ascending>
<TotalAccounts>10</TotalAccounts>
<Command>TS_GETACCOUNTS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>sjl21wresellt01</Server>
- 1390 -
API Command Categories
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.766</ExecTime>
<Done>true</Done>
<debug/>
<TrackingKey>22354164-6d5c-41d8-9cb0-ec55d-
b0889eb</TrackingKey>
<RequestDateTime>12/12/2011 4:11:57 AM</RequestDateTime>
</interface-response>
Related commands
l TS_AutoRenew
l TS_Configure
l TS_GetAccountDetail
UpdateAccountInfo
Description
Definition
Update a variety of account information, for this account or a retail subaccount.
Usage
Use this command to update Billing contact information for this account.
Use this command to change the password or authorization question for a retail sub-
account.
Use this command to update credit card information for this account or a retail sub-
account.
When you pass credit card information with this command, you must use the secure
HTTPS protocol.
To add funds to a reseller account, use the RefillAccount command.
Availability
All resellers have access to this command.
- 1391 -
API Command Categories
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/EditContact.asp?
On the my info page, the save changes button calls the UpdateAccountInfo command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The account identified in the UID parameter must be a reseller account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Max
Parameter Status Description
Size
UID Required Account login ID 20
- 1392 -
API Command Categories
Max
Parameter Status Description
Size
identity verification. Permitted val-
ues are:
smaiden mothers maiden name
sbirth city of birth
ssocial last 4 digits of SSN
shigh high school
fteach favorite teacher
fvspot favorite vacation spot
fpet favorite pet
fmovie favorite movie
fbook favorite book
Required for us to
RegistrantOrganizationName apply the Web site Registrant organization 60
URL
Required if Regis-
RegistrantJobTitle trantOrganization Registrant job title 60
Name is supplied
- 1393 -
API Command Categories
Max
Parameter Status Description
Size
RegistrantStateProvince Required Registrant state or province 60
Required if updating
CCName credit card information Cardholder's name 60
of a retail account
Required if updating
CreditCardNumber credit card information Customer's credit card number 128
of a retail account
Required if updating
CreditCardExpMonth credit card information Credit card expiration month 2
of a retail account
Required if updating
CreditCardExpYear credit card information Credit card expiration year 4
of a retail account
Required if updating
CVV2 Credit card verification code 4
credit card information
- 1394 -
API Command Categories
Max
Parameter Status Description
Size
of a retail account
Required if updating
CCAddress credit card information Credit card billing address 60
of a retail account
Optional if updating
CCCity credit card information Credit card billing city 60
of a retail account
Optional if updating
CCStateProvince credit card information Credit card billing state or province 40
of a retail account
Required if updating
CCZip credit card information Credit card billing postal code 15
of a retail account
Required if updating
CCCountry credit card information Credit card billing country 60
of a retail account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1395 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query updates account information: password, authorization question, or
contact information. The query requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UpdateAccountInfo&uid=resellid&pw=resellpw&
NewUID=resellid2&NewPW=resellpw2&ConfirmNewPW=resellpw2&
AuthQuestionType=smaiden&AuthQuestionAnswer=Jones&
RegistrantAddress1=111+Main+St.&RegistrantCity=Hometown&
RegistrantCountry=United+States&
RegistrantEmailAddress=john.doe@resellerdocs.com&
RegistrantFax=+1.5555555556&RegistrantFirstName=John&
RegistrantLastName=Doe&RegistrantJobTitle=President&
RegistrantOrganizationName=Reseller+Documents+Inc.&
RegistrantPhone=+1.5555555555&RegistrantPostalCode=99999&
RegistrantStateProvince=WA&RegistrantStateProvinceChoice=S&
RegistrantNexus=United+States&
RegistrantPurpose=&responsetype=xml
<interface-response>
<OrganizationName>Reseller Documents Inc.</Or-
ganizationName>
<Fname>John</Fname>
<Lname>Doe</Lname>
<JobTitle>President</JobTitle>
<Address1>111 Main St.</Address1>
<Address2/>
<City>Hometown</City>
<StateProvince>WA</StateProvince>
<StateProvinceChoice>S</StateProvinceChoice>
<PostalCode>99999</PostalCode>
- 1396 -
API Command Categories
<Country>US</Country>
<Phone>+1.5555555555</Phone>
<PhoneExt/>
<Fax>+1.5555555556</Fax>
<EmailAddress>john.doe@resellerdocs.com</EmailAddress>
<EmailAddress_Contact/>
<EmailInfo/>
<GetCustomerPaymentInfo>
<CCType/>
<CCName/>
<CCNumber/>
<CCMonth/>
<CCYear/>
<CCAddress/>
<CCCity/>
<CCStateProvince/>
<CCZip/>
<CCCountry/>
<CCPhone/>
</GetCustomerPaymentInfo>
<GetAccountInfo>
<Reseller>True</Reseller>
<UserID>resellid2</UserID>
<Password>resellpw2</Password>
<AuthQuestionType>smaiden</AuthQuestionType>
<AuthQuestionAnswer>Jones</AuthQuestionAnswer>
</GetAccountInfo>
<StatusEditContact>Fail</StatusEditContact>
<Command>UPDATEACCOUNTINFO</Command>
<Language>eng</Language>
<ErrCount>1</ErrCount>
<errors>
<Err1>Only retail subaccounts can be modified by the parent
account.</Err1>
</errors>
<ResponseCount>1</ResponseCount>
<responses>
<response>
<ResponseNumber>313157</ResponseNumber>
<ResponseString>Validation error; unauthorized; sub account
(s)</ResponseString>
</response>
- 1397 -
API Command Categories
</responses>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site/>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.641</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 4:13:13 AM</RequestDateTime>
<debug></debug>
</interface-response>
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l UpdateCusPreferences
UpdateAccountPricing
Description
Definition
Set wholesale prices for a subaccount.
Usage
- 1398 -
API Command Categories
Use this command to set the wholesale prices that one subaccount pays you for each
product.
To set retail prices for consumers who buy directly from this account, use PE_SetPricing.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/resellers/subaccount-list.asp
Click any subaccounts LoginID to see the wholesale prices you charge them; the values
can be reset with UpdateAccountPricing.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The subaccount named with LoginID or Account parameters must be a subaccount
of the account named in the uid and pw parameters.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1399 -
API Command Categories
Certificate-Comodo-
Optional Essential certificate, in DD.cc format 5000.00
Essential
- 1400 -
API Command Categories
- 1401 -
API Command Categories
- 1402 -
API Command Categories
- 1403 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query sets prices for several products. It requests the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
uid=resellid&pw=resellpw&Account=154-dz-5567&
AcctType=reseller&command=UPDATEACCOUNTPRICING&
comprice=14&comrenew=15&comtransfer=16&pop3=29.95
&dotnamebundle=20.95&responsetype=xml
- 1404 -
API Command Categories
Related commands
l PE_GetCustomerPricing
l PE_GetDomainPricing
l PE_GetResellerPrice
l PE_GetRetailPrice
l PE_GetRetailPricing
l PE_GetRocketPrice
l PE_SetPricing
l SetResellerServicesPricing
l SetResellerTLDPricing
l WSC_GetPricing
- 1405 -
API Command Categories
UpdateCart
Description
Definition
Update items in the shopping cart.
Usage
Use this command to activate or deactivate a shopping cart item or to change its quant-
ity.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/Cart.asp
On the cart page, changing an item from OldItemStatus=A (active) to ItemStatus=I (inact-
ive) clears the check box in the select column.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The item must be in the customers shopping cart.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1406 -
API Command Categories
- 1407 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0, the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise, process the
returned parameters as defined above.
Example
The following query requests that item 365690 be moved from active (A) to inactive (I)
status, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=updatecart&uid=resellid&pw=resellpw&ItemID1=365690&
ItemStatus1=on&ItemQty1=1&Renew1=1&ResponseType=xml
In the response, an ErrCount value 0 indicates that the query was successful:
Output
Related commands
l AddBulkDomains
l AddToCart
l DeleteFromCart
- 1408 -
API Command Categories
l GetCartContent
l InsertNewOrder
l PurchasePreview
UpdateCusPreferences
Description
Definition
Update the customer preference settings for an account.
Usage
Use this command to update account-level settings that are applied to all domain names
you register.
For most settings, if no value is supplied for an individual setting, this command reverts
that setting to its default value, with two exceptions:
For host records, the UseParentDefault parameter allows you to choose between per-
sisting current host records, and setting new host records.
Name servers are always persisted by default, unless new name servers are specified in
the query string.
You can use the GetCusPreferences command to retrieve the current settings for an
account, and to supply the current values for the UpdateCusPreferences query string.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp
On the my enom > settings page, the UpdateCusPreferences command sets any
changes that a user enters in the Default Domain Options section.
Constraints
The query must meet the following requirements:
- 1409 -
API Command Categories
Input parameters
Build the query string using this syntax:
Query
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
DefIDProtectRenew=on automatically
Optional; default is
DefIDProtectRenew renews ID Protect before it expires. Per- 3
off
mitted values are on and off
DefWBLRenew=on automatically
Optional; default is
DefWBLRenew renews Business Listing before it 3
off
expires. Permitted values are on and off
- 1410 -
API Command Categories
- 1411 -
API Command Categories
- 1412 -
API Command Categories
Show menus.
Optional; default is ShowPopUps=0 hides menus.
ShowPopUps 1
0 ShowPopUps=1 shows menus.
Appears to be an inactive parameter.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the updating of several customer preference settings, and
requests the response in XML format:
Query
- 1413 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=UPDATECUSPREFERENCES&uid=resellid&pw=resellpw&
DefPeriod=4&AutoRenew=on&AutoPakRenew=on&
RegLock=on&URLForwardingRenew=on&EmailForwardRenew=on&
useparentdefault=0&RecordType=A,A,A&
address=85.92.87.177,85.92.87.179,85.92.87.180&
hostname=@,*,www&ResponseType=XML
In the response, the ErrCount value 0 indicates that the update was successful:
Output
Related commands
l CheckLogin
l CreateAccount
l CreateSubAccount
l GetAccountInfo
l GetAccountPassword
l GetAllAccountInfo
l GetConfirmationSettings
l GetCusPreferences
- 1414 -
API Command Categories
l GetCustomerPaymentInfo
l GetOrderDetail
l GetOrderList
l GetReport
l GetSubAccountDetails
l GetSubAccounts
l GetTransHistory
l SetPakRenew
l UpdateAccountInfo
l UpdateRenewalSettings
UpdateDomainFolder
Description
Definition
Change the name of a folder, configure or change the settings of a Magic Folder, and/or
change a folder from Standard to Magic or from Magic to Standard.
Usage
Use this command to change a folder from Standard to Magic or from Magic to Standard,
configure or change the settings of a Magic Folder, and/or change the folder name or
description of any folder.
This command lets a user choose which settings are Magic, and what those settings
should be (on, off, and so on). Settings that can be Magic include the following:
l Auto-renew
l Registrar lock
l Name servers
l Host records
l Domain password
l Contact information
When a domain is put into a Magic Folder, the domains settings synchronize to those
that are specified as Magic for the folder.
For example, if a folder is only Magic with respect to auto-renew, and auto-renew is on,
all domains put into that folder have their auto-renew setting turned on. Since that is the
only Magic setting for the folder, none of the domains other settings change.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 1415 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The folder must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand& uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1416 -
API Command Categories
- 1417 -
API Command Categories
AddressX
Optional Address to send this host record to. 260
X=1 to maximum 3
- 1418 -
API Command Categories
- 1419 -
API Command Categories
- 1420 -
API Command Categories
Parameter Description
pending processing
18 Invalid host value
- 1421 -
API Command Categories
Parameter Description
1 This is not a Magic folder
2 This is a Magic folder but auto-renew is not set to magic, or
auto-renew is set to Magic and is in sync
3 Auto-renew is set to Magic and this folder is pending syn-
chronization
4 Auto-renew is set to Magic and is out of sync
Should host records be Magic for this folder. Return values are:
SyncHosts 0 No, do not synchronize host records in this folder
1 Yes, synchronize host records in this folder
SyncHostsStatus Status of host record synchronization for this folder. Return val-
- 1422 -
API Command Categories
Parameter Description
ues are:
1 This is not a Magic folder
2 This is a Magic folder but host records are not set to Magic,
or host records are set to Magic and are in sync
3 Host records are set to Magic and this folder is pending syn-
chronization
4 Host records are set to Magic and are out of sync
- 1423 -
API Command Categories
Parameter Description
Fax Fax number of this contact
- 1424 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query makes a folder Magic, adds a folder description, makes auto-renew
Magic and turns autorenew on for the folder, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UpdateDomainFolder& uid=resellid&pw=resellpw&
FolderName=ResellFolder2&FolderType=1&Description=hello&
AutoRenewSync=1&AutoRenew=1&ResponseType=xml
In the response, a Result code 1 and an ErrCount value 0 confirm that the query was suc-
cessful:
Output
- 1425 -
API Command Categories
</FolderDescription>
<FolderType>1</FolderType>
<FolderStatus>2</FolderStatus>
<FolderDomainCount>0</FolderDomainCount>
<DNS>
<SyncDNS>0</SyncDNS>
</DNS>
<Renew>
<SyncRenew>1</SyncRenew>
<SyncRenewStatus>2</SyncRenewStatus>
<RenewStatus>Yes</RenewStatus>
</Renew>
<RegLock>
<SyncRegLock>0</SyncRegLock>
</RegLock>
<DomainPwd>
<SyncDomainPwd>0</SyncDomainPwd>
</DomainPwd>
<Hosts>
<SyncHosts>0</SyncHosts>
</Hosts>
<Contacts>
<SyncContacts>0</SyncContacts>
</Contacts>
</Folder>
<FolderNameEnc>ResellFolder2</FolderNameEnc>
<TrafficOnly>False</TrafficOnly>
<NameOnly>False</NameOnly>
<ParkingEnabled>False</ParkingEnabled>
<Command>UPDATEDOMAINFOLDER</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>8.203</ExecTime>
<Done>true</Done>
- 1426 -
API Command Categories
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainFolder
l AdvancedDomainSearch
l AssignToDomainFolder
l DeleteDomainFolder
l GetDomainFolderDetail
l GetDomainFolderList
l RemoveUnsyncedDomains
UpdateExpiredDomains
Description
Definition
Reactivate an expired domain in real time.
Usage
Use this command to reactivate a domain after it has expired, while it is in Expired
status.
This command reactivates a domain in real time. Before a domain expires, use the
Extend command to renew it. We recommend renewing at least a week before a domain
expires.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/DomainManager.asp?tab=expireddomains
- 1427 -
API Command Categories
On the my domains page, my domains tab, expired subtab, clicking on the name of an
expired domain calls the UpdateExpiredDomains command.
Constraints
The query must meet the following requirements:
l The domain must be in Expired status. The registrar sets the duration of the grace
period between expiration and deletion from the registrars database. To retrieve a
list of expired domains, use the GetDomains command with parameter Tab-
b=ExpiredDomains.
l Customer must have sufficient funds. The charge for reactivation is the same as a
one-year renewal.
Input parameters
- 1428 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests the reactivation of expired domain resellerdocs.com, and
requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UpdateExpiredDomains&uid=resellid&pw=resellpw&
DomainName=resellerdocs.com&responsetype=xml
In the response, the Status value True, and an OrderID number, indicate that the query
was successful:
Output
- 1429 -
API Command Categories
Related commands
l Extend
l Extend_RGP
l GetDomainExp
l GetExtendInfo
l GetRenew
l InsertNewOrder
l SetRenew
UpdateHostPackagePricing
Description
Definition
- 1430 -
API Command Categories
Use this command to change the selling price of Web hosting components, at different
quantity levels.
Usage
Use this command to set your selling prices for Web hosting components, and to set the
price breaks at increasing quantity levels.
This command allows you to set prices either for retail customers or for one subaccount.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
Below the Set Component Unit Pricing table, the save changes button calls the
UpdateHostPackagePricing command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The price breaks for this accounts customers must come into effect at the same
quantity levels as this accounts wholesale price breaks. For example, if you
receive a wholesale price break at 20 units, any retail price break you offer to your
customers must be at 20 units; it cannot be at 15 or 25.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1431 -
API Command Categories
In the retail (selling price) structure for this account, the lower
RetailQtyX
end of the quantity range for this component. For example, if
- 1432 -
API Command Categories
Parameter Description
one RetailQty=1 and the next largest is RetailQty=5, the prices
in the RetailQty=1 node apply to quantities of 1 to 4 of each
Web hosting component listed in this query string.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1433 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes selling prices of Web hosting components at different
quantity levels, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UPDATEHOSTPACKAGEPRICING&uid=resellid&pw=resellpw&
PriceBreakCount=4&QTY1=1&StoragePrice1=1.00&
BandwidthPrice1=1.75&POPPrice1=1.75&
DatabasePrice1=3.75&QTY2=5&StoragePrice2=.39&
BandwidthPrice2=.65&POPPrice2=.45&
DatabasePrice2=4.50&QTY3=10&BandwidthPrice3=.40&
POPPrice3=.24&QTY4=20&BandwidthPrice4=.70&ResponseType=XML
In the response, a list of component costs and prices confirms that the query was suc-
cessful:
Output
- 1434 -
API Command Categories
<RetailQty>5</RetailQty>
<ResellerBandwidthPrice>.55</ResellerBandwidthPrice>
<RetailBandwidthPrice>.65</RetailBandwidthPrice>
<ResellerWebStoragePrice>.25</ResellerWebStoragePrice>
<RetailWebStoragePrice>.39</RetailWebStoragePrice>
<ResellerDBStoragePrice>2.50</ResellerDBStoragePrice>
<RetailDBStoragePrice>4.50</RetailDBStoragePrice>
<ResellerPOPMailPrice>.35</ResellerPOPMailPrice>
<RetailPOPMailPrice>.45</RetailPOPMailPrice>
</components>
<components>
<ResellerQty>10</ResellerQty>
<RetailQty>10</RetailQty>
<ResellerBandwidthPrice>.36</ResellerBandwidthPrice>
<RetailBandwidthPrice>.40</RetailBandwidthPrice>
<ResellerWebStoragePrice>.25</ResellerWebStoragePrice>
<RetailWebStoragePrice>.39</RetailWebStoragePrice>
<ResellerDBStoragePrice />
<RetailDBStoragePrice />
<ResellerPOPMailPrice>.20</ResellerPOPMailPrice>
<RetailPOPMailPrice>.24</RetailPOPMailPrice>
</components>
<components>
<ResellerQty>20</ResellerQty>
<RetailQty>20</RetailQty>
<ResellerBandwidthPrice>.24</ResellerBandwidthPrice>
<RetailBandwidthPrice>.70</RetailBandwidthPrice>
<ResellerWebStoragePrice />
<RetailWebStoragePrice />
<ResellerDBStoragePrice />
<RetailDBStoragePrice />
<ResellerPOPMailPrice />
<RetailPOPMailPrice />
</components>
<PackageCount>4</PackageCount>
</resellerhostpricing>
<Successful>True</Successful>
<Command>UPDATEHOSTPACKAGEPRICING</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
- 1435 -
API Command Categories
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
UpdateMetaTag
Description
Definition
Add or update the HTML metatags for one of a domains host records.
- 1436 -
API Command Categories
Usage
Use this command to raise the probability that a search engine will find this domain.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with login ID resellid, password resellpw.
https://re-
sellertest.enom.-
com/domains/metatags.asp?HostID=11415002&DomainNameID=152533676
On the meta tags page, the save changes button calls the UpdateMetaTag command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1437 -
API Command Categories
Recommended to
Content to display in the browser title
TitleBar optimize search 100
bar. Replace spaces with +.
ranking
Recommended to
Content to display in search engine res-
SiteDescription optimize search 250
ults. Replace spaces with +.
ranking
Recommended to
List of keywords for search engines.
Keywords optimize search 250
Separate keywords with +.
ranking
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1438 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets values for the metatags, and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=UpdateMetaTag&uid=resellid&pw=resellpw&
sld=resellerdocs&tld=com&MetaTagHostID=11415002&
TitleBar=MY+COOL+TITLE&SiteDescription=MY+SITE+DESCRIPTION&
Keywords=MY+SITE+KEYWORDS&ResponseType=XML
In the response, metatag values that match your desired content, and an ErrCount value
0, confirm that the query was successful:
Output
- 1439 -
API Command Categories
Related commands
l GetHosts
l GetMetaTag
l GetRegHosts
l SetHosts
UpdateNameServer
Description
Definition
Change the IP address of a name server in the Registrys records.
Usage
Use this command when the IP address of a name server changes.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://www.enom.com/domains/RegNameServer.asp
In the Update a Name Server IP section, clicking the submit button calls the
UpdateNameServer command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name of the name server must belong to this account.
l eNom must be the authoritative registrar (in the Registrys records) for the root
domain.
l The registrar lock for the name server domain must be set to off while you update
name servers. Oncethe name server IP has been updated, you can (and we recom-
mend that you do) switch the registrar lockback on.
- 1440 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1441 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the IP of name server dns1.resellerdocs.com and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=updatenameserver&uid=resellid&pw=resellpw&
OldIP=127.0.0.1&NewIP=127.0.0.2&
NS=dns1.resellerdocs.com&responsetype=xml
In the response, the NsSuccess value 1 and RRPText value Command completed suc-
cessfully confirm that the query was successful:
Output
- 1442 -
API Command Categories
</debug>
</interface-response>
Related commands
l CheckNSStatus
l DeleteNameServer
l GetDNS
l GetDNSStatus
l ModifyNS
l ModifyNSHosting
l RegisterNameServer
UpdateNotificationAmount
Description
Definition
Update the account balance amount at which you want to be notified.
Usage
Use this command to specify the account balance at which you want a reminder to refill
your account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/Settings.asp?tab=balance
The save changes button calls the UpdateNotificationAmount command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1443 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
- 1444 -
API Command Categories
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the notification amount to 505 points/$US and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UpdateNotificationAmount&uid=resellid&pw=resellpw&
NotifyAmount=505&responsetype=xml
In the response, an ErrCount value 0 confirms that the query was successful:
Output
<interface-response>
<Update>Successful</Update>
<Command>UPDATENOTIFICATIONAMOUNT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.0703125</ExecTime>
<Done>true</Done>
<debug>
[CDATA]
</debug>
</interface-response>
- 1445 -
API Command Categories
Related commands
l GetBalance
l RefillAccount
UpdatePushList
Description
Definition
Update a list of domains to push into another account.
Usage
Use this command to push names from one eNom account to another.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/Push.asp?DomainNameID=152533882
UpdatePushList is not implemented on enom.com. However, the submit button on the
push a name page calls PushDomain, a similar command.
Constraints
The query must meet the following requirements:
l Both the origin and destination accounts must be in our system.
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1446 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests that resellerdocs2.net and resellerdocs3.info be pushed to
account ichiro, and requests the response in XML format:
- 1447 -
API Command Categories
Query
https://resellertest.enom.com/interface.asp?
command=UpdatePushList&uid=resellid&pw=resellpw&
PushToLoginID=ichiro&domainlist=resellerdocs2.net
%0D%0Aresellerdocs3.info&responsetype=xml
In the response, the SuccessfulPush values of Yes indicate that each domain was
pushed successfully:
Output
- 1448 -
API Command Categories
Related commands
l PushDomain
l TP_CancelOrder
l TP_CreateOrder
l TP_GetDetailsByDomain
l TP_GetOrder
l TP_GetOrderDetail
l TP_GetOrdersByDomain
l TP_GetOrderStatuses
l TP_ResubmitLocked
l TP_SubmitOrder
l TP_UpdateOrderDetail
UpdateRenewalSettings
Description
Definition
Update the settings regarding our notifying your customers about domain renewals.
Usage
Use this command to set or change the way in which we notify your customers about
upcoming domain renewals.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/RenewalSettings.asp?RenewalSetting=0
The save changes button calls the UpdateRenewalSettings command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1449 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1450 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query sets preferences for notifying customers about domain renewals,
and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=UPDATERENEWALSETTINGS&uid=resellid&pw=resellpw&
RenewalSetting=2&RenewalBCC=1&AcceptTerms=1&
URL=www.resellerdocs.com&ResponseType=XML
In the response, the return values Successful and the ErrCount value 0 confirm that the
query was successful:
Output
- 1451 -
API Command Categories
Related commands
l GetCusPreferences
l UpdateCusPreferences
ValidatePassword
Description
Definition
Validate a password for a domain name.
Usage
Use this command to determine whether the password for a domain name is valid.
Availability
- 1452 -
API Command Categories
Constraints
The query must meet the following requirements:
l The domain name must exist.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1453 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query asks whether resellerdocs2pw is the domain password for reseller-
docs2.net, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=validatepassword&uid=resellid&pw=resellpw
&sld=resellerdocs2&tld=net&domainpassword=resellerdocs2pw&
responsetype=xml
In the response, the error count of 0 confirms that resellerdocs2pw is the domain pass-
word for resellerdocs2.net:
Output
- 1454 -
API Command Categories
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Related commands
l GetAllDomains
l GetDomainCount
l GetDomainExp
l GetDomainInfo
l GetDomains
l GetExtendInfo
l GetPasswordBit
l GetRegistrationStatus
l GetRegLock
l GetRenew
l GetSubAccountPassword
l SetPassword
l SetRegLock
l SetRenew
l StatusDomain
WBLConfigure
Description
Definition
Configure a Business Listing for the WhoisBusinessListings.com directory.
Usage
Use this command to create or edit the Business Listing for a domain name.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
- 1455 -
API Command Categories
https://resellertest.enom.com/domains/control-panel/panels/wbl_main.as-
px?domainnameid=152533676
The Submit button calls the WBLConfigure command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain must be registered here but may use name servers other than ours.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1456 -
API Command Categories
Optional; default is
0 the first time Busi-
ness Listing is con-
figured or when
PersistExisting=0.
If Per- Enable setting for Business Listing. Per-
Enable 1
sistExisting=1, the mitted values are 0 and 1.
current setting
remains unchanged
when the con-
figuration is
updated.
- 1457 -
API Command Categories
- 1458 -
API Command Categories
Results for the first domain in the query string. This code
reflects only the immediate results for the first domain in the
string. To report results to your customers and allow for queue
delays, we recommend using RPT_GetReport rather than this
ResultCode output.
No code Successful configuration
2 Domain not found
3 Domain not owned by specified account
4 Service not purchased for this domain
Verbal result for the first domain listed in the query string. This
description reflects only the immediate results for the first
ResultDesc domain in the string. To report results to your customers and
allow for queue delays, we recommend using RPT_GetReport
rather than this output.
- 1459 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query submits a configuration request for four domain names and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WBLConfigure&uid=resellid&pw=resellpw&
DomainList=resellerdocs.com,qsdsqdqsd.com,
quebecrod.com,quebecrod111.com&RequestName=ThisJob&
PersistExisting=1&Renew=no&Enable=1&CategoryID1=10&
CompanyName=Company%20name&
CompanyDescription=Company%20description&
Logo=&StreetAddress=123%20Main&StreetAddress2=&
City=Townsville&StateProvince=Maine&PostalCode=10000&
Country=US&FieldCount=2&FieldName1=Company%20Slogan&
FieldText1=We%20have%20a%20slogan&FieldName2=Promotions&
FieldText2=We%20promote%20peace!&ResponseType=xml
In the response, a ReportRequestID value indicates that the query ran successfully and
at least one domain was configured successfully:
Output
- 1460 -
API Command Categories
Related commands
l AddToCart
l AdvancedDomainSearch
l GetAllDomains
l GetDomainInfo
l InsertNewOrder
l PurchaseServices
l RPT_GetReport
l UpdateCusPreferences
l WBLGetCategories
l WBLGetFields
l WBLGetStatus
WBLGetCategories
Description
Definition
- 1461 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1462 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of categories and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WBLGetCategories&uid=resellid&
pw=resellpw&responsetype=xml
In the response, an ErrCount value 0 indicates that the query was successful:
Output
- 1463 -
API Command Categories
<interface-response>
<Categories>
<Category>
<CategoryID>1</CategoryID>
<CategoryName>Arts & Entertainment</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>2</CategoryID>
<CategoryName>Business</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>3</CategoryID>
<CategoryName>Automotive</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>4</CategoryID>
<CategoryName>Consumer Electronics</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>5</CategoryID>
<CategoryName>Culture & Society</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>6</CategoryID>
<CategoryName>Domain For Sale</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>7</CategoryID>
<CategoryName>Education & Instruction</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>8</CategoryID>
<CategoryName>Fashion, Style & Personal Care</CategoryName>
<CategoryDesc/>
</Category>
- 1464 -
API Command Categories
<Category>
<CategoryID>9</CategoryID>
<CategoryName>Food & Drink</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>10</CategoryID>
<CategoryName>Other</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>11</CategoryID>
<CategoryName>Health & Medicine</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>12</CategoryID>
<CategoryName>Hobbies, Games & Toys</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>13</CategoryID>
<CategoryName>Home & Garden</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>14</CategoryID>
<CategoryName>Computers & Internet</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>15</CategoryID>
<CategoryName>Legal</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>16</CategoryID>
<CategoryName>Personal Finance</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>17</CategoryID>
- 1465 -
API Command Categories
<CategoryName>Professional Services</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>18</CategoryID>
<CategoryName>Real Estate</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>19</CategoryID>
<CategoryName>Relationships & Family</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>20</CategoryID>
<CategoryName>Sports & Fitness</CategoryName>
<CategoryDesc/>
</Category>
<Category>
<CategoryID>21</CategoryID>
<CategoryName>Travel & Transportation</CategoryName>
<CategoryDesc/>
</Category>
</Categories>
<Command>WBLGETCATEGORIES</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>1.359</ExecTime>
<Done>true</Done>
<RequestDateTime>12/12/2011 4:32:52 AM</RequestDateTime>
<debug></debug>
</interface-response>
- 1466 -
API Command Categories
Related commands
l AddToCart
l AdvancedDomainSearch
l GetAllDomains
l GetDomainInfo
l InsertNewOrder
l PurchaseServices
l RPT_GetReport
l UpdateCusPreferences
l WBLConfigure
l WBLGetFields
l WBLGetStatus
WBLGetFields
Description
Definition
Retrieve a list of the descriptive fields available for configuring a Business Listing.
Usage
Use this command to retrieve a list of descriptive fields available for Business Listing.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-panel/panels/wbl_main.as-
px?domainnameid=152533676
In the Business Listing Details section, WBLGetFields is used to populate the Title drop-
down menu.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
- 1467 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1468 -
API Command Categories
Example
The following query retrieves a list of descriptive fields for Business Listing, and sends
the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
com-
mand=WBLGetFields&uid=resellid&pw=resellpw&responsetype=xml
In the response, an ErrCount value of 0 confirms that the query ran successfully:
Output
- 1469 -
API Command Categories
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.078</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddToCart
l AdvancedDomainSearch
l GetAllDomains
l GetDomainInfo
l InsertNewOrder
l PurchaseServices
l RPT_GetReport
l UpdateCusPreferences
l WBLConfigure
l WBLGetCategories
l WBLGetStatus
WBLGetStatus
Description
Definition
Retrieve a list of the possible statuses for Business Listing.
Usage
Use this command to retrieve a list of the possible statuses for Business Listing.
Availability
All resellers have access to this command.
Implementation on eNom.com
- 1470 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The report ID must match the login ID.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1471 -
API Command Categories
Parameter Description
Error messages explaining the failure. These can be presented
ErrX
as is back to the client.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of statuses of Business Listing, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WBLGetStatus&uid=resellid&pw=resellpw&
ResponseType=xml
- 1472 -
API Command Categories
<StatusID>0</StatusID>
<Description>Available</Description>
</StatusIDs>
<StatusIDs>
<StatusID>1</StatusID>
<Description>Purchased, Not Configured</Description>
</StatusIDs>
<StatusIDs>
<StatusID>2</StatusID>
<Description>Configured</Description>
</StatusIDs>
<StatusIDs>
<StatusID>3</StatusID>
<Description>Expired</Description>
</StatusIDs>
<StatusIDs>
<StatusID>4</StatusID>
<Description>Configured, Visible</Description>
</StatusIDs>
<StatusIDs>
<StatusID>5</StatusID>
<Description>Configured, Not Visible</Description>
</StatusIDs>
</Templates>
<Command>WBLGETSTATUS</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLER1-STG</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.094</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
- 1473 -
API Command Categories
Related commands
l AddToCart
l AdvancedDomainSearch
l GetAllDomains
l GetDomainInfo
l InsertNewOrder
l PurchaseServices
l RPT_GetReport
l UpdateCusPreferences
l WBLConfigure
l WBLGetCategories
l WBLGetFields
WebHostCreateDirectory
Description
Definition
Create a directory, or a directory structure, in your Web hosting account.
Usage
You can create new directories in two ways: using this command, or via FTP.
You must create new directories if you want host records other than www and @ to point
to a different location than www and @.
You must create new directories if you want to publish more than one Web site using this
Web hosting account (if the account does not have directories, all domain names asso-
ciated with the account will resolve to the same home page).
You may create new directories to organize your account and files.
Directories created with this command have read and write, but not execute, per-
missions. If you want files in a directory to be executable, make the directory executable
using the EnableFolderApp command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password
resellwebpw.
- 1474 -
API Command Categories
http://webhostingtest.ehost-ser-
vices.com/websites/hostheader.asp?hn=@&d=resellerdocs.com
To the right of the Create a New Directory text box, clicking the CREATE button and
then the SAVE HOST HEADER SETTINGS button calls the WebHostCreateDirectory
command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1475 -
API Command Categories
Parameter Description
The number of errors if any occurred. If greater than 0 check
ErrCount
the Err(1 to ErrCount) values.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates a directory named support in Web hosting account resell-
webid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WebHostCreateDirectory&uid=resellid&pw=resellpw&
hostaccount=resellwebid&Directory=support&ResponseType=XML
In the response, the ErrCount value 0 confirms that the directory was created suc-
cessfully:
Output
- 1476 -
API Command Categories
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddDomainHeader
l DeleteDomainHeader
l ListDomainHeaders
l ModifyDomainHeader
WebHostCreatePOPBox
Description
Definition
Create a POP mail box (a single email address) for a Web hosting account.
Usage
Use this command to create a POP mail box for a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password
resellwebpw.
http://webhostingtest.ehost-services.com/email/accounts.asp
The SAVE ALL CHANGES button calls the WebHostCreatePOPBox command.
- 1477 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain account.
l The domain name must be associated with this Web hosting account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1478 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query creates POP mailbox poptest3 for domain resellerdocs.com and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTCREATEPOPBOX&uid=resellid&pw=resellpw&
- 1479 -
API Command Categories
hostac-
count=resellwebid&Username=poptest3&Password=poptest3&
DisplayName=poptest3&sld=resellerdocs&tld=com&
responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l AddDomainHeader
l CreateHostAccount
l GetDomainHeader
l ListDomainHeaders
l WebHostDeletePOPBox
l WebHostGetPOPBoxes
l WebHostUpdatePOPPassword
- 1480 -
API Command Categories
WebHostDeletePOPBox
Description
Definition
Delete a POP mailbox from a Web hosting account.
Usage
Use this command to delete POP mailboxes from a Web hosting account. To delete a
POP mailbox that is in a domain account, use the commands in the API catalog for
domain accounts.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password
resellwebpw.
http://webhostingtest.ehost-services.com/email/accounts.asp
In the Delete User column, any Delete link calls the WebHostDeletePOPBox command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain account.
l The domain name must belong to this domain account, and to this Web hosting
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1481 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1482 -
API Command Categories
Example
The following query deletes POP mailbox jimmy.doe and sends the response in XML
format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTDELETEPOPBOX&uid=resellid&pw=resellpw&
hostaccount=resellwebid&Username=jimmy.doe&
sld=resellerdocs&tld=com&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l AddDomainHeader
l CreateHostAccount
l GetDomainHeader
l ListDomainHeaders
l WebHostCreatePOPBox
l WebHostGetPOPBoxes
l WebHostUpdatePOPPassword
- 1483 -
API Command Categories
WebHostGetCartItem
Description
Definition
Retrieve details on a single Web hosting account in a shopping cart.
Usage
Use this command to retrieve information on a Web hosting item in the shopping cart.
Use the GetCartContent command from the API Commands catalog to retrieve the
CartItemID value.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/cart.asp
For a Web hosting account, the Product Description column displays the results of the
WebHostGetCartItem command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1484 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1485 -
API Command Categories
Example
The following query retrieves details on cart item 389123, a Web hosting account, and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WebHostGetCartItem&&uid=resellid&pw=resellpw&
CartItemID=389123&responsetype=xml
In the response, the correct item ID and an ErrCount value 0 confirm that the query was
successful:
Output
- 1486 -
API Command Categories
Related commands
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetHostAccounts
l GetResellerHostPricing
l HostPackageDefine
l HostPackageView
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
WebHostGetOverageOptions
Description
Definition
Retrieve the permitted options for handling bandwidth overages.
Usage
Use this command to retrieve the permitted valuesID numbers and brief descriptions
for handling bandwidth overages. Overage handling is set by the end user on each indi-
vidual Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingconfig.asp?
Step 2 displays the options for the WebHostGetOverageOptions command.
- 1487 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1488 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves bandwidth-overage-handling options, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=webhostgetoverageoptions&
uid=resellid&pw=resellpw&responsetype=xml
In the response, a list of options for handling bandwidth overages indicates that the
query was successful:
Output
- 1489 -
API Command Categories
</OverageOptions>
<Command>WEBHOSTGETOVERAGEOPTIONS</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetHostAccounts
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
- 1490 -
API Command Categories
WebHostGetOverages
Description
Definition
List Web hosting accounts that have logged bandwidth overages, the nature and amount
of the overages, and the amount we have charged you for each overage.
Usage
Use this command if you are a reseller who does your own billing. This command lists
fees we have charged you, for overages accrued by you or your Web hosting customers.
We return information identified by Web hosting account name. You as a reseller must
use your own database to link that Web hosting account name to payment information.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
http://enomson/wsg/hostingdetail.asp?HostAccount=resellwebid
The Current usage bars indicate overages for the current billing cycle.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1491 -
API Command Categories
- 1492 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves overages for Web hosting accounts in domain name
account resellid, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTGETOVERAGES&uid=resellid&pw=resellpw&
SinceDate=11/1/08&responsetype=xml
The response indicates that two Web hosting accounts had overages.
In Web hosting account FirstWebAccount (the Web hosting account name is parsed from
the Description return parameter), the account pays a per-GB fee (ProductType 56) for
overages, logged 50000MB (50 units) of bandwidth overages, and we billed resellid
$9.77 for this extra bandwidth.
Web hosting account SecondWebAccount also had a bandwidth overage. However, the
ProductType 57 indicates that this account was either set to upgrade when it reached its
bandwidth limit, or the owner manually upgraded during the billing cycle. Our billing sys-
tem compared the per-GB fee to the additional cost of the upgraded bandwidth package,
found the lower of the two amounts, and billed resellid the upgrade amount of $2.93.
Output
- 1493 -
API Command Categories
<Amount>$9.77</Amount>
<ProdType>56</ProdType>
<Units>50</Units>
</Overage>
<Overage>
<WebHostID>10374005</WebHostID>
<Description>SecondWebAccount - Prior BWidth Overage
Fee</Description>
<BillDate>12/2/2003</BillDate>
<Amount>$2.93</Amount>
<ProdType>57</ProdType>
<Units>15</Units>
</Overage>
</OverageCharges>
<OverageCount>2</OverageCount>
<Command>WEBHOSTGETOVERAGES</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>ResellerTest</Server>
<Site>enom</Site>
<IsLockable>1</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
- 1494 -
API Command Categories
l WebHostGetPackages
l WebHostGetStats
l WebHostSetCustomPackage
l WebHostSetOverageOptions
WebHostGetPackageComponentList
Description
Definition
For Web hosting package components, retrieve a list of unit sizes and quantities of units
permitted.
Usage
Use this command to retrieve the permitted quantities and unit sizes of the components
of Web hosting packages.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/HostingPricing.asp
In the Set Packages table, the menu boxes show the permitted quantities, and the lower
row of the column headers shows the sizes of units.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
- 1495 -
API Command Categories
paramname=paramvalue&nextparamname=nextparamvalue
ItemX
One permitted quantity of this component. Usually, each com-
Responses in HTML or text format are
ponent has several permitted quantities.
numbered, X=1 to YUnitCount
YUnitCount
In HTML or text responses, Y is the type Total number of permitted quantities of this component
of component
- 1496 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the permitted quantities and unit sizes for Web hosting
package components, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=webhostgetpackageComponentList&uid=resellid&
pw=resellpw&hostaccount=resellwebid&responsetype=xml
In the response, a list of components and an ErrCount value of 0 confirm that the query
was successful:
Output
- 1497 -
API Command Categories
<Item>2</Item>
<Item>3</Item>
<Item>4</Item>
<Item>5</Item>
.
.
.
<Count>33</Count>
<UnitType>GB</UnitType>
<UnitSize>20</UnitSize>
</BandwidthUnit>
<DatabaseUnit>
<Item>0</Item>
<Item>1</Item>
<Item>2</Item>
<Item>3</Item>
.
.
.
<Count>15</Count>
<UnitType>MB</UnitType>
<UnitSize>250</UnitSize>
</DatabaseUnit>
<POPUnit>
<Item>1</Item>
<Item>2</Item>
<Item>3</Item>
<Item>4</Item>
.
.
.
<Count>18</Count>
<UnitType />
<UnitSize>10</UnitSize>
</POPUnit>
</ComponentList>
<Command>WEBHOSTGETPACKAGECOMPONENTLIST</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
- 1498 -
API Command Categories
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetHostAccounts
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
WebHostGetPackageMinimums
Description
Definition
Retrieve the minimum quantities of components permitted in Web hosting packages.
Usage
- 1499 -
API Command Categories
Use this command to retrieve the minimum quantities of components you can include in
your Web hosting packages.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Step 2 - Set Packages table reflects the constraints displayed with the
WebHostGetPackageMinimums command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1500 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves minimum quantities of the components of Web hosting
packages, and sends the response in XML format:
Query
- 1501 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=WebHostGetPackageMinimums&uid=resellid&
pw=resellpw&hostaccount=resellwebid&responsetype=xml
In the response, a list of package minimums indicates that the query was successful:
Output
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
- 1502 -
API Command Categories
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
WebHostGetPackages
Description
Definition
View the configurations of Web hosting packages available to your retail customers.
Usage
Use this command to display the contents of the Web hosting packages available to your
retail customers.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Set Packages table displays the results of the WebHostGetPackages command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
- 1503 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1504 -
API Command Categories
Parameter Description
account
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the Web hosting packages defined for account resellid and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WebHostGetPackages&uid=resellid&
pw=resellpw&responsetype=xml
In the response, a list of packages and an ErrCount value 0 confirm that the query was
successful:
Output
- 1505 -
API Command Categories
<interface-response>
<HostPackage>
<PackageID>137</PackageID>
<PackageName>Silver</PackageName>
<BandwidthGB>20</BandwidthGB>
<WebStorageMB>2000</WebStorageMB>
<DatabaseTypeID>2</DatabaseTypeID>
<DatabaseType>SQL Server</DatabaseType>
<OSTypeID>1</OSTypeID>
<OSType>Windows</OSType>
<DBStorageMB>500</DBStorageMB>
<POPMailBoxes>50</POPMailBoxes>
</HostPackage>
<HostPackage>
<PackageID>139</PackageID>
<PackageName>Corporate</PackageName>
<BandwidthMB>40</BandwidthMB>
<WebStorageMB>5000</WebStorageMB>
<DatabaseTypeID>2</DatabaseTypeID>
<DatabaseType>SQL Server</DatabaseType>
<OSTypeID>1</OSTypeID>
<OSType>Windows</OSType>
<DBStorageMB>1000</DBStorageMB>
<POPMailBoxes>100</POPMailBoxes>
</HostPackage>
.
.
.
<PackageCount>4</PackageCount>
<Command>WEBHOSTGETPACKAGES</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
- 1506 -
API Command Categories
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetResellerPackages
l WebHostSetCustomPackage
l WebHostSetOverageOptions
WebHostGetPOPBoxes
Description
Definition
Retrieve a list of the POP mailboxes in a Web hosting account.
Usage
Use this command to generate a list of POP mailboxes in a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehostservices.com with Login ID resellid, password
resellpw.
http://webhostingtest.ehost-services.com/Default.asp?
In the Email Accounts section, the Edit link calls the WebHostGetPOPBoxes command.
- 1507 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain account.
l The domain name must belong to this domain account, and to this Web hosting
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1508 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves a list of POP mailboxes for Web hosting account resell-
webid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTGETPOPBOXES&uid=resellid&pw=resellpw&
hostaccount=resellwebid&sld=resellerdocs&tld=com&
responsetype=xml
- 1509 -
API Command Categories
- 1510 -
API Command Categories
</debug>
</interface-response>
Related commands
l AddDomainHeader
l CreateHostAccount
l GetDomainHeader
l ListDomainHeaders
l WebHostCreatePOPBox
l WebHostDeletePOPBox
l WebHostUpdatePOPPassword
WebHostGetResellerPackages
Description
Definition
Retrieves the current configuration of Web hosting packages offered by a reseller
account.
Usage
Use this command to display the current configuration of Web hosting packages for an
account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp
The Set Packages table displays the results of the WebHostGetResellerPackages com-
mand.
- 1511 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The account must be a reseller account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue &nextparamname=nextparamvalue
OSType The operating system of the Web server for this package
- 1512 -
API Command Categories
Parameter Description
POPMailboxes Number of POP mailboxes permitted in this package
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves the reseller Web hosting packages for domain account
resellid and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WebHostGetResellerPackages&uid=resellid&
pw=resellpw&responsetype=xml
In the response, data on Web hosting packages, and an error count 0, indicate that the
query was successful:
Output
- 1513 -
API Command Categories
- 1514 -
API Command Categories
<DomainHeaders>100</DomainHeaders>
<Enabled>True</Enabled>
</HostPackage>
<PackageCount>3</PackageCount>
</HostPackages>
<Command>WEBHOSTGETRESELLERPACKAGES</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l GetAllResellerHostPricing
l GetResellerHostPricing
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
l HostPackageView
l UpdateHostPackagePricing
l WebHostGetCartItem
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostSetCustomPackage
- 1515 -
API Command Categories
WebHostGetStats
Description
Definition
Retrieve the usage statistics for a Web hosting account, for a month you specify in the
query string.
Usage
Use this command to retrieve day-by-day usage statistics for a Web hosting account.
This command allows monitoring of usage patterns, which is most likely to be useful
when a customer inquires about bandwidth overage charges.
To retrieve usage-to-date for the current month, use the GetHostAccount command.
To retrieve bandwidth overages for end-of-month account reconciliation, use the
GetHostOverages command.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehostservices.com with Login ID resellid, password
resellpw.
http://webhostingtest.ehost-services.com/Default.asp?
The Hosting Package Overview shows the results of the WebHostGetStats command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
- 1516 -
API Command Categories
paramname=paramvalue&nextparamname=nextparamvalue
UniqueIPs Number of unique IPs that hit this Web hosting account
Done True indicates this entire response has reached you suc-
- 1517 -
API Command Categories
Parameter Description
cessfully
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves usage information for Web hosting account resellwebid, for
November 2008, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTGETSTATS&uid=resellid&pw=resellpw&
hostaccount=resellwebid&month=11&year=2008&responsetype=xml
- 1518 -
API Command Categories
<Command>WEBHOSTGETSTATS</Command>
<ErrCount>0</ErrCount>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l GetResellerHostPricing
l GetStorageUsage
l WebHostGetOverages
WebHostHelpInfo
Description
Definition
Retrieve host records for email and name and IP of the Web hosting server for a Web
hosting account.
Usage
Use this command to retrieve host records used in email applications.
Use this command to retrieve the name and IP address of the Web hosting server for a
Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
This command is not implemented on enom.com.
- 1519 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
Name of the first domain that was associated with this Web
DomainName
hosting account
- 1520 -
API Command Categories
Parameter Description
Number of host records for DomainName, including www but
HostRecordCount
not @
Version Version
WSCVersion What version of WSC does this Web hosting account include?
Launch URL for the WSC account attached to this Web host-
WSCLaunchURL
ing account
FTPHost Address of the FTP server for this Web hosting account
- 1521 -
API Command Categories
Parameter Description
UILanguage Language for UI
HasFTPConfig
WhiteLableName
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves host records for email, and addresses for uploading Web
site content, and sends the response in XML format:
Query
- 1522 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=webhosthelpinfo&uid=resellid&pw=resellpw&
hostaccount=resellwebid&responsetype=xml
The response lists host records for setting up email, and addresses for uploading Web
site content. The ErrCount value 0 confirms that the query was successful:
Output
- 1523 -
API Command Categories
Related commands
l WebHostCreatePOPBox
l WebHostDeletePOPBox
l WebHostGetPOPBoxes
l WebHostUpdatePOPPassword
WebHostSetCustomPackage
Description
Definition
Upgrade an existing Web hosting account by increasing the bandwidth, Web storage,
database storage, and/or POP mail boxes allotted to it.
Usage
Use this command to upgrade an existing Web hosting account.
Note: If you do your own billing, you should scan all Web hosting accounts on a monthly
basis to confirm that your billing reflects any upgrades customers have chosen.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingdetail.asp?HostAccount=resellwebid
In the HOSTING ACCOUNT UPGRADES section, the menu boxes show the upgrades
that are available. Once you get a quote for an upgrade, the upgrade me now button
appears, which calls the WebHostSetCustomPackage command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
- 1524 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1525 -
API Command Categories
- 1526 -
API Command Categories
Parameter Description
Success Success status for this change
True indicates that the billing period for this Web hosting
UpdateBillingPeriod
account was updated successfully
True indicates that the database for this Web hosting account
UpdateDatabase
was upgraded successfully.
MinPeriod For domain names, shortest period this TLD may be registered
MaxPeriod For domain names, longest period this TLD may be registered
TimeDifference Time difference between the source IP for this query and the
- 1527 -
API Command Categories
Parameter Description
API server that processed it
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query adds bandwidth and POP mailboxes to an existing Web hosting
account, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WEBHOSTSETCUSTOMPACKAGE&uid=resellid&pw=resellpw&
hostaccount=resellwebid&WebStorageUnits=5&
BandWidthUnits=3&DBType=mssql&DBStorageUnits=1&
PopUnits=7&responsetype=xml
The response lists the new configuration of this Web hosting account. The Pack-
ageUpdated value True and the ErrCount value 0 confirm that the query was successful:
Output
- 1528 -
API Command Categories
<Price>9.70</Price>
<PackageUpdated>True</PackageUpdated>
</SetCustomPackage>
<Command>WEBHOSTSETCUSTOMPACKAGE</Command>
<ErrCount>0</ErrCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetResellerHostPricing
l HostPackageDefine
l HostPackageModify
l HostPackageView
l UpdateHostPackagePricing
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
WebHostSetOverageOptions
Description
Definition
For a Web hosting account, choose how bandwidth overages are to be handled.
- 1529 -
API Command Categories
Usage
Use this command to set the bandwidth-overage option for a Web hosting account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingconfig.asp?
In Step 2, the option buttons set the value for the WebHostSetOverageOptions com-
mand.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1530 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query requests bandwidth-overage-handling options, and sends the
response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=webhostsetoverageoptions&uid=resellid&pw=resellpw&
- 1531 -
API Command Categories
WebHostID=715&OptionID=1&responsetype=xml
In the response, a list of options for handling bandwidth overages indicates that the
query was successful:
Output
Related commands
l CalculateAllHostPackagePricing
l CalculateHostPackagePricing
l CreateHostAccount
l GetAllResellerHostPricing
l GetHostAccount
l GetResellerHostPricing
l GetStorageUsage
l HostPackageDefine
l HostPackageDelete
l HostPackageModify
- 1532 -
API Command Categories
l HostPackageView
l HostParkingPage
l UpdateHostPackagePricing
l WebHostGetOverageOptions
l WebHostGetOverages
l WebHostGetPackageComponentList
l WebHostGetPackageMinimums
l WebHostGetPackages
l WebHostGetResellerPackages
l WebHostSetCustomPackage
WebHostUpdatePassword
Description
Definition
Change the password to a Web hosting account.
Usage
Use this command to change the password used to log on to the Web hosting control
panel. The password to the domain name account does not change.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/wsg/hostingdetail.asp?HostAccount=resellwebid
In the HOSTING ACCOUNT NAME section, the save changes button calls the
WebHostUpdatePassword command.
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain name account.
- 1533 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1534 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the Web hosting password (used to login on to the Web
hosting control panel; the password to the domain name account does not change) and
sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WebHostUpdatePassword&uid=resellid&pw=resellpw&
hostaccount=resellwebid&NewHostPW=resellwebnewpw&
ConfirmNewHostPW=resellwebnewpw&responsetype=xml
In the response, the PasswordUpdated value True confirms that the query was suc-
cessful:
Output
- 1535 -
API Command Categories
<IsRealTimeTLD>True</IsRealTimeTLD>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l CancelHostAccount
l GetHostAccount
l WebHostUpdatePOPPassword
WebHostUpdatePOPPassword
Description
Definition
Change the password for a POP mailbox in a Web hosting package.
Usage
Use this command to change the password for a POP mailbox in a Web hosting pack-
age. To change the password for a POP mailbox associated with a domain account, use
one of the POP commands in our domain account API catalog.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to webhostingtest.ehost-services.com with Login ID resellwebid, password
resellwebpw.
http://webhostingtest.ehost-services.com/email/accounts.asp
The SAVE ALL CHANGES button calls the WebHostUpdatePOPPassword command.
- 1536 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting account must belong to this domain account.
l The domain name must be associated with this Web hosting account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1537 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query changes the password of POP mailbox poptest3 to poptest3a and
sends the response in XML format:
Query
- 1538 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=WEBHOSTUPDATEPOPPASSWORD&uid=resellid&
pw=resellpw&hostaccount=resellwebid&Username=poptest3&
NewPassword=POPTEST3a&sld=resellerdocs&
tld=com&responsetype=xml
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l AddDomainHeader
l CreateHostAccount
l GetDomainHeader
l ListHostHeaders
l WebHostCreatePOPBox
l WebHostDeletePOPBox
l WebHostGetPOPBoxes
- 1539 -
API Command Categories
WSC_GetAccountInfo
Description
Definition
Retrieve the information for a Web Site Creator (WSC) account, including the URL for
this account to link to the WSC wizard.
Usage
Use this command to retrieve information about a Web hosting account that includes
WSC, or a stand-alone WSC account.
This command retrieves the URL to the Web site creation wizard for this WSC account.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/websitecreator/websitecreator_manage.asp?
In the pane for each account, the account-specific information is provided by the WSC_
GetAccountInfo command.
Constraints
l The query must meet the following requirements:
l The login ID and password must be valid.
l The Web hosting or WSC stand-alone account must belong to this domain name
account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1540 -
API Command Categories
- 1541 -
API Command Categories
Parameter Description
TerminateDate If flagged for termination, on what date?
WSCLaunchURL The URL for the WSC wizard for this account
WSCCountry The country for the WSC wizard for this account
WSCLanguage The language for the WSC wizard for this account
PromoID For multi-month discounts, the promo code for this discount
- 1542 -
API Command Categories
Parameter Description
CanUpdate Can this billing period be changed?
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves information about one Web hosting account that includes
WSC, or one WSC standalone account, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WSC_GETACCOUNTINFO&uid=resellid&pw=resellpw&
account=LWSC123x4567&responsetype=xml
- 1543 -
API Command Categories
- 1544 -
API Command Categories
<Domain>resellerdocs3.info</Domain>
<DomainNameID>318282341</DomainNameID>
<WSCOnlyHeaders>True</WSCOnlyHeaders>
<HasPOP>True</HasPOP>
</Domains>
</HostHeaderDomains>
<hashostheaders>True</hashostheaders>
<wscpath>WSC</wscpath>
<siteurl>http://www.resellerdocs.com</siteurl>
<IsLWSC>False</IsLWSC>
<wscsiteid>100</wscsiteid>
<PointedTo>True</PointedTo>
<lwscperiodicbilling>
<currentbillperiod />
<nextbillperiod />
<DiscountPlans>
<Plan>
<Month>3</Month>
<PromoID>53</PromoID>
<DiscountPercent>10</DiscountPercent>
</Plan>
<Plan>
<Month>6</Month>
<PromoID>54</PromoID>
<DiscountPercent>15</DiscountPercent>
</Plan>
<Plan>
<Month>12</Month>
<PromoID>55</PromoID>
<DiscountPercent>20</DiscountPercent>
</Plan>
</DiscountPlans>
<DiscountPlanCnt>3</DiscountPlanCnt>
<CanUpdate>True</CanUpdate>
<deletedate />
</lwscperiodicbilling>
</HostPackage>
<AvailableHeaderDomains />
<availabledomainlist>False</availabledomainlist>
<availabledomaincount>836</availabledomaincount>
</WSCHostAccounts>
<Command>WSC_GETACCOUNTINFO</Command>
- 1545 -
API Command Categories
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>7.546875</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddToCart
l GetAllDomains
l PurchaseServices
l WSC_GetAllPackages
l WSC_GetPricing
l WSC_Update_Ops
WSC_GetAllPackages
Description
Definition
Retrieve a list of all Web hosting packages that include WSC, and all WSC stand-alone
accounts.
Usage
Use this command to list all Web hosting packages that include WSC, and all WSC
stand-alone accounts, in a domain name account. The response includes a variety of
information about each WSC account, including the URL to launch the WSC site-build-
ing wizard for this account.
- 1546 -
API Command Categories
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/websitecreator/websitecreator_manage.asp?
The account information on this page is provided by the WSC_GetAllPackages com-
mand.
Constraints
l The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1547 -
API Command Categories
Parameter Description
stand-alone account
WSCLaunchURL The URL for the WSC wizard for this account
HasPOP Does this domain have POP email associated with it?
- 1548 -
API Command Categories
Parameter Description
Return value WSC indicates that this is a Web hosting
WSCPath
account that subscribes to WSC
PromoID For multi-month discounts, the promo code for this discount
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
- 1549 -
API Command Categories
Example
The following query retrieves a list of Web hosting accounts that include WSC, and
WSC stand-alone accounts, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WSC_GETALLPACKAGES&
uid=resellid&pw=resellpw&responsetype=xml
The response includes a wide variety of information on each Web hosting account that
include WSC, and WSC stand-alone account:
Output
- 1550 -
API Command Categories
<wscfullprice />
<wscecommerceprice />
<wscversion>Ecommerce</wscversion>
<HostHeaderDomains>
<Domains>
<Domain>resellerdocs.com</Domain>
<DomainNameID>152566773</DomainNameID>
<WSCOnlyHeaders>True</WSCOnlyHeaders>
<HasPOP>True</HasPOP>
</Domains>
<Domains>
<Domain>resellerdocs2.net</Domain>
<DomainNameID>318282340</DomainNameID>
<WSCOnlyHeaders>True</WSCOnlyHeaders>
<HasPOP>False</HasPOP>
</Domains>
<Domains>
<Domain>resellerdocs3.info</Domain>
<DomainNameID>318282341</DomainNameID>
<WSCOnlyHeaders>True</WSCOnlyHeaders>
<HasPOP>True</HasPOP>
</Domains>
</HostHeaderDomains>
<hashostheaders>True</hashostheaders>
<wscpath>WSC</wscpath>
<siteurl>http://www.resellerdocs.com</siteurl>
<IsLWSC>False</IsLWSC>
<wscsiteid>100</wscsiteid>
<PointedTo>True</PointedTo>
<lwscperiodicbilling>
<currentbillperiod />
<nextbillperiod />
<DiscountPlans>
<Plan>
<Month>3</Month>
<PromoID>53</PromoID>
<DiscountPercent>10</DiscountPercent>
</Plan>
<Plan>
<Month>6</Month>
<PromoID>54</PromoID>
<DiscountPercent>15</DiscountPercent>
- 1551 -
API Command Categories
</Plan>
<Plan>
<Month>12</Month>
<PromoID>55</PromoID>
<DiscountPercent>20</DiscountPercent>
</Plan>
</DiscountPlans>
<DiscountPlanCnt>3</DiscountPlanCnt>
<CanUpdate>True</CanUpdate>
<deletedate />
</lwscperiodicbilling>
</HostPackage>
.
.
.
</interface-response>
Related commands
l AddToCart
l GetAllDomains
l PurchaseServices
l WSC_GetAccountInfo
l WSC_GetPricing
l WSC_Update_Ops
WSC_GetPricing
Description
Definition
Retrieve this accounts wholesale costs or retail prices for Web Site Creator (WSC), and
the URL for our WSC demo.
Usage
Use this command to retrieve the prices this account pays for WSC, or the prices this
account charges retail customers.
Use this command to retrieve the URL to our WSC demo.
- 1552 -
API Command Categories
Package names that begin with WSC offer WSC as part of a Web hosting package
your customer can build one Web site using the Web Site Creator wizard and in addition
have up to 49 other Web sites hosted through the same package. Package names that
begin with LWSC offera single Web site: the one built in the WSC wizard.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/myaccount/hostingpricing.asp?tab=webhosting
In the Web Site Creator Pricing table, the My Total Cost (WSC + Hosting) column shows
the same return values as the WSC_GetPricing command used in the wholesale price
mode. The Total Price (WSC + Hosting) column shows the return values when GetRe-
tail=true.
https://resellertest.enom.com/myaccount/ProductPricing.asp?tab=domainaddons
In the web tools table, the Your Cost column shows the same return values as the WSC_
GetPricing command used in the wholesale price mode. The Price column shows the
return values when GetRetail=true.
Constraints
l The query must meet the following requirements:
l The login ID and password must be valid.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1553 -
API Command Categories
This accounts wholesale cost or retail price for the WSC Full
WSCFullPrice
package, as an add-on to a Web hosting package
This accounts wholesale cost or retail price for the WSC Full
LWSCFullPrice
stand-alone package
- 1554 -
API Command Categories
Parameter Description
True indicates this entire response has reached you suc-
Done
cessfully.
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameterErr(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query retrieves this accounts wholesale costs for Web Site Creator pack-
ages, and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=WSC_GETPRICING&uid=resellid&
pw=resellpw&responsetype=xml
In the response, WSC prices and an ErrCount value 0 confirm that the query was suc-
cessful:
Output
- 1555 -
API Command Categories
http://wsc.ehost-services.com/create_demo_accoun-
t.jsp?productId=
WSCENOSSSLYTC215&cli-
entId=RRENOS999JZT4SYQ&language=en&country=US&
wl_name=wl_enom&demoCallbackUrl=
</wscdemourl>
</wscdemo>
<Command>WSC_GETPRICING</Command>
<Language>en</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod />
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>enom</Site>
<IsLockable />
<IsRealTimeTLD />
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.1484375</ExecTime>
<Done>true</Done>
<debug>
<![CDATA[ ]]>
</debug>
</interface-response>
Related commands
l AddToCart
l GetAllDomains
l PurchaseServices
l WSC_GetAccountInfo
l WSC_GetAllPackages
l WSC_Update_Ops
WSC_Update_Ops
Description
Definition
Upgrade Web Site Creator.
- 1556 -
API Command Categories
Usage
Use this command to upgrade Web Site Creator stand-alone accounts (Web hosting
accounts with account names using format LWSCNNNxNNNN), that are at least Lite
Basic. The following table lays out the upgrade path for WSC stand-alone products (Lite,
Lite Basic, Lite Full, and Lite eCommerce):
Lite Basic
No WSC Lite Full Real time PurchaseServices
Lite eCommerce
To upgrade Web Site Creator within a Web hosting account (Web hosting accounts with
names that do not begin with LWSC), use the WebHostSetCustomPackage command.
You cannot downgrade Web Site Creator from a higher to a lower version.
Availability
All resellers have access to this command.
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/websitecreator/websitecreator_manage.asp
The upgrade now button calls the WSC_Update_Ops command.
Constraints
The query must meet the following requirements:
- 1557 -
API Command Categories
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1558 -
API Command Categories
Parameter Description
AccountStatusID 1 indicates a valid, active account.
PlanUpdated True indicates that the LWSC plan was successfully upgraded
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter ErrCount. If greater than 0 the transaction failed. The
parameter Err(ErrCount) can be presented to the client. Otherwise process the
returned parameters as defined above.
Example
The following query upgrades Web Site Creator to eCommerce and sends the response
in XML format:
Query
- 1559 -
API Command Categories
https://resellertest.enom.com/interface.asp?
command=WSC_Update_Ops&uid=resellid&pw=resellpw&
Account=LWSC337x8128&NewLWSCPlan=LWSCEcommerce&
LWSCBillCycle=6&ResponseType=XML
In the response, the ErrCount value 0 confirms that the query was successful:
Output
Related commands
l AddToCart
l Purchase
l PurchaseServices ServiceSelect
l WSC_GetAccountInfo
l WSC_GetAllPackages
l WSC_GetPricing
- 1560 -
API Command Categories
XXX_GetMemberId
Description
Definition
Get the Member Authorization Token for a XXX domain name.
Usage
If you need to replace a domain memberID with a new one, you need to remove the exist-
ing one assigned to the domain, and then add (set) the new memberID.
Availability
All resellers have access to this command
Implementation on eNom.com
Log on to resellertest.enom.com with Login ID resellid, password resellpw.
https://resellertest.enom.com/domains/control-pan-
el/default.asp?DomainNameID=152932175
Go to the General Settings.
Constraints
l The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1561 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query get the member authorization token for a domain name from the
Registry, and requests the response in XML format:
Query
- 1562 -
API Command Categories
https://resellertest.enom.com/interface.asp?
Command=XXX_GETMEMBERID&UID=resellid&PW=resellpw
&ResponseType=XML&sld=resellertest&tld=xxx
Output
- 1563 -
API Command Categories
Related commands
l XXX_RemoveMemberId
l XXX_SetMemberId
XXX_RemoveMemberId
Description
Definition
Removes the Member Authorization Token for a XXX domain name.
Usage
If you need to replace a domain memberID with a new one, you need to remove the exist-
ing one assigned to the domain, and then add (set) the new memberID.
Availability
- 1564 -
API Command Categories
Constraints
l The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
¶mname=paramvalue&nextparamname=nextparamvalue
- 1565 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
l If response MemberId is empty then the remove failed.
Example
The following query get the member authorization token for a domain name from the
Registry, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
Command=XXX_REMOVEMEMBERID&UID=resellid&PW=resellpw
&ResponseType=XML&sld=resellertest&tld=xxx
&memberid=IXS1YFK0R185PZVA
Output
- 1566 -
API Command Categories
- 1567 -
API Command Categories
Related commands
l XXX_GetMemberId
l XXX_SetMemberId
XXX_SetMemberId
Description
Definition
Sets the Member Authorization Token for a XXX domain name.
Usage
If you need to replace a domain memberID with a new one, you need to remove the exist-
ing one assigned to the domain, and then add (set) the new memberID.
Availability
- 1568 -
API Command Categories
Constraints
The query must meet the following requirements:
l The login ID and password must be valid.
l The domain name must belong to this account.
l The member authorization token must belong to domain name.
Input parameters
Build the query string using this syntax:
https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword&
paramname=paramvalue&nextparamname=nextparamvalue
- 1569 -
API Command Categories
Notes
l The default response format is plain text. To receive the response in HTML or XML
format, send ResponseType=HTML or ResponseType=XML in your request.
l Check the return parameter rameter ErrCount If greater than 0 the transaction
failed. The parameter Err(ErrCount) can be presented to the client. Otherwise pro-
cess the returned parameters as defined above.
Example
The following query get the member authorization token for a domain name from the
Registry, and requests the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
Command=XXX_SETMEMBERID&UID=resellid
&PW=resellpw&ResponseType=XML
&sld=resellertest&tld=xxx&memberid=IXS1YFK0R185PZVA
- 1570 -
API Command Categories
Output
- 1571 -
API Command Categories
<TimeDifference>
<![CDATA[ +3.00 ]]>
</TimeDifference>
<ExecTime>
<![CDATA[ 0.688 ]]>
</ExecTime>
<Done>
<![CDATA[ true ]]>
</Done>
<debug />
<TrackingKey>
<![CDATA[ 85a5e50d-0425-4c9d-a795-25acc26d8c0a ]]>
</TrackingKey>
<RequestDateTime>
<![CDATA[ 12/5/2011 12:42:45 PM ]]>
</RequestDateTime>
</interface-response>
Related commands
l XXX_GetMemberId
l XXX_RemoveMemberId
- 1572 -