List domain history

Request

Retrieves a domain's history records

Security

basicAuth

Path

namestringrequired

The domain name

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v1/dynamic_pools/domains/{name}/history'

Responses

A 200 response

Bodyapplication/json

idstringrequired

owning_account_idstringrequired

account_idstringrequired

account_namestringrequired

domain_idstringrequired

domain_namestringrequired

new_bandstringrequired

prev_bandstringrequired

reasonstringrequired

bounce_ratenumber or null, (float)required

complaint_ratenumber or null, (float)

processed_countinteger or null, (int64)

initiated_bystring

timestampstring, (date-time)required

Response

{
  "id": "000000000000000000000000",
  "owning_account_id": "000000000000000000000000",
  "account_id": "68d16780d1ffb196ac7b2ccd",
  "domain_id": "68d16780d1ffb196ac7b2ccc",
  "domain_name": "test.com",
  "new_band": "dynamic_good",
  "prev_band": "dynamic_poor",
  "reason": "Multiple metrics in good threshold",
  "bounce_rate": 0.2,
  "complaint_rate": 0.1,
  "processed_count": 100,
  "timestamp": "2025-09-22T11:13:04.740262-04:00"
}