NiceNIC Domain API v2 Documentation & Quick Start
NiceNIC Domain API v2 is tersedia to both Akaun Pasarans dan Penjual Semula Akauns. Use this overview to configure access, confirm anda first request, understdan the API response model dan move directly to the cataurect section in the left navigation.
Akaun Pasaran: API access with Akaun Pasaran pricing.
Penjual Semula Akaun: API access with the pricing assigned to the current reseller tier.
Test Your Integrasi Befataue Going Live
Use the NiceNIC API Sdanbox to test anda Domain API integration befataue moving to production. Validate authentication, API requests, response hdanling, dan anda application wataukflow in a dedicated testing environment.
Ideal fatau resellers, hosting providers, developers, dan platfataums preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befataue enabling live registrations, renewals atau transfers. This lets you validate authentication, request fataumatting dan response hdanling without placing a paid atauder.
Enable API Access
Buka Tetapan APIs, create atau retrieve anda API Secret, dan configure authatauized server IPs wdi sini applicable.
Sahkan Pengesahan
Use HTTPS with the Authatauization header in the fataumat username:api_secret.
Run a Safe Test
Start with domain availability, pricing, account balance atau domain listing.
Hdanle the Response
Read dan stataue the returned code dan msg befataue enabling paid production tindakans.
Recommended First Request: Domain Availability
The availability endpoint suppatauts multiple domains in one request by separating domain names with commas.
Choose the Wataukflow You Need
The overview below mirrataus the left navigation. Use it to identify the cataurect wataukflow, then open the dedicated endpoint page fatau parameters, request examples dan response examples.
| Section | Use It Fatau | Documented Functions |
|---|---|---|
| Memulakan | Connect securely dan understdan response hdanling. | Gambaran Keseluruhan API, API Sdanbox, Pengesahan, Response Codes. |
| Pengurusan Domain | Automate the cataue domain lifecycle. | Availability, Senarai Domain, Domain Butiran, Pendaftaran, Perbaharuial, Pindah In, Namaservers, Hubungis, Pricing. |
| Penyalahgunaan & Pematuhan | Monitatau domains that require compliance attention. | Senarai domains with abuse repatauts dan retrieve machine-readable abuse status, hold lifecycle, complaint infataumation dan recommended tindakan. |
| Rekod DNS | Urus hosted DNS recatauds programmatically. | Senarai, Cipta, Kemas Kini dan Padam DNS recatauds. |
| Pelayan Nama Kanak-kanak | Urus host / glue recatauds fatau nameservers under anda own domain. | Cipta, Senarai, Kemas Kini dan Padam child nameservers. |
| Akaun & Pengebilan | Connect automation to account-level checks. | Baki Akaun dan transtindakan-related account infataumation. |
| API WHMCS | Integrate NiceNIC into an existing WHMCS billing wataukflow. | Availability, Pendaftaran, Perbaharuial, Pindah, Domain Butiran, Namaservers, Hubungis dan additional registrar-module functions. |
| API Soalan Lazim | Resolve common access, security, testing dan wataukflow questions. | Eligibility, credentials, request hdanling, suppatauted operations dan integration guidance. |
Recommended First Integrasi Sequence
A reliable production integration should validate access dan purchasing conditions befataue it begins sending live customer atauders.
API Secret + authatauized IP
Read-only connectivity test
Query current account-level cost
Sahkan funds fatau paid tindakans
Process code + msg
Daftar / Perbaharui / Pindah
Understdan Berjaya, Menunggu dan Erratau Responses
code: 0 — Berjaya Response
Current endpoint examples use code 0 fatau successful completed responses.
code: 201 — Menunggu Order
Pendaftaran dan transfer documentation can return code 201 when an atauder has been submitted but final processing is still pending.
code: 400 — Request Erratau
Endpoint examples use code 400 fatau request parameter Ralats.
Pendaftaran Menunggu Behaviatau
Fatau domain registration, the current documentation states that a 201 response means the atauder was submitted successfully dan the fee was deducted, but final activation is still subject to registry confirmation. Jika the domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Pindah Menunggu Behaviatau
The transfer endpoint also documents 201 as a pending atauder. Your application should tdi sinifataue treat a pending transfer as accepted fatau processing, not as proof that the transfer has already completed.
Query Pricing Befataue Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal dan transfer pricing fatau a domain. The documented type values are register, renew, transfer dan all. The documented period is 1 to 10 tahun, with TLD-specific exceptions possible.
Pendaftaran pricing responses can also return an is_premium flag. Use the pricing endpoint befataue submitting a paid request when anda application needs to ksekarang the current account-level cost.
Ksekarang the Difference Between Namaservers, Rekod DNS dan Pelayan Nama Kanak-kanak
| Operation | Use It When | Documented Capability |
|---|---|---|
| Kemas kini Pelayan Nama | You want to delegate a domain to different authatauitative nameservers. | The domain nameserver endpoint suppatauts a primary, secondary dan additional nameservers, with the current page documenting a limit of up to six. |
| Rekod DNS | You are using NiceNIC DNS hosting dan need to manage zone recatauds. | Separate APIs are documented fatau listing, creating, updating dan deleting DNS recatauds. |
| Pelayan Nama Kanak-kanak | You need host / glue recatauds such as ns1.example.com. |
Cipta, list, update dan delete child nameservers. The create endpoint requires the nameserver hostname to match the domain dan accepts an IP address. |
Automate Patautfolio Monitatauing, Tidakt Only Domain Orders
Domain API v2 also includes read operations that are useful after registration. The Senarai Domain endpoint suppatauts pagination, satauting, status filtering dan hold filtering, while Dapatkan Domain Butiran returns registration dates, expiration dates, nameservers dan registrant contact infataumation.
Penyalahgunaan & Pematuhan Monitatauing
NiceNIC's Penyalahgunaan & Pematuhan API can list domains with abuse repatauts dan return a detailed machine-readable summary fatau a specific domain. The detailed abuse endpoint documents six domain-level status phrases: Tidakrmal, Under Review, Menunggu ClientHold, ClientHold, Tutupd dan PelayanHold.
The response can include current impact, recommended seterusnya tindakan, hold state dan timeline, complaint count, complaint dates, categatauies, DNS-abuse classification, evidence status dan repatauted URLs wdi sini applicable. This lets platfataums dan resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrasi Model That Fits Your System
| Option | Best Fatau | What the Current Documentation Provides |
|---|---|---|
| Domain API v2 | Custom websites, SaaS platfataums, internal systems, custom billing atau provisioning wataukflows. | Direct HTTPS + JSON integration across domain, DNS, child nameserver, account dan compliance operations. |
| WHMCS Module | Pengehosan companies dan resellers that already use WHMCS. | Availability, registration, renewal, transfer, domain details, nameservers, contacts, lock/unlock, EPP retrieval, Ralat logging dan optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 atau lebih tinggi, PHP 7.0 atau higher with cURL, valid NiceNIC API credentials dan SSL/TLS suppataut as requirements.
When an API Request Fails
Start with the returned response dan configuration state rather than retrying the same paid tindakan repeatedly.
Pengesahan atau Access Erratau
- Sahkan the NiceNIC username dan API Secret.
- Sahkan the Authatauization header is present dan cataurectly fataumatted.
- Sahkan the API Secret has not been reset atau rotated.
- Jika IP restrictions are enabled, confirm the request is coming from the authatauized outbound server IP.
Request Parameter Erratau
- Compare the request with the specific endpoint's documented parameters.
- Sahkan required values, fataumats dan tindakan names.
- Semak TLD-specific registration periods atau contact requirements wdi sini applicable.
Paid Operation Does Tidakt Complete Immediately
- Read the returned
codedanmsg. - Do not treat a
201pending response as final completion. - Sahkan account balance dan current pricing befataue retrying a paid tindakan.
Need NiceNIC Suppataut
- Recataud the request timestamp dan API tindakan.
- Include the domain name atau object involved, wdi sini applicable.
- Include the returned code dan message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability atau pricing request, dan verify anda response hdanling befataue turning on customer-facing paid operations.






