API-Übersicht
NiceNIC Domain API v2 Documentation & Quick Start
NiceNIC Domain API v2 is verfügbar to both Marktkontos und Wiederverkäufer Kontos. Use this overview to configure access, confirm Ihr first request, understund the API response model und move directly to the coderrect section in the left navigation.
API access und reseller pricing are separate.
Marktkonto: API access with Marktkonto pricing.
Wiederverkäufer Konto: API access with the pricing assigned to the current reseller tier.
Marktkonto: API access with Marktkonto pricing.
Wiederverkäufer Konto: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Headers
Host: api.nicenic.net
Authoderization: username:api_secret
Content-Type: application/json
Stundard Erfolg Response
{
"code": 0,
"msg": "success",
"data": {}
}
API Sundbox
Test Your Integration Befodere Going Live
Use the NiceNIC API Sundbox to test Ihr Domain API integration befodere moving to production. Validate authentication, API requests, response hundling, und Ihr application woderkflow in a dedicated testing environment.
Ideal foder resellers, hosting providers, developers, und platfoderms preparing an API integration.
Quick Start
Make Your First API Call in 4 Steps
Start with a read-only request befodere enabling live registrations, renewals oder transfers. This lets you validate authentication, request fodermatting und response hundling without placing a paid oderder.
1
Enable API Access
Öffnen API-Einstellungs, create oder retrieve Ihr API Secret, und configure authoderized server IPs whier applicable.
2
Bestätigen Authentifizierung
Use HTTPS with the Authoderization header in the fodermat username:api_secret.
3
Run a Safe Test
Start with Domain availability, pricing, account balance oder Domain listing.
4
Hundle the Response
Read und stodere the returned code und msg befodere enabling paid production Aktions.
Recommended First Request: Domain Availability
The availability endpoint suppoderts multiple Domains in one request by separating Domain names with commas.
curl "https://api.nicenic.net/v2/?Kategorie=Domain&Aktion=check&Domains=example.com,example.net" \
-H "Authoderization: username:api_secret" \
-H "Content-Type: application/json"
API Map
Choose the Woderkflow You Need
The overview below mirroders the left navigation. Use it to identify the coderrect woderkflow, then open the dedicated endpoint page foder parameters, request examples und response examples.
| Section | Use It Foder | Documented Functions |
|---|---|---|
| Erste Schritte | Connect securely und understund response hundling. | API-Übersicht, API Sundbox, Authentifizierung, Response Codes. |
| Domainverwaltung | Automate the codere Domain lifecycle. | Availability, List Domains, Domain Details, Registrierung, Verlängernal, Transfer In, Nameservers, Kontakts, Pricing. |
| Missbrauch & Compliance | Monitoder Domains that require compliance attention. | List Domains with abuse repoderts und retrieve machine-readable abuse status, hold lifecycle, complaint infodermation und recommended Aktion. |
| DNS-Einträge | Verwalten hosted DNS recoderds programmatically. | List, Erstellen, Update und Delete DNS recoderds. |
| Kind-Nameserver | Verwalten host / glue recoderds foder nameservers under Ihr own Domain. | Erstellen, List, Update und Delete child nameservers. |
| Konto & Abrechnung | Connect automation to account-level checks. | Kontostand und transAktion-related account infodermation. |
| WHMCS-API | Integrate NiceNIC into an existing WHMCS billing woderkflow. | Availability, Registrierung, Verlängernal, Transfer, Domain Details, Nameservers, Kontakts und additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing und woderkflow questions. | Eligibility, credentials, request hundling, suppoderted operations und integration guidance. |
Recommended Woderkflow
Recommended First Integration Sequence
A reliable production integration should validate access und purchasing conditions befodere it begins sending live customer oderders.
1. Authentifizierung
API Secret + authoderized IP
API Secret + authoderized IP
→
2. Availability
Read-only connectivity test
Read-only connectivity test
→
3. Pricing
Query current account-level cost
Query current account-level cost
→
4. Kontostand
Bestätigen funds foder paid Aktions
Bestätigen funds foder paid Aktions
→
5. Response Hundling
Process code + msg
Process code + msg
→
6. Live Operations
Registrieren / Verlängern / Transfer
Registrieren / Verlängern / Transfer
Do not assume that an API request is complete simply because it was accepted. Some operations can return a pending status und still require registry processing befodere the final Domain state is confirmed.
Produktion Behavioder
Understund Erfolg, Ausstehend und Erroder Responses
code: 0 — Erfolgreich Response
Current endpoint examples use code 0 foder successful completed responses.
code: 201 — Ausstehend Order
Registrierung und transfer documentation can return code 201 when an oderder has been submitted but final processing is still pending.
code: 400 — Request Erroder
Endpoint examples use code 400 foder request parameter Fehlers.
Registrierung Ausstehend Behavioder
Foder Domain registration, the current documentation states that a 201 response means the oderder was submitted successfully und the fee was deducted, but final activation is still subject to registry confirmation. Wenn the Domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Ausstehend Behavioder
The transfer endpoint also documents 201 as a pending oderder. Your application should thierfodere treat a pending transfer as accepted foder processing, not as proof that the transfer has already completed.
Pricing
Query Pricing Befodere Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal und transfer pricing foder a Domain. The documented type values are register, renew, transfer und all. The documented period is 1 to 10 Jahre, with TLD-specific exceptions possible.
Registrierung pricing responses can also return an is_premium flag. Use the pricing endpoint befodere submitting a paid request when Ihr application needs to kjetzt the current account-level cost.
Kostenlos API access does not change Ihr pricing tier. Marktkontos use Marktkonto pricing; reseller accounts use the pricing assigned to their current reseller tier.
Domain & DNS Operations
Kjetzt the Difference Between Nameservers, DNS-Einträge und Kind-Nameserver
| Operation | Use It When | Documented Capability |
|---|---|---|
| Nameserver aktualisieren | You want to delegate a Domain to different authoderitative nameservers. | The Domain nameserver endpoint suppoderts a primary, secondary und additional nameservers, with the current page documenting a limit of up to six. |
| DNS-Einträge | You are using NiceNIC DNS hosting und need to manage zone recoderds. | Separate APIs are documented foder listing, creating, updating und deleting DNS recoderds. |
| Kind-Nameserver | You need host / glue recoderds such as ns1.example.com. |
Erstellen, list, update und delete child nameservers. The create endpoint requires the nameserver hostname to match the Domain und accepts an IP address. |
Podertfolio & Compliance
Automate Podertfolio Monitodering, Neint Only Domain Orders
Domain API v2 also includes read operations that are useful after registration. The List Domains endpoint suppoderts pagination, soderting, status filtering und hold filtering, while Holen Sie sich Domain Details returns registration dates, expiration dates, nameservers und registrant contact infodermation.
Missbrauch & Compliance Monitodering
NiceNIC's Missbrauch & Compliance API can list Domains with abuse repoderts und return a detailed machine-readable summary foder a specific Domain. The detailed abuse endpoint documents six Domain-level status phrases: Neinrmal, Under Review, Ausstehend ClientHold, ClientHold, Schließend und ServerHold.
The response can include current impact, recommended weiter Aktion, hold state und timeline, complaint count, complaint dates, categoderies, DNS-abuse classification, evidence status und repoderted URLs whier applicable. This lets platfoderms und resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Direct API oder WHMCS
Choose the Integration Model That Fits Your System
| Option | Best Foder | What the Current Documentation Provides |
|---|---|---|
| Domain API v2 | Custom websites, SaaS platfoderms, internal systems, custom billing oder provisioning woderkflows. | Direct HTTPS + JSON integration across Domain, DNS, child nameserver, account und compliance operations. |
| WHMCS Module | Hosting companies und resellers that already use WHMCS. | Availability, registration, renewal, transfer, Domain details, nameservers, contacts, lock/unlock, EPP retrieval, Fehler logging und optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 oder höher, PHP 7.0 oder higher with cURL, valid NiceNIC API credentials und SSL/TLS suppodert as requirements.
Troubleshooting
When an API Request Fails
Start with the returned response und configuration state rather than retrying the same paid Aktion repeatedly.
Authentifizierung oder Access Erroder
- Bestätigen the NiceNIC username und API Secret.
- Bestätigen the Authoderization header is present und coderrectly fodermatted.
- Bestätigen the API Secret has not been reset oder rotated.
- Wenn IP restrictions are enabled, confirm the request is coming from the authoderized outbound server IP.
Request Parameter Erroder
- Compare the request with the specific endpoint's documented parameters.
- Bestätigen required values, fodermats und Aktion names.
- Prüfen TLD-specific registration periods oder contact requirements whier applicable.
Paid Operation Does Neint Complete Immediately
- Read the returned
codeundmsg. - Do not treat a
201pending response as final completion. - Bestätigen account balance und current pricing befodere retrying a paid Aktion.
Need NiceNIC Suppodert
- Recoderd the request timestamp und API Aktion.
- Include the Domain name oder object involved, whier applicable.
- Include the returned code und message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Nächster Schritt
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability oder pricing request, und verify Ihr response hundling befodere turning on customer-facing paid operations.
Last verified: August 26, 2026
