Dedicated IPs give you exclusive control over a sending IP's reputation. Unlike shared pools, your IP is never affected by other senders. Max plan includes 1 dedicated IP; Enterprise plans include 5.

Auth scope: ips

Plan Availability

Plan	Dedicated IPs
Free	0
Pro	0
Max	1
Enterprise	5

Additional IPs can be requested for Enterprise accounts — contact sales.

Endpoints

Method	Path	Description
`GET`	`/api/v1/dedicated-ips`	List assigned IPs
`POST`	`/api/v1/dedicated-ips`	Request a dedicated IP
`GET`	`/api/v1/dedicated-ips/:id`	IP details and warm-up status
`PATCH`	`/api/v1/dedicated-ips/:id`	Update IP settings
`DELETE`	`/api/v1/dedicated-ips/:id`	Release an IP

List dedicated IPs

GET/mail/v1/dedicated-ips

List all dedicated IPs assigned to the account.

Response fields

successboolean

true when the request succeeded.

ipsArray<IP>

The assigned IPs. Each includes id, address, rdns, warmup_status, warmup_percent, pool, and created_at.

curl https://api.misar.io/mail/v1/dedicated-ips \
  -H "Authorization: Bearer msk_YOUR_API_KEY"

{
  "success": true,
  "ips": [
    {
      "id":          "ip_abc123",
      "address":     "198.51.100.42",
      "rdns":        "mail.yourdomain.com",
      "warmup_status": "warming",
      "warmup_percent": 62,
      "pool":        "marketing",
      "created_at":  "2026-03-15T10:00:00Z"
    }
  ]
}

Request a dedicated IP

POST/mail/v1/dedicated-ips

Request a new dedicated IP for the account. Provisioning takes up to 24 hours. A warm-up schedule begins automatically.

Request body

poolstringbody

IP pool assignment: transactional, marketing (default: marketing).

rdnsstringbody

Reverse DNS (PTR record) hostname for the IP.

Response fields

successboolean

true when the request was accepted.

ipobject

The provisioning IP, including id, address, warmup_status, pool, and provisioned_at.

messagestring

Human-readable provisioning status.

curl -X POST https://api.misar.io/mail/v1/dedicated-ips \
  -H "Authorization: Bearer msk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pool": "marketing",
    "rdns": "mail.yourdomain.com"
  }'

{
  "success": true,
  "ip": {
    "id":            "ip_abc123",
    "address":       "198.51.100.42",
    "warmup_status": "not_started",
    "pool":          "marketing",
    "provisioned_at": null
  },
  "message": "IP provisioning in progress. Expected within 24 hours."
}

Get IP details

GET/mail/v1/dedicated-ips/:id

Get detailed status and warm-up schedule for a specific IP.

Path parameters

idstringpathrequired

ID of the dedicated IP.

Response fields

successboolean

true when the request succeeded.

ipobject

Full IP detail including address, rdns, pool, warmup_status, warmup_percent, daily_limit, reputation_score, warmup_schedule, and created_at.

curl https://api.misar.io/mail/v1/dedicated-ips/ip_abc123 \
  -H "Authorization: Bearer msk_YOUR_API_KEY"

{
  "success": true,
  "ip": {
    "id":              "ip_abc123",
    "address":         "198.51.100.42",
    "rdns":            "mail.yourdomain.com",
    "pool":            "marketing",
    "warmup_status":   "warming",
    "warmup_percent":  62,
    "daily_limit":     8000,
    "reputation_score":84,
    "warmup_schedule": [
      { "day": 1,  "limit": 200,   "sent": 200,   "done": true },
      { "day": 7,  "limit": 1000,  "sent": 1000,  "done": true },
      { "day": 14, "limit": 4000,  "sent": 3800,  "done": false },
      { "day": 21, "limit": 10000, "sent": 0,     "done": false },
      { "day": 28, "limit": 25000, "sent": 0,     "done": false }
    ],
    "created_at": "2026-03-15T10:00:00Z"
  }
}

warmup_status values

Status	Meaning
`not_started`	IP provisioned but warm-up not yet begun
`warming`	Active warm-up in progress
`warmed`	Warm-up complete — full daily limit available
`suspended`	Temporary suspension due to complaint spike

Update IP settings

PATCH/mail/v1/dedicated-ips/:id

Update settings for an assigned IP.

Path parameters

idstringpathrequired

ID of the dedicated IP.

Request body

poolstringbody

Reassign to a different IP pool.

rdnsstringbody

Update PTR record hostname.

curl -X PATCH https://api.misar.io/mail/v1/dedicated-ips/ip_abc123 \
  -H "Authorization: Bearer msk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pool": "transactional", "rdns": "tx.yourdomain.com" }'

Release an IP

DELETE/mail/v1/dedicated-ips/:id

Release a dedicated IP. Sends will fall back to the shared IP pool for the assigned pool type.

Path parameters

idstringpathrequired

ID of the dedicated IP to release.

Response fields

successboolean

true when the IP was released.

curl -X DELETE https://api.misar.io/mail/v1/dedicated-ips/ip_abc123 \
  -H "Authorization: Bearer msk_YOUR_API_KEY"

{ "success": true }

Releasing a warmed IP permanently discards its reputation history. This action cannot be undone.