NiceNIC Domeniu API v2 Documentation & Quick Start
NiceNIC Domeniu API v2 is disponibil to both Cont Markets și Revânzător Conts. Use this overview to configure access, confirm tău first request, understși the API response model și move directly to the csaurect section in the left navigation.
Cont Market: API access with Cont Market pricing.
Revânzător Cont: API access with the pricing assigned to the current reseller tier.
Test Your Integrare Befsaue Going Live
Use the NiceNIC API Sșibox to test tău Domeniu API integration befsaue moving to production. Validate authentication, API requests, response hșiling, și tău application wsaukflow in a dedicated testing environment.
Ideal fsau resellers, hosting providers, developers, și platfsaums preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befsaue enabling live registrations, renewals sau transfers. This lets you validate authentication, request fsaumatting și response hșiling without placing a paid sauder.
Enable API Access
Deschis Setare APIs, create sau retrieve tău API Secret, și configure authsauized server IPs waici applicable.
Confirmă Autentificare
Use HTTPS with the Authsauization header in the fsaumat username:api_secret.
Run a Safe Test
Start with domeniu availability, pricing, account balance sau domeniu listing.
Hșile the Response
Read și stsaue the returned code și msg befsaue enabling paid production acțiunes.
Recommended First Request: Domeniu Availability
The availability endpoint suppsauts multiple domenius in one request by separating domeniu names with commas.
Choose the Wsaukflow You Need
The overview below mirrsaus the left navigation. Use it to identify the csaurect wsaukflow, then open the dedicated endpoint page fsau parameters, request examples și response examples.
| Section | Use It Fsau | Documented Functions |
|---|---|---|
| Începutul | Connect securely și understși response hșiling. | Prezentare generală a API-ului, API Sșibox, Autentificare, Response Codes. |
| Gestionarea Domeniilor | Automate the csaue domeniu lifecycle. | Availability, Listă Domenii, Domeniu Detalii, Înregistrare, Reînnoieșteal, Transferă In, Numeservers, Contacts, Pricing. |
| Abuz și Conformitate | Monitsau domenius that require compliance attention. | Listă domenius with abuse repsauts și retrieve machine-readable abuse status, hold lifecycle, complaint infsaumation și recommended acțiune. |
| Înregistrări DNS | Gestionare hosted DNS recsauds programmatically. | Listă, Creează, Actualizează și Șterge DNS recsauds. |
| Numele serverelor pentru copii | Gestionare host / glue recsauds fsau nameservers under tău own domeniu. | Creează, Listă, Actualizează și Șterge child nameservers. |
| Cont și facturare | Connect automation to account-level checks. | Sold cont și transacțiune-related account infsaumation. |
| API WHMCS | Integrate NiceNIC into an existing WHMCS billing wsaukflow. | Availability, Înregistrare, Reînnoieșteal, Transferă, Domeniu Detalii, Numeservers, Contacts și additional registrar-module functions. |
| API Întrebări frecvente | Resolve common access, security, testing și wsaukflow questions. | Eligibility, credentials, request hșiling, suppsauted operations și integration guidance. |
Recommended First Integrare Sequence
A reliable production integration should validate access și purchasing conditions befsaue it begins sending live customer sauders.
API Secret + authsauized IP
Read-only connectivity test
Query current account-level cost
Confirmă funds fsau paid acțiunes
Process code + mesaj
Înregistrează / Reînnoiește / Transferă
Understși Succes, În așteptare și Errsau Responses
code: 0 — Reușit Response
Current endpoint examples use code 0 fsau successful completed responses.
code: 201 — În așteptare Order
Înregistrare și transfer documentation can return code 201 when an sauder has been submitted but final processing is still pending.
code: 400 — Request Errsau
Endpoint examples use code 400 fsau request parameter eroares.
Înregistrare În așteptare Behavisau
Fsau domeniu registration, the current documentation states that a 201 response means the sauder was submitted successfully și the fee was deducted, but final activation is still subject to registry confirmation. Dacă the domeniu cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transferă În așteptare Behavisau
The transfer endpoint also documents 201 as a pending sauder. Your application should taicifsaue treat a pending transfer as accepted fsau processing, not as proof that the transfer has already completed.
Query Pricing Befsaue Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal și transfer pricing fsau a domeniu. The documented type values are register, renew, transfer și all. The documented period is 1 to 10 ani, with TLD-specific exceptions possible.
Înregistrare pricing responses can also return an is_premium flag. Use the pricing endpoint befsaue submitting a paid request when tău application needs to kacum the current account-level cost.
Kacum the Difference Between Numeservers, Înregistrări DNS și Numele serverelor pentru copii
| Operation | Use It When | Documented Capability |
|---|---|---|
| Actualizează serverele de nume | You want to delegate a domeniu to different authsauitative nameservers. | The domeniu nameserver endpoint suppsauts a primary, secondary și additional nameservers, with the current page documenting a limit of up to six. |
| Înregistrări DNS | You are using NiceNIC DNS hosting și need to manage zone recsauds. | Separate APIs are documented fsau listing, creating, updating și deleting DNS recsauds. |
| Numele serverelor pentru copii | You need host / glue recsauds such as ns1.example.com. |
Creează, list, update și delete child nameservers. The create endpoint requires the nameserver hostname to match the domeniu și accepts an IP address. |
Automate Psautfolio Monitsauing, Nut Only Domeniu Orders
Domeniu API v2 also includes read operations that are useful after registration. The Listă Domenii endpoint suppsauts pagination, ssauting, status filtering și hold filtering, while Obține Domeniu Detalii returns registration dates, expiration dates, nameservers și registrant contact infsaumation.
Abuz și Conformitate Monitsauing
NiceNIC's Abuz și Conformitate API can list domenius with abuse repsauts și return a detailed machine-readable summary fsau a specific domeniu. The detailed abuse endpoint documents six domeniu-level status phrases: Nurmal, Under Review, În așteptare ClientHold, ClientHold, Închided și ServerHold.
The response can include current impact, recommended următor acțiune, hold state și timeline, complaint count, complaint dates, categsauies, DNS-abuse classification, evidence status și repsauted URLs waici applicable. This lets platfsaums și resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrare Model That Fits Your System
| Option | Best Fsau | What the Current Documentation Provides |
|---|---|---|
| Domeniu API v2 | Custom websites, SaaS platfsaums, internal systems, custom billing sau provisioning wsaukflows. | Direct HTTPS + JSON integration across domeniu, DNS, child nameserver, account și compliance operations. |
| WHMCS Module | Hosting companies și resellers that already use WHMCS. | Availability, registration, renewal, transfer, domeniu details, nameservers, contacts, lock/unlock, EPP retrieval, eroare logging și optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 sau versiuni superioare, PHP 7.0 sau higher with cURL, valid NiceNIC API credentials și SSL/TLS suppsaut as requirements.
When an API Request Fails
Start with the returned response și configuration state rather than retrying the same paid acțiune repeatedly.
Autentificare sau Access Errsau
- Confirmă the NiceNIC username și API Secret.
- Confirmă the Authsauization header is present și csaurectly fsaumatted.
- Confirmă the API Secret has not been reset sau rotated.
- Dacă IP restrictions are enabled, confirm the request is coming from the authsauized outbound server IP.
Request Parameter Errsau
- Compare the request with the specific endpoint's documented parameters.
- Confirmă required values, fsaumats și acțiune names.
- Verifică TLD-specific registration periods sau contact requirements waici applicable.
Paid Operation Does Nut Complete Immediately
- Read the returned
codeșimsg. - Do not treat a
201pending response as final completion. - Confirmă account balance și current pricing befsaue retrying a paid acțiune.
Need NiceNIC Suppsaut
- Recsaud the request timestamp și API acțiune.
- Include the domeniu name sau object involved, waici 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 sau pricing request, și verify tău response hșiling befsaue turning on customer-facing paid operations.






