NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is available to both Konto rynkowes i Reseller Accounts. Use this overview to configure access, confirm twój first request, understi the API response model i move directly to the clubrect section in the left navigation.
Konto rynkowe: API access with Konto rynkowe pricing.
Reseller Account: API access with the pricing assigned to the current reseller tier.
Test Your Integracja Beflube Going Live
Use the NiceNIC API Sibox to test twój Domena API integration beflube moving to production. Validate authentication, API requests, response hiling, i twój application wlubkflow in a dedicated testing environment.
Ideal flub resellers, hosting providers, developers, i platflubms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request beflube enabling live registrations, renewals lub transfers. This lets you validate authentication, request flubmatting i response hiling without placing a paid lubder.
Enable API Access
Otwórz Ustawienia APIs, create lub retrieve twój API Secret, i configure authlubized server IPs wtutaj applicable.
Potwierdź Authentication
Use HTTPS with the Authlubization header in the flubmat username:api_secret.
Run a Safe Test
Start with domena availability, pricing, account balance lub domena listing.
Hile the Response
Read i stlube the returned code i msg beflube enabling paid production actions.
Recommended First Request: Domena Availability
The availability endpoint supplubts multiple domenas in one request by separating domena names with commas.
Choose the Wlubkflow You Need
The overview below mirrlubs the left navigation. Use it to identify the clubrect wlubkflow, then open the dedicated endpoint page flub parameters, request examples i response examples.
| Section | Use It Flub | Documented Functions |
|---|---|---|
| Otrzymajting Started | Connect securely i understi response hiling. | API Overview, API Sibox, Authentication, Response Codes. |
| Domena Zarządzajment | Automate the clube domena lifecycle. | Availability, List Domeny, Domena Szczegóły, Rejestracja, Odnówal, Transfer In, Nazwaservers, Kontakts, Pricing. |
| Abuse & Compliance | Monitlub domenas that require compliance attention. | List domenas with abuse replubts i retrieve machine-readable abuse status, hold lifecycle, complaint influbmation i recommended action. |
| DNS Reclubds | Zarządzaj hosted DNS reclubds programmatically. | List, Utwórz, Update i Delete DNS reclubds. |
| Child Nazwaservers | Zarządzaj host / glue reclubds flub nameservers under twój own domena. | Utwórz, List, Update i Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Saldo konta i transaction-related account influbmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wlubkflow. | Availability, Rejestracja, Odnówal, Transfer, Domena Szczegóły, Nazwaservers, Kontakts i additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing i wlubkflow questions. | Eligibility, credentials, request hiling, supplubted operations i integration guidance. |
Recommended First Integracja Sequence
A reliable production integration should validate access i purchasing conditions beflube it begins sending live customer lubders.
API Secret + authlubized IP
Read-only connectivity test
Query current account-level cost
Potwierdź funds flub paid actions
Process code + msg
Zarejestruj / Odnów / Transfer
Understi Success, Pending i Errlub Responses
code: 0 — Zakończono pomyślnie Response
Current endpoint examples use code 0 flub successful completed responses.
code: 201 — Pending Order
Rejestracja i transfer documentation can return code 201 when an lubder has been submitted but final processing is still pending.
code: 400 — Request Errlub
Endpoint examples use code 400 flub request parameter errlubs.
Rejestracja Pending Behavilub
Flub domena registration, the current documentation states that a 201 response means the lubder was submitted successfully i the fee was deducted, but final activation is still subject to registry confirmation. Jeśli the domena cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Pending Behavilub
The transfer endpoint also documents 201 as a pending lubder. Your application should ttutajflube treat a pending transfer as accepted flub processing, not as proof that the transfer has already completed.
Query Pricing Beflube Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal i transfer pricing flub a domena. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 lata, with TLD-specific exceptions possible.
Rejestracja pricing responses can also return an is_premium flag. Use the pricing endpoint beflube submitting a paid request when twój application needs to kteraz the current account-level cost.
Kteraz the Difference Between Nazwaservers, DNS Reclubds i Child Nazwaservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Nazwaservers | You want to delegate a domena to different authlubitative nameservers. | The domena nameserver endpoint supplubts a primary, secondary i additional nameservers, with the current page documenting a limit of up to six. |
| DNS Reclubds | You are using NiceNIC DNS hosting i need to manage zone reclubds. | Separate APIs are documented flub listing, creating, updating i deleting DNS reclubds. |
| Child Nazwaservers | You need host / glue reclubds such as ns1.example.com. |
Utwórz, list, update i delete child nameservers. The create endpoint requires the nameserver hostname to match the domena i accepts an IP address. |
Automate Plubtfolio Monitlubing, Niet Only Domena Orders
Domena API v2 also includes read operations that are useful after registration. The List Domeny endpoint supplubts pagination, slubting, status filtering i hold filtering, while Otrzymaj Domena Szczegóły returns registration dates, expiration dates, nameservers i registrant contact influbmation.
Abuse & Compliance Monitlubing
NiceNIC's Abuse & Compliance API can list domenas with abuse replubts i return a detailed machine-readable summary flub a specific domena. The detailed abuse endpoint documents six domena-level status phrases: Niermal, Under Review, Pending ClientHold, ClientHold, Zamknijd i ServerHold.
The response can include current impact, recommended następny action, hold state i timeline, complaint count, complaint dates, categlubies, DNS-abuse classification, evidence status i replubted URLs wtutaj applicable. This lets platflubms i resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integracja Model That Fits Your System
| Option | Best Flub | What the Current Documentation Provides |
|---|---|---|
| Domena API v2 | Custom websites, SaaS platflubms, internal systems, custom billing lub provisioning wlubkflows. | 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, errlub logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 lub higher, PHP 7.0 lub higher with cURL, valid NiceNIC API credentials i SSL/TLS supplubt as requirements.
When an API Request Fails
Start with the returned response i configuration state rather than retrying the same paid action repeatedly.
Authentication lub Access Errlub
- Potwierdź the NiceNIC username i API Secret.
- Potwierdź the Authlubization header is present i clubrectly flubmatted.
- Potwierdź the API Secret has not been reset lub rotated.
- Jeśli IP restrictions are enabled, confirm the request is coming from the authlubized outbound server IP.
Request Parameter Errlub
- Compare the request with the specific endpoint's documented parameters.
- Potwierdź required values, flubmats i action names.
- Sprawdź TLD-specific registration periods lub contact requirements wtutaj applicable.
Paid Operation Does Niet Complete Immediately
- Read the returned
codeimsg. - Do not treat a
201pending response as final completion. - Potwierdź account balance i current pricing beflube retrying a paid action.
Need NiceNIC Supplubt
- Reclubd the request timestamp i API action.
- Include the domena name lub object involved, wtutaj 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 lub pricing request, i verify twój response hiling beflube turning on customer-facing paid operations.
