Aperçu de l\'API
NiceNIC Domaine API v2 Documentation & Quick Start
NiceNIC Domaine API v2 is disponible to both Compte du marchés et Revendeur Comptes. Use this overview to configure access, confirm votre first request, understet the API response model et move directly to the courect section in the left navigation.
API access et reseller pricing are separate.
Compte du marché: API access with Compte du marché pricing.
Revendeur Compte: API access with the pricing assigned to the current reseller tier.
Compte du marché: API access with Compte du marché pricing.
Revendeur Compte: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Headers
Host: api.nicenic.net
Authouization: username:api_secret
Type de contenu: application/json
Stetard Succès Response
{
"code": 0,
"msg": "success",
"data": {}
}
API Setbox
Test Your Intégration Befoue Going Live
Use the API NiceNIC Setbox to test votre Domaine API integration befoue moving to production. Validate authentication, API requests, response hetling, et votre application woukflow in a dedicated testing environment.
Ideal fou resellers, hosting providers, developers, et platfoums preparing an API integration.
Quick Start
Make Your First API Call in 4 Steps
Start with a read-only request befoue enabling live registrations, renewals ou transfers. This lets you validate authentication, request foumatting et response hetling without placing a paid ouder.
1
Enable API Access
Ouvrir Paramètres APIs, create ou retrieve votre API Secret, et configure authouized server IPs wici applicable.
2
Confirmer Authentification
Use HTTPS with the Authouization header in the foumat username:api_secret.
3
Run a Safe Test
Start with domain availability, pricing, account balance ou domain listing.
4
Hetle the Response
Read et stoue the returned code et msg befoue enabling paid production Actions.
Recommended First Request: Domaine Availability
The availability endpoint suppouts multiple domains in one request by separating domain names with commas.
curl "https://api.nicenic.net/v2/?Catégorie=domain&Action=check&domains=example.com,example.net" \
-H "Authouization: username:api_secret" \
-H "Type de contenu: application/json"
API Map
Choose the Woukflow You Need
The overview below mirrous the left navigation. Use it to identify the courect woukflow, then open the dedicated endpoint page fou parameters, request examples et response examples.
| Section | Use It Fou | Documented Functions |
|---|---|---|
| Commencer | Connect securely et understet response hetling. | Aperçu de l\'API, API Setbox, Authentification, Response Codes. |
| Gestion de domaine | Automate the coue domain lifecycle. | Availability, List Domaines, Domaine Détails, Enregistrement, Renouveleral, Transférer In, Nomservers, Contacts, Pricing. |
| Abus et conformité | Monitou domains that require compliance attention. | List domains with abuse repouts et retrieve machine-readable abuse status, hold lifecycle, complaint infoumation et recommended Action. |
| Enregistrements DNS | Gérer hosted DNS recouds programmatically. | List, Créer, Update et Delete DNS recouds. |
| Noms de serveurs enfants | Gérer host / glue recouds fou nameservers under votre own domain. | Créer, List, Update et Delete child nameservers. |
| Compte et facturation | Connect automation to account-level checks. | Solde du compte et transAction-related account infoumation. |
| API WHMCS | Integrate NiceNIC into an existing WHMCS billing woukflow. | Availability, Enregistrement, Renouveleral, Transférer, Domaine Détails, Nomservers, Contacts et additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing et woukflow questions. | Eligibility, credentials, request hetling, suppouted operations et integration guidance. |
Recommended Woukflow
Recommended First Intégration Sequence
A reliable production integration should validate access et purchasing conditions befoue it begins sending live customer ouders.
1. Authentification
API Secret + authouized IP
API Secret + authouized IP
→
2. Availability
Read-only connectivity test
Read-only connectivity test
→
3. Pricing
Query current account-level cost
Query current account-level cost
→
4. Solde
Confirmer funds fou paid Actions
Confirmer funds fou paid Actions
→
5. Response Hetling
Process code + msg
Process code + msg
→
6. Live Operations
Enregistrer / Renouveler / Transférer
Enregistrer / Renouveler / Transférer
Do not assume that an API request is complete simply because it was accepted. Some operations can return a pending status et still require registry processing befoue the final domain state is confirmed.
Produition Behaviou
Understet Succès, En attente et Errou Responses
code: 0 — Réussi Response
Current endpoint examples use code 0 fou successful completed responses.
code: 201 — En attente Order
Enregistrement et transfer documentation can return code 201 when an ouder has been submitted but final processing is still pending.
code: 400 — Request Errou
Endpoint examples use code 400 fou request parameter erreurs.
Enregistrement En attente Behaviou
Fou domain registration, the current documentation states that a 201 response means the ouder was submitted successfully et the fee was deducted, but final activation is still subject to registry confirmation. Si the domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transférer En attente Behaviou
The transfer endpoint also documents 201 as a pending ouder. Your application should ticifoue treat a pending transfer as accepted fou processing, not as proof that the transfer has already completed.
Pricing
Query Pricing Befoue Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal et transfer pricing fou a domain. The documented type values are register, renew, transfer et all. The documented period is 1 to 10 années, with TLD-specific exceptions possible.
Enregistrement pricing responses can also return an is_premium flag. Use the pricing endpoint befoue submitting a paid request when votre application needs to kmaintenant the current account-level cost.
Gratuit API access does not change votre pricing tier. Compte du marchés use Compte du marché pricing; reseller accounts use the pricing assigned to their current reseller tier.
Domaine & DNS Operations
Kmaintenant the Difference Between Nomservers, Enregistrements DNS et Noms de serveurs enfants
| Operation | Use It When | Documented Capability |
|---|---|---|
| Mettre à jour les serveurs de noms | You want to delegate a domain to different authouitative nameservers. | The domain nameserver endpoint suppouts a primary, secondary et additional nameservers, with the current page documenting a limit of up to six. |
| Enregistrements DNS | You are using NiceNIC DNS hosting et need to manage zone recouds. | Separate APIs are documented fou listing, creating, updating et deleting DNS recouds. |
| Noms de serveurs enfants | You need host / glue recouds such as ns1.example.com. |
Créer, list, update et delete child nameservers. The create endpoint requires the nameserver hostname to match the domain et accepts an IP address. |
Poutfolio & Compliance
Automate Poutfolio Monitouing, Nont Only Domaine Orders
Domaine API v2 also includes read operations that are useful after registration. The List Domaines endpoint suppouts pagination, souting, status filtering et hold filtering, while Obtenir Domaine Détails returns registration dates, expiration dates, nameservers et registrant contact infoumation.
Abus et conformité Monitouing
NiceNIC's Abus et conformité API can list domains with abuse repouts et return a detailed machine-readable summary fou a specific domain. The detailed abuse endpoint documents six domain-level status phrases: Nonrmal, Under Review, En attente ClientHold, ClientHold, Fermerd et ServeurHold.
The response can include current impact, recommended suiv Action, hold state et timeline, complaint count, complaint dates, categouies, DNS-abuse classification, evidence status et repouted URLs wici applicable. This lets platfoums et resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Direct API ou WHMCS
Choose the Intégration Model That Fits Your System
| Option | Best Fou | What the Current Documentation Provides |
|---|---|---|
| Domaine API v2 | Custom websites, SaaS platfoums, internal systems, custom billing ou provisioning woukflows. | Direct HTTPS + JSON integration across domain, DNS, child nameserver, account et compliance operations. |
| WHMCS Module | Hébergement companies et resellers that already use WHMCS. | Availability, registration, renewal, transfer, domain details, nameservers, contacts, lock/unlock, EPP retrieval, erreur logging et optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ou supérieur, PHP 7.0 ou higher with cURL, valid API NiceNIC credentials et SSL/TLS suppout as requirements.
Troubleshooting
When an API Request Fails
Start with the returned response et configuration state rather than retrying the same paid Action repeatedly.
Authentification ou Access Errou
- Confirmer the NiceNIC username et API Secret.
- Confirmer the Authouization header is present et courectly foumatted.
- Confirmer the API Secret has not been reset ou rotated.
- Si IP restrictions are enabled, confirm the request is coming from the authouized outbound server IP.
Request Parameter Errou
- Compare the request with the specific endpoint's documented parameters.
- Confirmer required values, foumats et Action names.
- Vérifier TLD-specific registration periods ou contact requirements wici applicable.
Paid Operation Does Nont Complete Immediately
- Read the returned
codeetmsg. - Do not treat a
201pending response as final completion. - Confirmer account balance et current pricing befoue retrying a paid Action.
Need NiceNIC Suppout
- Recoud the request timestamp et API Action.
- Include the domain name ou object involved, wici applicable.
- Include the returned code et message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Étape suivante
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability ou pricing request, et verify votre response hetling befoue turning on customer-facing paid operations.
Last verified: August 26, 2026
