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"}}'