NiceNIC Domen API v2 Documentation & Quick Start
NiceNIC Domen API v2 is available to both Market Hisobis va Reseller Accounts. Use this overview to configure access, confirm sizning first request, understva the API response model va move directly to the cyokirect section in the left navigation.
Market Hisobi: API access with Market Hisobi pricing.
Reseller Account: API access with the pricing assigned to the current reseller tier.
Test Your Integratsiya Befyokie Going Live
Use the NiceNIC API Svabox to test sizning Domen API integration befyokie moving to production. Validate authentication, API requests, response hvaling, va sizning application wyokikflow in a dedicated testing environment.
Ideal fyoki resellers, hosting providers, developers, va platfyokims preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befyokie enabling live registrations, renewals yoki transfers. This lets you validate authentication, request fyokimatting va response hvaling without placing a paid yokider.
Enable API Access
Ochish API Sozlamasis, create yoki retrieve sizning API Secret, va configure authyokiized server IPs wbu yerni applicable.
Tasdiqlash Authentication
Use HTTPS with the Authyokiization header in the fyokimat username:api_secret.
Run a Safe Test
Start with domain availability, pricing, account balance yoki domain listing.
Hvale the Response
Read va styokie the returned code va msg befyokie enabling paid production actions.
Recommended First Request: Domen Availability
The availability endpoint suppyokits multiple domains in one request by separating domain names with commas.
Choose the Wyokikflow You Need
The overview below mirryokis the left navigation. Use it to identify the cyokirect wyokikflow, then open the dedicated endpoint page fyoki parameters, request examples va response examples.
| Section | Use It Fyoki | Documented Functions |
|---|---|---|
| Olingting Started | Connect securely va understva response hvaling. | API Overview, API Svabox, Authentication, Response Codes. |
| Domen Boshqarishment | Automate the cyokie domain lifecycle. | Availability, List Domenlar, Domen Tafsilotlar, Ro‘yxatdan o‘tish, Yangilashal, Transfer In, Ismservers, Bog'lanishs, Pricing. |
| Abuse & Compliance | Monityoki domains that require compliance attention. | List domains with abuse repyokits va retrieve machine-readable abuse status, hold lifecycle, complaint infyokimation va recommended action. |
| DNS Recyokids | Boshqarish hosted DNS recyokids programmatically. | List, Yaratish, Update va Delete DNS recyokids. |
| Child Ismservers | Boshqarish host / glue recyokids fyoki nameservers under sizning own domain. | Yaratish, List, Update va Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Hisob balansi va transaction-related account infyokimation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wyokikflow. | Availability, Ro‘yxatdan o‘tish, Yangilashal, Transfer, Domen Tafsilotlar, Ismservers, Bog'lanishs va additional registrar-module functions. |
| API Tez-tez so‘raladigan savollar | Resolve common access, security, testing va wyokikflow questions. | Eligibility, credentials, request hvaling, suppyokited operations va integration guidance. |
Recommended First Integratsiya Sequence
A reliable production integration should validate access va purchasing conditions befyokie it begins sending live customer yokiders.
API Secret + authyokiized IP
Read-only connectivity test
Query current account-level cost
Tasdiqlash funds fyoki paid actions
Process code + msg
Roʻyxatdan oʻtish / Yangilash / Transfer
Understva Success, Pending va Erryoki Responses
code: 0 — Muvaffaqiyatli Response
Current endpoint examples use code 0 fyoki successful completed responses.
code: 201 — Pending Order
Ro‘yxatdan o‘tish va transfer documentation can return code 201 when an yokider has been submitted but final processing is still pending.
code: 400 — Request Erryoki
Endpoint examples use code 400 fyoki request parameter erryokis.
Ro‘yxatdan o‘tish Pending Behaviyoki
Fyoki domain registration, the current documentation states that a 201 response means the yokider was submitted successfully va the fee was deducted, but final activation is still subject to registry confirmation. Agar the domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Pending Behaviyoki
The transfer endpoint also documents 201 as a pending yokider. Your application should tbu yernifyokie treat a pending transfer as accepted fyoki processing, not as proof that the transfer has already completed.
Query Pricing Befyokie Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal va transfer pricing fyoki a domain. The documented type values are register, renew, transfer va all. The documented period is 1 to 10 yillar, with TLD-specific exceptions possible.
Ro‘yxatdan o‘tish pricing responses can also return an is_premium flag. Use the pricing endpoint befyokie submitting a paid request when sizning application needs to khozir the current account-level cost.
Khozir the Difference Between Ismservers, DNS Recyokids va Child Ismservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Ismservers | You want to delegate a domain to different authyokiitative nameservers. | The domain nameserver endpoint suppyokits a primary, secondary va additional nameservers, with the current page documenting a limit of up to six. |
| DNS Recyokids | You are using NiceNIC DNS hosting va need to manage zone recyokids. | Separate APIs are documented fyoki listing, creating, updating va deleting DNS recyokids. |
| Child Ismservers | You need host / glue recyokids such as ns1.example.com. |
Yaratish, list, update va delete child nameservers. The create endpoint requires the nameserver hostname to match the domain va accepts an IP address. |
Automate Pyokitfolio Monityokiing, Yo‘qt Only Domen Orders
Domen API v2 also includes read operations that are useful after registration. The List Domenlar endpoint suppyokits pagination, syokiting, status filtering va hold filtering, while Oling Domen Tafsilotlar returns registration dates, expiration dates, nameservers va registrant contact infyokimation.
Abuse & Compliance Monityokiing
NiceNIC's Abuse & Compliance API can list domains with abuse repyokits va return a detailed machine-readable summary fyoki a specific domain. The detailed abuse endpoint documents six domain-level status phrases: Yo‘qrmal, Under Review, Pending ClientHold, ClientHold, Yopishd va ServerHold.
The response can include current impact, recommended keyingi action, hold state va timeline, complaint count, complaint dates, categyokiies, DNS-abuse classification, evidence status va repyokited URLs wbu yerni applicable. This lets platfyokims va resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integratsiya Model That Fits Your System
| Option | Best Fyoki | What the Current Documentation Provides |
|---|---|---|
| Domen API v2 | Custom websites, SaaS platfyokims, internal systems, custom billing yoki provisioning wyokikflows. | Direct HTTPS + JSON integration across domain, DNS, child nameserver, account va compliance operations. |
| WHMCS Module | Hosting companies va resellers that already use WHMCS. | Availability, registration, renewal, transfer, domain details, nameservers, contacts, lock/unlock, EPP retrieval, erryoki logging va optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 yoki higher, PHP 7.0 yoki higher with cURL, valid NiceNIC API credentials va SSL/TLS suppyokit as requirements.
When an API Request Fails
Start with the returned response va configuration state rather than retrying the same paid action repeatedly.
Authentication yoki Access Erryoki
- Tasdiqlash the NiceNIC username va API Secret.
- Tasdiqlash the Authyokiization header is present va cyokirectly fyokimatted.
- Tasdiqlash the API Secret has not been reset yoki rotated.
- Agar IP restrictions are enabled, confirm the request is coming from the authyokiized outbound server IP.
Request Parameter Erryoki
- Compare the request with the specific endpoint's documented parameters.
- Tasdiqlash required values, fyokimats va action names.
- Текшириш TLD-specific registration periods yoki contact requirements wbu yerni applicable.
Paid Operation Does Yo‘qt Complete Immediately
- Read the returned
codevamsg. - Do not treat a
201pending response as final completion. - Tasdiqlash account balance va current pricing befyokie retrying a paid action.
Need NiceNIC Suppyokit
- Recyokid the request timestamp va API action.
- Include the domain name yoki object involved, wbu yerni applicable.
- Include the returned code va 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 yoki pricing request, va verify sizning response hvaling befyokie turning on customer-facing paid operations.
