DomainHub Reseller API
REST API for domain resellers. API keys are self-service for every active customer account. Purchases are charged to your DomainHub wallet using your account's applicable pricing.
Base URL: https://1s.itrakin.com/api/v1 · JSON · HTTPS required
1. Authentication and limits
Authorization: Bearer dh_your_api_key
Create and revoke keys under Customer account → API Keys. The full key is displayed only once. Never put it in browser-side JavaScript or public repositories. Limits: 120 requests/minute, 60 availability checks/minute and 30 purchase requests/minute per key.
2. Domain availability
GET /check.php?domain=example.com
{"domain":"example.com","available":true,"price_per_year":10.99,"currency":"USD","premium":false,"blocked":false,"registrar_unavailable":false}
3. Wallet and domains
GET /balance.php returns wallet balance. GET /domains.php lists only domains belonging to the authenticated customer. GET /order.php?id=123 returns the specified customer's order and items.
4. Register a domain
POST /register.php
Every purchase request must include a unique Idempotency-Key header (8–80 letters, numbers, underscore or hyphen). Reuse the same value only when retrying the same request after a timeout.
Idempotency-Key: register-example-0001
Content-Type: application/json
{"domain":"example.com","years":1,"contact":{"name":"Jane Doe","org":"","address":"1 Main St","city":"Dhaka","state":"Dhaka","postal":"1212","country":"BD","phone":"+880.1712345678"}}
5. Renew a domain
POST /renew.php — same idempotency and contact-free body:
{"domain":"example.com","years":1}
6. Transfer a domain in
POST /transfer.php — provide EPP/auth code and registrant contact:
{"domain":"example.com","auth_code":"EPP-CODE-HERE","contact":{"name":"Jane Doe","org":"","address":"1 Main St","city":"Dhaka","state":"Dhaka","postal":"1212","country":"BD","phone":"+880.1712345678"}}
7. Nameservers
PUT /nameservers.php
{"domain":"example.com","nameservers":["ns1.example.net","ns2.example.net"]}
8. DNS records
GET /dns.php?domain=example.com reads records. PUT /dns.php replaces the record set on registrars that support DNS API:
{"domain":"example.com","records":[{"type":"A","host":"@","value":"203.0.113.10","ttl":1800},{"type":"CNAME","host":"www","value":"example.com","ttl":1800}]}
Supported editable record types: A, AAAA, CNAME, MX and TXT. DNS support depends on the connected registrar; unsupported providers return HTTP 501.
9. Auto-renew
PATCH /autorenew.php
{"domain":"example.com","enabled":true}
10. Responses and billing
Purchase responses include order ID, status, total, line items and remaining wallet balance. HTTP 402 means insufficient wallet balance; 401 invalid/revoked key; 404 resource not owned/not found; 409 request still processing; 429 rate limit; 501 registrar feature unsupported. Orders may be processing/review/hold while the registrar or risk checks finish. An uncertain registrar outcome is not automatically retried at another registrar. Do not assume a domain is registered until the order item status is active.
Amounts are in USD. Only actual order checkout totals are charged; availability quotes are indicative and can change before purchase. Ensure your wallet has enough balance before making purchases.
Example cURL
curl -X POST 'https://1s.itrakin.com/api/v1/register.php' \
-H 'Authorization: Bearer dh_your_api_key' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: register-example-0001' \
--data '{"domain":"example.com","years":1,"contact":{"name":"Jane Doe","address":"1 Main St","city":"Dhaka","state":"Dhaka","postal":"1212","country":"BD","phone":"+880.1712345678"}}'