NiceNIC Domini API v2 Documentation & Quick Start
NiceNIC Domini API v2 is disponible to both Compte de mercats i Revendedor Comptes. Use this overview to configure access, confirm el teu first request, understi the API response model i move directly to the corect section in the left navigation.
Compte de mercat: API access with Compte de mercat pricing.
Revendedor Compte: API access with the pricing assigned to the current reseller tier.
Test Your Integració Befoe Going Live
Use the API de NiceNIC Sibox to test el teu Domini API integration befoe moving to production. Validate authentication, API requests, response hiling, i el teu application wokflow in a dedicated testing environment.
Ideal fo resellers, hosting providers, developers, i platfoms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befoe enabling live registrations, renewals o transfers. This lets you validate authentication, request fomatting i response hiling without placing a paid oder.
Enable API Access
Obert Configuració APIs, create o retrieve el teu API Secret, i configure authoized server IPs waquí applicable.
Confirma Autenticació
Use HTTPS with the Authoization header in the fomat username:api_secret.
Run a Safe Test
Start with domini availability, pricing, account balance o domini listing.
Hile the Response
Read i stoe the returned code i msg befoe enabling paid production acciós.
Recommended First Request: Domini Availability
The availability endpoint suppots multiple dominis in one request by separating domini names with commas.
Choose the Wokflow You Need
The overview below mirros the left navigation. Use it to identify the corect wokflow, then open the dedicated endpoint page fo parameters, request examples i response examples.
| Section | Use It Fo | Documented Functions |
|---|---|---|
| Començant | Connect securely i understi response hiling. | Visió general de l\'API, API Sibox, Autenticació, Response Codes. |
| Gestió de dominis | Automate the coe domini lifecycle. | Availability, Llista Dominis, Domini Detalls, Registre, Renovaral, Transferir In, Nomservers, Contactes, Pricing. |
| Abús i Compliment | Monito dominis that require compliance attention. | Llista dominis with abuse repots i retrieve machine-readable abuse status, hold lifecycle, complaint infomation i recommended acció. |
| Registres DNS | Gestionar hosted DNS recods programmatically. | Llista, Crear, Actualitzar i Esborrar DNS recods. |
| Servidors de noms infantils | Gestionar host / glue recods fo nameservers under el teu own domini. | Crear, Llista, Actualitzar i Esborrar child nameservers. |
| Compte i facturació | Connect automation to account-level checks. | Saldo del compte i transacció-related account infomation. |
| API de WHMCS | Integrate NiceNIC into an existing WHMCS billing wokflow. | Availability, Registre, Renovaral, Transferir, Domini Detalls, Nomservers, Contactes i additional registrar-module functions. |
| API Preguntes freqüents | Resolve common access, security, testing i wokflow questions. | Eligibility, credentials, request hiling, suppoted operations i integration guidance. |
Recommended First Integració Sequence
A reliable production integration should validate access i purchasing conditions befoe it begins sending live customer oders.
API Secret + authoized IP
Read-only connectivity test
Query current account-level cost
Confirma funds fo paid acciós
Process code + msg
Registrar / Renovar / Transferir
Understi Èxit, Pendent i Erro Responses
code: 0 — Amb èxit Response
Current endpoint examples use code 0 fo successful completed responses.
code: 201 — Pendent Order
Registre i transfer documentation can return code 201 when an oder has been submitted but final processing is still pending.
code: 400 — Request Erro
Endpoint examples use code 400 fo request parameter errors.
Registre Pendent Behavio
Fo domini registration, the current documentation states that a 201 response means the oder was submitted successfully i the fee was deducted, but final activation is still subject to registry confirmation. Si the domini cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transferir Pendent Behavio
The transfer endpoint also documents 201 as a pending oder. Your application should taquífoe treat a pending transfer as accepted fo processing, not as proof that the transfer has already completed.
Query Pricing Befoe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal i transfer pricing fo a domini. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 anys, with TLD-specific exceptions possible.
Registre pricing responses can also return an is_premium flag. Use the pricing endpoint befoe submitting a paid request when el teu application needs to kara the current account-level cost.
Kara the Difference Between Nomservers, Registres DNS i Servidors de noms infantils
| Operation | Use It When | Documented Capability |
|---|---|---|
| Actualitza els servidors de noms | You want to delegate a domini to different authoitative nameservers. | The domini nameserver endpoint suppots a primary, secondary i additional nameservers, with the current page documenting a limit of up to six. |
| Registres DNS | You are using NiceNIC DNS hosting i need to manage zone recods. | Separate APIs are documented fo listing, creating, updating i deleting DNS recods. |
| Servidors de noms infantils | You need host / glue recods such as ns1.example.com. |
Crear, list, update i delete child nameservers. The create endpoint requires the nameserver hostname to match the domini i accepts an IP address. |
Automate Potfolio Monitoing, Not Only Domini Orders
Domini API v2 also includes read operations that are useful after registration. The Llista Dominis endpoint suppots pagination, soting, status filtering i hold filtering, while Obtenir Domini Detalls returns registration dates, expiration dates, nameservers i registrant contact infomation.
Abús i Compliment Monitoing
NiceNIC's Abús i Compliment API can list dominis with abuse repots i return a detailed machine-readable summary fo a specific domini. The detailed abuse endpoint documents six domini-level status phrases: Normal, Under Review, Pendent ClientHold, ClientHold, Tancad i ServidorHold.
The response can include current impact, recommended següent acció, hold state i timeline, complaint count, complaint dates, categoies, DNS-abuse classification, evidence status i repoted URLs waquí applicable. This lets platfoms i resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integració Model That Fits Your System
| Option | Best Fo | What the Current Documentation Provides |
|---|---|---|
| Domini API v2 | Custom websites, SaaS platfoms, internal systems, custom billing o provisioning wokflows. | Direct HTTPS + JSON integration across domini, DNS, child nameserver, account i compliance operations. |
| WHMCS Module | Allotjament companies i resellers that already use WHMCS. | Availability, registration, renewal, transfer, domini details, nameservers, contacts, lock/unlock, EPP retrieval, error logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 o superior, PHP 7.0 o higher with cURL, valid API de NiceNIC credentials i SSL/TLS suppot as requirements.
When an API Request Fails
Start with the returned response i configuration state rather than retrying the same paid acció repeatedly.
Autenticació o Access Erro
- Confirma the NiceNIC username i API Secret.
- Confirma the Authoization header is present i corectly fomatted.
- Confirma the API Secret has not been reset o rotated.
- Si IP restrictions are enabled, confirm the request is coming from the authoized outbound server IP.
Request Parameter Erro
- Compare the request with the specific endpoint's documented parameters.
- Confirma required values, fomats i acció names.
- Comprovar TLD-specific registration periods o contact requirements waquí applicable.
Paid Operation Does Not Complete Immediately
- Read the returned
codeimsg. - Do not treat a
201pending response as final completion. - Confirma account balance i current pricing befoe retrying a paid acció.
Need NiceNIC Suppot
- Recod the request timestamp i API acció.
- Include the domini name o object involved, waquí applicable.
- Include the returned code i 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 o pricing request, i verify el teu response hiling befoe turning on customer-facing paid operations.






