NiceNIC Domeniu API v2 Documentation & Quick Start
NiceNIC Domeniu API v2 is available to both Cont Markets și Revânzător Accounts. 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 Account: API access with the pricing assigned to the current reseller tier.
Test Your Integrare Befsaue Going Live
Use the API NiceNIC 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ă Authentication
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 actions.
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 |
|---|---|---|
| Obțineting Started | Connect securely și understși response hșiling. | API Overview, API Sșibox, Authentication, Response Codes. |
| Domeniu Gestionarement | Automate the csaue domeniu lifecycle. | Availability, List Domenii, Domeniu Detalii, Înregistrare, Reînnoieșteal, Transfer In, Numeservers, Contacts, Pricing. |
| Abuse & Compliance | Monitsau domenius that require compliance attention. | List domenius with abuse repsauts și retrieve machine-readable abuse status, hold lifecycle, complaint infsaumation și recommended action. |
| DNS Recsauds | Gestionare hosted DNS recsauds programmatically. | List, Creează, Update și Delete DNS recsauds. |
| Child Numeservers | Gestionare host / glue recsauds fsau nameservers under tău own domeniu. | Creează, List, Update și Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Sold cont și transaction-related account infsaumation. |
| WHMCS API | 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 actions
Process code + msg
Înregistrează / Reînnoiește / Transfer
Understși Success, Pending și Errsau Responses
code: 0 — Reușit Response
Current endpoint examples use code 0 fsau successful completed responses.
code: 201 — Pending 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 errsaus.
Înregistrare Pending 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 Pending 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, DNS Recsauds și Child Numeservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Numeservers | 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. |
| DNS Recsauds | You are using NiceNIC DNS hosting și need to manage zone recsauds. | Separate APIs are documented fsau listing, creating, updating și deleting DNS recsauds. |
| Child Numeservers | 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.
Abuse & Compliance Monitsauing
NiceNIC's Abuse & Compliance 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, Pending ClientHold, ClientHold, Închided și ServerHold.
The response can include current impact, recommended următor action, 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, errsau logging și optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 sau higher, PHP 7.0 sau higher with cURL, valid API NiceNIC 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 action repeatedly.
Authentication 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 action 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 action.
Need NiceNIC Suppsaut
- Recsaud the request timestamp și API action.
- 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.
