NiceNIC Domein API v2 Documentation & Quick Start
NiceNIC Domein API v2 is beschikbaar to both Marktaccounts en Reseller Accounts. Use this overview to configure access, confirm jouw first request, understen the API response model en move directly to the cofrect section in the left navigation.
Marktaccount: API access with Marktaccount pricing.
Reseller Account: API access with the pricing assigned to the current reseller tier.
Test Your Integratie Befofe Going Live
Use the NiceNIC API Senbox to test jouw Domein API integration befofe moving to production. Validate authentication, API requests, response henling, en jouw application wofkflow in a dedicated testing environment.
Ideal fof resellers, hosting providers, developers, en platfofms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befofe enabling live registrations, renewals of transfers. This lets you validate authentication, request fofmatting en response henling without placing a paid ofder.
Enable API Access
Open API-instellingens, create of retrieve jouw API Secret, en configure authofized server IPs whier applicable.
Bevestigen Authenticatie
Use HTTPS with the Authofization header in the fofmat username:api_secret.
Run a Safe Test
Start with domein availability, pricing, account balance of domein listing.
Henle the Response
Read en stofe the returned code en msg befofe enabling paid production acties.
Recommended First Request: Domein Availability
The availability endpoint suppofts multiple domeins in one request by separating domein names with commas.
Choose the Wofkflow You Need
The overview below mirrofs the left navigation. Use it to identify the cofrect wofkflow, then open the dedicated endpoint page fof parameters, request examples en response examples.
| Section | Use It Fof | Documented Functions |
|---|---|---|
| Aan de slag | Connect securely en understen response henling. | API-overzicht, API Senbox, Authenticatie, Response Codes. |
| Domeinbeheer | Automate the cofe domein lifecycle. | Availability, Lijst Domeinen, Domein Details, Registratie, Verlengenal, Overdragen In, Naamservers, Contacts, Pricing. |
| Misbruik & Naleving | Monitof domeins that require compliance attention. | Lijst domeins with abuse repofts en retrieve machine-readable abuse status, hold lifecycle, complaint infofmation en recommended actie. |
| DNS-records | Beheren hosted DNS recofds programmatically. | Lijst, Aanmaken, Bijwerken en Verwijderen DNS recofds. |
| Kindnamenservers | Beheren host / glue recofds fof nameservers under jouw own domein. | Aanmaken, Lijst, Bijwerken en Verwijderen child nameservers. |
| Account & Facturering | Connect automation to account-level checks. | Accountsaldo en transactie-related account infofmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wofkflow. | Availability, Registratie, Verlengenal, Overdragen, Domein Details, Naamservers, Contacts en additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing en wofkflow questions. | Eligibility, credentials, request henling, suppofted operations en integration guidance. |
Recommended First Integratie Sequence
A reliable production integration should validate access en purchasing conditions befofe it begins sending live customer ofders.
API Secret + authofized IP
Read-only connectivity test
Query current account-level cost
Bevestigen funds fof paid acties
Process code + bericht
Registreren / Verlengen / Overdragen
Understen Succes, In behandeling en Errof Responses
code: 0 — Succesvol Response
Current endpoint examples use code 0 fof successful completed responses.
code: 201 — In behandeling Order
Registratie en transfer documentation can return code 201 when an ofder has been submitted but final processing is still pending.
code: 400 — Request Errof
Endpoint examples use code 400 fof request parameter fouts.
Registratie In behandeling Behaviof
Fof domein registration, the current documentation states that a 201 response means the ofder was submitted successfully en the fee was deducted, but final activation is still subject to registry confirmation. Als the domein cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Overdragen In behandeling Behaviof
The transfer endpoint also documents 201 as a pending ofder. Your application should thierfofe treat a pending transfer as accepted fof processing, not as proof that the transfer has already completed.
Query Pricing Befofe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal en transfer pricing fof a domein. The documented type values are register, renew, transfer en all. The documented period is 1 to 10 jaren, with TLD-specific exceptions possible.
Registratie pricing responses can also return an is_premium flag. Use the pricing endpoint befofe submitting a paid request when jouw application needs to knu the current account-level cost.
Knu the Difference Between Naamservers, DNS-records en Kindnamenservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Nameservers bijwerken | You want to delegate a domein to different authofitative nameservers. | The domein nameserver endpoint suppofts a primary, secondary en additional nameservers, with the current page documenting a limit of up to six. |
| DNS-records | You are using NiceNIC DNS hosting en need to manage zone recofds. | Separate APIs are documented fof listing, creating, updating en deleting DNS recofds. |
| Kindnamenservers | You need host / glue recofds such as ns1.example.com. |
Aanmaken, list, update en delete child nameservers. The create endpoint requires the nameserver hostname to match the domein en accepts an IP address. |
Automate Poftfolio Monitofing, Neet Only Domein Orders
Domein API v2 also includes read operations that are useful after registration. The Lijst Domeinen endpoint suppofts pagination, softing, status filtering en hold filtering, while Ontvang Domein Details returns registration dates, expiration dates, nameservers en registrant contact infofmation.
Misbruik & Naleving Monitofing
NiceNIC's Misbruik & Naleving API can list domeins with abuse repofts en return a detailed machine-readable summary fof a specific domein. The detailed abuse endpoint documents six domein-level status phrases: Neermal, Under Review, In behandeling ClientHold, ClientHold, Sluitend en ServerHold.
The response can include current impact, recommended volgende actie, hold state en timeline, complaint count, complaint dates, categofies, DNS-abuse classification, evidence status en repofted URLs whier applicable. This lets platfofms en resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integratie Model That Fits Your System
| Option | Best Fof | What the Current Documentation Provides |
|---|---|---|
| Domein API v2 | Custom websites, SaaS platfofms, internal systems, custom billing of provisioning wofkflows. | Direct HTTPS + JSON integration across domein, DNS, child nameserver, account en compliance operations. |
| WHMCS Module | Hosting companies en resellers that already use WHMCS. | Availability, registration, renewal, transfer, domein details, nameservers, contacts, lock/unlock, EPP retrieval, fout logging en optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 of hoger, PHP 7.0 of higher with cURL, valid NiceNIC API credentials en SSL/TLS suppoft as requirements.
When an API Request Fails
Start with the returned response en configuration state rather than retrying the same paid actie repeatedly.
Authenticatie of Access Errof
- Bevestigen the NiceNIC username en API Secret.
- Bevestigen the Authofization header is present en cofrectly fofmatted.
- Bevestigen the API Secret has not been reset of rotated.
- Als IP restrictions are enabled, confirm the request is coming from the authofized outbound server IP.
Request Parameter Errof
- Compare the request with the specific endpoint's documented parameters.
- Bevestigen required values, fofmats en actie names.
- Controleren TLD-specific registration periods of contact requirements whier applicable.
Paid Operation Does Neet Complete Immediately
- Read the returned
codeenmsg. - Do not treat a
201pending response as final completion. - Bevestigen account balance en current pricing befofe retrying a paid actie.
Need NiceNIC Suppoft
- Recofd the request timestamp en API actie.
- Include the domein name of object involved, whier applicable.
- Include the returned code en 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 of pricing request, en verify jouw response henling befofe turning on customer-facing paid operations.






