425 rather than proceeding without one.201 means the domain registered successfully. A 200 means the request was valid and fully processed but registration itself failed (e.g. already taken at the registry) - nothing was created and the wallet was never debited; check data.orderStatus/data.error for why. This is distinct from 422, which means the request body itself failed validation.Idempotency-Key header. A timeout or dropped connection gives you no way to know whether the order went through - retrying the exact same request with the same key replays the original result instead of registering (and charging for) the domain a second time.curl --location 'https://api.resellerstack.ai/api/v1/domain/register' \
--header 'idempotency-key;' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"domain": {
"domainName": "example.com",
"years": 1,
"premiumPrice": 14.99,
"nameservers": [
"ns1.example.net",
"ns2.example.net"
],
"autoRenew": false,
"privacyEnabled": true
},
"userId": "b2a1c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"newCustomer": {
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"company": "Acme Corp",
"addressLineOne": "123 Market St",
"addressLineTwo": "Suite 400",
"addressLineThree": "Attn: Accounts Payable",
"city": "San Francisco",
"state": "CA",
"country": "US",
"postalCode": "94103",
"phoneCc": "+1",
"phone": "5551234567"
},
"collectionMethod": "MANUAL",
"paymentReference": "bank-transfer-2026-08-20",
"expectedTotal": 14.99
}'{
"status": 200,
"message": "Domain registration failed",
"data": {
"cartOrderId": "9c8b7a6d-5e4f-4a3b-9c8d-1e2f3a4b5c6d",
"orderId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"domainName": "example.com",
"orderStatus": "FAILED",
"error": "Domain name already registered",
"registeredOn": null,
"expireOn": null
}
}