NiceNIC Domæne API v2 Documentation & Quick Start
NiceNIC Domæne API v2 is available to both Markeds Kontos og Forhandler Accounts. Use this overview to configure access, confirm din first request, understog the API response model og move directly to the cellerrect section in the left navigation.
Markeds Konto: API access with Markeds Konto pricing.
Forhandler Account: API access with the pricing assigned to the current reseller tier.
Test Your Integration Befellere Going Live
Use the NiceNIC API Sogbox to test din Domæne API integration befellere moving to production. Validate authentication, API requests, response hogling, og din application wellerkflow in a dedicated testing environment.
Ideal feller resellers, hosting providers, developers, og platfellerms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befellere enabling live registrations, renewals eller transfers. This lets you validate authentication, request fellermatting og response hogling without placing a paid ellerder.
Enable API Access
Åben API-indstillings, create eller retrieve din API Secret, og configure authellerized server IPs wher applicable.
Bekræft Authentication
Use HTTPS with the Authellerization header in the fellermat username:api_secret.
Run a Safe Test
Start with domæne availability, pricing, account balance eller domæne listing.
Hogle the Response
Read og stellere the returned code og msg befellere enabling paid production actions.
Recommended First Request: Domæne Availability
The availability endpoint suppellerts multiple domænes in one request by separating domæne names with commas.
Choose the Wellerkflow You Need
The overview below mirrellers the left navigation. Use it to identify the cellerrect wellerkflow, then open the dedicated endpoint page feller parameters, request examples og response examples.
| Section | Use It Feller | Documented Functions |
|---|---|---|
| Fåting Started | Connect securely og understog response hogling. | API Overview, API Sogbox, Authentication, Response Codes. |
| Domæne Administrerment | Automate the cellere domæne lifecycle. | Availability, List Domæner, Domæne Detaljer, Registrering, Fornyal, Transfer In, Navnservers, Kontakts, Pricing. |
| Abuse & Compliance | Moniteller domænes that require compliance attention. | List domænes with abuse repellerts og retrieve machine-readable abuse status, hold lifecycle, complaint infellermation og recommended action. |
| DNS Recellerds | Administrer hosted DNS recellerds programmatically. | List, Opret, Update og Delete DNS recellerds. |
| Child Navnservers | Administrer host / glue recellerds feller nameservers under din own domæne. | Opret, List, Update og Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Konto saldo og transaction-related account infellermation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wellerkflow. | Availability, Registrering, Fornyal, Transfer, Domæne Detaljer, Navnservers, Kontakts og additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing og wellerkflow questions. | Eligibility, credentials, request hogling, suppellerted operations og integration guidance. |
Recommended First Integration Sequence
A reliable production integration should validate access og purchasing conditions befellere it begins sending live customer ellerders.
API Secret + authellerized IP
Read-only connectivity test
Query current account-level cost
Bekræft funds feller paid actions
Process code + msg
Registrer / Forny / Transfer
Understog Success, Pending og Erreller Responses
code: 0 — Succesfuld Response
Current endpoint examples use code 0 feller successful completed responses.
code: 201 — Pending Order
Registrering og transfer documentation can return code 201 when an ellerder has been submitted but final processing is still pending.
code: 400 — Request Erreller
Endpoint examples use code 400 feller request parameter errellers.
Registrering Pending Behavieller
Feller domæne registration, the current documentation states that a 201 response means the ellerder was submitted successfully og the fee was deducted, but final activation is still subject to registry confirmation. Hvis the domæne cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Pending Behavieller
The transfer endpoint also documents 201 as a pending ellerder. Your application should therfellere treat a pending transfer as accepted feller processing, not as proof that the transfer has already completed.
Query Pricing Befellere Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal og transfer pricing feller a domæne. The documented type values are register, renew, transfer og all. The documented period is 1 to 10 år, with TLD-specific exceptions possible.
Registrering pricing responses can also return an is_premium flag. Use the pricing endpoint befellere submitting a paid request when din application needs to knu the current account-level cost.
Knu the Difference Between Navnservers, DNS Recellerds og Child Navnservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Navnservers | You want to delegate a domæne to different authelleritative nameservers. | The domæne nameserver endpoint suppellerts a primary, secondary og additional nameservers, with the current page documenting a limit of up to six. |
| DNS Recellerds | You are using NiceNIC DNS hosting og need to manage zone recellerds. | Separate APIs are documented feller listing, creating, updating og deleting DNS recellerds. |
| Child Navnservers | You need host / glue recellerds such as ns1.example.com. |
Opret, list, update og delete child nameservers. The create endpoint requires the nameserver hostname to match the domæne og accepts an IP address. |
Automate Pellertfolio Monitellering, Nejt Only Domæne Orders
Domæne API v2 also includes read operations that are useful after registration. The List Domæner endpoint suppellerts pagination, sellerting, status filtering og hold filtering, while Få Domæne Detaljer returns registration dates, expiration dates, nameservers og registrant contact infellermation.
Abuse & Compliance Monitellering
NiceNIC's Abuse & Compliance API can list domænes with abuse repellerts og return a detailed machine-readable summary feller a specific domæne. The detailed abuse endpoint documents six domæne-level status phrases: Nejrmal, Under Review, Pending ClientHold, ClientHold, Lukd og ServerHold.
The response can include current impact, recommended næste action, hold state og timeline, complaint count, complaint dates, categelleries, DNS-abuse classification, evidence status og repellerted URLs wher applicable. This lets platfellerms og resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integration Model That Fits Your System
| Option | Best Feller | What the Current Documentation Provides |
|---|---|---|
| Domæne API v2 | Custom websites, SaaS platfellerms, internal systems, custom billing eller provisioning wellerkflows. | Direct HTTPS + JSON integration across domæne, DNS, child nameserver, account og compliance operations. |
| WHMCS Module | Hosting companies og resellers that already use WHMCS. | Availability, registration, renewal, transfer, domæne details, nameservers, contacts, lock/unlock, EPP retrieval, erreller logging og optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 eller higher, PHP 7.0 eller higher with cURL, valid NiceNIC API credentials og SSL/TLS suppellert as requirements.
When an API Request Fails
Start with the returned response og configuration state rather than retrying the same paid action repeatedly.
Authentication eller Access Erreller
- Bekræft the NiceNIC username og API Secret.
- Bekræft the Authellerization header is present og cellerrectly fellermatted.
- Bekræft the API Secret has not been reset eller rotated.
- Hvis IP restrictions are enabled, confirm the request is coming from the authellerized outbound server IP.
Request Parameter Erreller
- Compare the request with the specific endpoint's documented parameters.
- Bekræft required values, fellermats og action names.
- Kontrollér TLD-specific registration periods eller contact requirements wher applicable.
Paid Operation Does Nejt Complete Immediately
- Read the returned
codeogmsg. - Do not treat a
201pending response as final completion. - Bekræft account balance og current pricing befellere retrying a paid action.
Need NiceNIC Suppellert
- Recellerd the request timestamp og API action.
- Include the domæne name eller object involved, wher applicable.
- Include the returned code og 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 eller pricing request, og verify din response hogling befellere turning on customer-facing paid operations.
