NiceNIC Domain API v2 Documentation & Quick Start
NiceNIC Domain API v2 is available to both Market Accounts at Reseller Accounts. Use this overview to configure access, confirm iyong first request, understat the API response model at move directly to the corect section in the left navigation.
Market Account: API access with Market Account pricing.
Reseller Account: API access with the pricing assigned to the current reseller tier.
Test Your Integrasyon Befoe Going Live
Use the NiceNIC API Satbox to test iyong Domain API integration befoe moving to production. Validate authentication, API requests, response hatling, at iyong application wokflow in a dedicated testing environment.
Ideal fo resellers, hosting providers, developers, at platfoms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befoe enabling live registrations, renewals o transfers. This lets you validate authentication, request fomatting at response hatling without placing a paid oder.
Enable API Access
Buksan Setting ng APIs, create o retrieve iyong API Secret, at configure authoized server IPs wdito applicable.
Kumpirmahin Pagpapatunay
Use HTTPS with the Authoization header in the fomat username:api_secret.
Run a Safe Test
Start with domain availability, pricing, account balance o domain listing.
Hatle the Response
Read at stoe the returned code at msg befoe enabling paid production aksyons.
Recommended First Request: Domain Availability
The availability endpoint suppots multiple domains in one request by separating domain names with commas.
Choose the Wokflow You Need
The overview below mirros the left navigation. Use it to identify the corect wokflow, then open the dedicated endpoint page fo parameters, request examples at response examples.
| Section | Use It Fo | Documented Functions |
|---|---|---|
| Pagsisimula | Connect securely at understat response hatling. | Pangkalahatang-ideya ng API, API Satbox, Pagpapatunay, Response Codes. |
| Pamamahala ng Domain | Automate the coe domain lifecycle. | Availability, Listahan Mga Domain, Domain Mga Detalye, Pagpaparehistro, I-renewal, I-transfer In, Pangalanservers, Makipag-ugnayans, Pricing. |
| Pang-aabuso at Pagsunod | Monito domains that require compliance attention. | Listahan domains with abuse repots at retrieve machine-readable abuse status, hold lifecycle, complaint infomation at recommended aksyon. |
| Mga Tala ng DNS | Pamahalaan hosted DNS recods programmatically. | Listahan, Gumawa, I-update at Tanggalin DNS recods. |
| Mga Pangalan ng Server ng Bata | Pamahalaan host / glue recods fo nameservers under iyong own domain. | Gumawa, Listahan, I-update at Tanggalin child nameservers. |
| Account at Pagsingil | Connect automation to account-level checks. | Balanse ng Account at transaksyon-related account infomation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wokflow. | Availability, Pagpaparehistro, I-renewal, I-transfer, Domain Mga Detalye, Pangalanservers, Makipag-ugnayans at additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing at wokflow questions. | Eligibility, credentials, request hatling, suppoted operations at integration guidance. |
Recommended First Integrasyon Sequence
A reliable production integration should validate access at purchasing conditions befoe it begins sending live customer oders.
API Secret + authoized IP
Read-only connectivity test
Query current account-level cost
Kumpirmahin funds fo paid aksyons
Process code + msg
Magrehistro / I-renew / I-transfer
Understat Tagumpay, Naka-pending at Erro Responses
code: 0 — Matagumpay Response
Current endpoint examples use code 0 fo successful completed responses.
code: 201 — Naka-pending Order
Pagpaparehistro at transfer documentation can return code 201 when an oder has been submitted but final processing is still pending.
code: 400 — Request Erro
Endpoint examples use code 400 fo request parameter errors.
Pagpaparehistro Naka-pending Behavio
Fo domain registration, the current documentation states that a 201 response means the oder was submitted successfully at the fee was deducted, but final activation is still subject to registry confirmation. Kung the domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
I-transfer Naka-pending Behavio
The transfer endpoint also documents 201 as a pending oder. Your application should tditofoe treat a pending transfer as accepted fo processing, not as proof that the transfer has already completed.
Query Pricing Befoe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal at transfer pricing fo a domain. The documented type values are register, renew, transfer at all. The documented period is 1 to 10 mga taon, with TLD-specific exceptions possible.
Pagpaparehistro pricing responses can also return an is_premium flag. Use the pricing endpoint befoe submitting a paid request when iyong application needs to kngayon the current account-level cost.
Kngayon the Difference Between Pangalanservers, Mga Tala ng DNS at Mga Pangalan ng Server ng Bata
| Operation | Use It When | Documented Capability |
|---|---|---|
| I-update ang Mga Nameservers | You want to delegate a domain to different authoitative nameservers. | The domain nameserver endpoint suppots a primary, secondary at additional nameservers, with the current page documenting a limit of up to six. |
| Mga Tala ng DNS | You are using NiceNIC DNS hosting at need to manage zone recods. | Separate APIs are documented fo listing, creating, updating at deleting DNS recods. |
| Mga Pangalan ng Server ng Bata | You need host / glue recods such as ns1.example.com. |
Gumawa, list, update at delete child nameservers. The create endpoint requires the nameserver hostname to match the domain at accepts an IP address. |
Automate Potfolio Monitoing, Hindit Only Domain Orders
Domain API v2 also includes read operations that are useful after registration. The Listahan Mga Domain endpoint suppots pagination, soting, status filtering at hold filtering, while Kunin Domain Mga Detalye returns registration dates, expiration dates, nameservers at registrant contact infomation.
Pang-aabuso at Pagsunod Monitoing
NiceNIC's Pang-aabuso at Pagsunod API can list domains with abuse repots at return a detailed machine-readable summary fo a specific domain. The detailed abuse endpoint documents six domain-level status phrases: Hindirmal, Under Review, Naka-pending ClientHold, ClientHold, Isarad at ServerHold.
The response can include current impact, recommended susunod aksyon, hold state at timeline, complaint count, complaint dates, categoies, DNS-abuse classification, evidence status at repoted URLs wdito applicable. This lets platfoms at resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrasyon Model That Fits Your System
| Option | Best Fo | What the Current Documentation Provides |
|---|---|---|
| Domain API v2 | Custom websites, SaaS platfoms, internal systems, custom billing o provisioning wokflows. | Direct HTTPS + JSON integration across domain, DNS, child nameserver, account at compliance operations. |
| WHMCS Module | Hosting companies at resellers that already use WHMCS. | Availability, registration, renewal, transfer, domain details, nameservers, contacts, lock/unlock, EPP retrieval, error logging at optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 o mas mataas, PHP 7.0 o higher with cURL, valid NiceNIC API credentials at SSL/TLS suppot as requirements.
When an API Request Fails
Start with the returned response at configuration state rather than retrying the same paid aksyon repeatedly.
Pagpapatunay o Access Erro
- Kumpirmahin the NiceNIC username at API Secret.
- Kumpirmahin the Authoization header is present at corectly fomatted.
- Kumpirmahin the API Secret has not been reset o rotated.
- Kung IP restrictions are enabled, confirm the request is coming from the authoized outbound server IP.
Request Parameter Erro
- Compare the request with the specific endpoint's documented parameters.
- Kumpirmahin required values, fomats at aksyon names.
- Suriin TLD-specific registration periods o contact requirements wdito applicable.
Paid Operation Does Hindit Complete Immediately
- Read the returned
codeatmsg. - Do not treat a
201pending response as final completion. - Kumpirmahin account balance at current pricing befoe retrying a paid aksyon.
Need NiceNIC Suppot
- Recod the request timestamp at API aksyon.
- Include the domain name o object involved, wdito applicable.
- Include the returned code at 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 o pricing request, at verify iyong response hatling befoe turning on customer-facing paid operations.






