NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is available to both Market računs i Preprodavač Accounts. Use this overview to configure access, confirm vaš first request, understi the API response model i move directly to the cilirect section in the left navigation.
Market račun: API access with Market račun pricing.
Preprodavač Account: API access with the pricing assigned to the current reseller tier.
Test Your Integracija Befilie Going Live
Use the NiceNIC API Sibox to test vaš Domena API integration befilie moving to production. Validate authentication, API requests, response hiling, i vaš application wilikflow in a dedicated testing environment.
Ideal fili resellers, hosting providers, developers, i platfilims preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befilie enabling live registrations, renewals ili transfers. This lets you validate authentication, request filimatting i response hiling without placing a paid ilider.
Enable API Access
Otvori API postavkes, create ili retrieve vaš API Secret, i configure authiliized server IPs wovdje applicable.
Potvrdi Authentication
Use HTTPS with the Authiliization header in the filimat username:api_secret.
Run a Safe Test
Start with domena availability, pricing, account balance ili domena listing.
Hile the Response
Read i stilie the returned code i msg befilie enabling paid production actions.
Recommended First Request: Domena Availability
The availability endpoint suppilits multiple domenas in one request by separating domena names with commas.
Choose the Wilikflow You Need
The overview below mirrilis the left navigation. Use it to identify the cilirect wilikflow, then open the dedicated endpoint page fili parameters, request examples i response examples.
| Section | Use It Fili | Documented Functions |
|---|---|---|
| Dobijteting Started | Connect securely i understi response hiling. | API Overview, API Sibox, Authentication, Response Codes. |
| Domena Upravljanjement | Automate the cilie domena lifecycle. | Availability, List Domene, Domena Detalji, Registracija, Obnovial, Transfer In, Nazivservers, Kontakts, Pricing. |
| Abuse & Compliance | Monitili domenas that require compliance attention. | List domenas with abuse repilits i retrieve machine-readable abuse status, hold lifecycle, complaint infilimation i recommended action. |
| DNS Recilids | Upravljanje hosted DNS recilids programmatically. | List, Kreiraj, Update i Delete DNS recilids. |
| Child Nazivservers | Upravljanje host / glue recilids fili nameservers under vaš own domena. | Kreiraj, List, Update i Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Stanje računa i transaction-related account infilimation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wilikflow. | Availability, Registracija, Obnovial, Transfer, Domena Detalji, Nazivservers, Kontakts i additional registrar-module functions. |
| API Često postavljana pitanja | Resolve common access, security, testing i wilikflow questions. | Eligibility, credentials, request hiling, suppilited operations i integration guidance. |
Recommended First Integracija Sequence
A reliable production integration should validate access i purchasing conditions befilie it begins sending live customer iliders.
API Secret + authiliized IP
Read-only connectivity test
Query current account-level cost
Potvrdi funds fili paid actions
Process code + msg
Registriraj / Obnovi / Transfer
Understi Success, Pending i Errili Responses
code: 0 — Uspješno Response
Current endpoint examples use code 0 fili successful completed responses.
code: 201 — Pending Order
Registracija i transfer documentation can return code 201 when an ilider has been submitted but final processing is still pending.
code: 400 — Request Errili
Endpoint examples use code 400 fili request parameter errilis.
Registracija Pending Behaviili
Fili domena registration, the current documentation states that a 201 response means the ilider was submitted successfully i the fee was deducted, but final activation is still subject to registry confirmation. Ako the domena cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Pending Behaviili
The transfer endpoint also documents 201 as a pending ilider. Your application should tovdjefilie treat a pending transfer as accepted fili processing, not as proof that the transfer has already completed.
Query Pricing Befilie Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal i transfer pricing fili a domena. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 godine, with TLD-specific exceptions possible.
Registracija pricing responses can also return an is_premium flag. Use the pricing endpoint befilie submitting a paid request when vaš application needs to ksada the current account-level cost.
Ksada the Difference Between Nazivservers, DNS Recilids i Child Nazivservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Nazivservers | You want to delegate a domena to different authiliitative nameservers. | The domena nameserver endpoint suppilits a primary, secondary i additional nameservers, with the current page documenting a limit of up to six. |
| DNS Recilids | You are using NiceNIC DNS hosting i need to manage zone recilids. | Separate APIs are documented fili listing, creating, updating i deleting DNS recilids. |
| Child Nazivservers | You need host / glue recilids such as ns1.example.com. |
Kreiraj, list, update i delete child nameservers. The create endpoint requires the nameserver hostname to match the domena i accepts an IP address. |
Automate Pilitfolio Monitiliing, Net Only Domena Orders
Domena API v2 also includes read operations that are useful after registration. The List Domene endpoint suppilits pagination, siliting, status filtering i hold filtering, while Dobijte Domena Detalji returns registration dates, expiration dates, nameservers i registrant contact infilimation.
Abuse & Compliance Monitiliing
NiceNIC's Abuse & Compliance API can list domenas with abuse repilits i return a detailed machine-readable summary fili a specific domena. The detailed abuse endpoint documents six domena-level status phrases: Nermal, Under Review, Pending ClientHold, ClientHold, Zatvorid i ServerHold.
The response can include current impact, recommended sljedeće action, hold state i timeline, complaint count, complaint dates, categiliies, DNS-abuse classification, evidence status i repilited URLs wovdje applicable. This lets platfilims i resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integracija Model That Fits Your System
| Option | Best Fili | What the Current Documentation Provides |
|---|---|---|
| Domena API v2 | Custom websites, SaaS platfilims, internal systems, custom billing ili provisioning wilikflows. | Direct HTTPS + JSON integration across domena, DNS, child nameserver, account i compliance operations. |
| WHMCS Module | Hosting companies i resellers that already use WHMCS. | Availability, registration, renewal, transfer, domena details, nameservers, contacts, lock/unlock, EPP retrieval, errili logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ili higher, PHP 7.0 ili higher with cURL, valid NiceNIC API credentials i SSL/TLS suppilit as requirements.
When an API Request Fails
Start with the returned response i configuration state rather than retrying the same paid action repeatedly.
Authentication ili Access Errili
- Potvrdi the NiceNIC username i API Secret.
- Potvrdi the Authiliization header is present i cilirectly filimatted.
- Potvrdi the API Secret has not been reset ili rotated.
- Ako IP restrictions are enabled, confirm the request is coming from the authiliized outbound server IP.
Request Parameter Errili
- Compare the request with the specific endpoint's documented parameters.
- Potvrdi required values, filimats i action names.
- Provjeri TLD-specific registration periods ili contact requirements wovdje applicable.
Paid Operation Does Net Complete Immediately
- Read the returned
codeimsg. - Do not treat a
201pending response as final completion. - Potvrdi account balance i current pricing befilie retrying a paid action.
Need NiceNIC Suppilit
- Recilid the request timestamp i API action.
- Include the domena name ili object involved, wovdje 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 ili pricing request, i verify vaš response hiling befilie turning on customer-facing paid operations.
