- Cold Mail Reseller API Documentation
- Users
- Geo
- Domains
- Dns
- Orders
- Mailboxes
- Subscriptions
- Webhooks
- Export
- Pre-warmup
- Get Wallet DetailsGET
- Send errorPOST
Suggest Available Domains
POST
/domains/available
Important: Ensure the domain name is relevant and original; avoid popular, trademarked, or already established domains such as google.com,youtube.com, etc.
Request Body#
| Parameter | Type | Required | Description |
|---|---|---|---|
domainName | string | Yes | The base domain name you wish to register (without the TLD) |
tlds | array | Yes | List of top-level domains to check availability for. If not specified, a default TLD will be used. |
years | number | Yes | The number of years for domain registration. Typically for 1 year |
Allowed TLDs#
.com.net.org.biz.liveRequest
Authorization
API Key
Add parameter in header
cmr-x-api-key
Example:
cmr-x-api-key: ********************or
Body Params application/json
Example
{
"domainName": "company",
"tlds": [],
"years": 1
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://customers.coldmailreseller.com/api/v1/integration/domains/available' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"domainName": "company",
"tlds": [],
"years": 1
}'Responses
🟢200OK
application/json
Body
Example
{
"status": 200,
"message": "Domains fetched successfully",
"data": {
"availableDomains": [
{
"domainName": "globalbrewingcompany.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingcompanyclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalcoclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewinginc.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewing-company.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingcompany.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "brewingcompany.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "realcompanyclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalcompanyblog.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewingco.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingcoclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "coclub.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "globalincclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingllc.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "realbrewingcompany.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewingcompanyclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingcompanyblog.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "company-blog.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewing-co.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "realcompany.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "globalcompanyclub.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "companyblog.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "brewingcompany.info",
"status": "AVAILABLE",
"domainPrice": "30.24",
"renewPrice": "25.39"
},
{
"domainName": "globalcompanyclub.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "brewingco.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "realcoclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalcoblog.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewinginc.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingincclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "tradingcompanyclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "incclub.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "global-brewing-company.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewing-company-club.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewingcompany.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "globalco.info",
"status": "AVAILABLE",
"domainPrice": "30.24",
"renewPrice": "25.39"
},
{
"domainName": "brewingcompanyclub.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "coclub.info",
"status": "AVAILABLE",
"domainPrice": "30.24",
"renewPrice": "25.39"
},
{
"domainName": "incclub.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "company-club.org",
"status": "AVAILABLE",
"domainPrice": "19.86",
"renewPrice": "15.88"
},
{
"domainName": "globalllcclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "brewingcorp.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewingcompany.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "brewingcompanyclub.net",
"status": "AVAILABLE",
"domainPrice": "19.85",
"renewPrice": "16.75"
},
{
"domainName": "yourcompanyclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "realcompanyblog.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "realbrewingco.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalcompanystudio.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
},
{
"domainName": "globalbrewingcoclub.com",
"status": "AVAILABLE",
"domainPrice": "21.24",
"renewPrice": "17.71"
}
]
}
}🟠422Unprocessable Entity
🔴500Invalid tlds
Modified at 2025-10-29 17:05:08