메시지·인증

이메일 발신 도메인 목록 조회

Markdown으로 보기
GET
/v1/accounts/{accountId}/email-domains

이 계정에 등록된 이메일 발신 도메인을 조회합니다. 다른 계정의 도메인은 나타나지 않습니다.

공급자 상태를 매번 확인하지는 않습니다. 목록은 한국AI통신에 저장된 마지막 검증 결과를 그대로 돌려주므로 빠릅니다. 지금 상태를 다시 확인하려면 검증 API 를 호출하세요.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

Query Parameters

page?integer

페이지 번호(0-based)

Default0
pageSize?integer

페이지 크기(최대 100)

Default20
Rangevalue <= 100
page_size?integerDeprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

Rangevalue <= 100
limit?integerDeprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

Rangevalue <= 100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/email-domains?page=0&pageSize=20&page_size=50&limit=100"
{
  "data": [
    {
      "id": "clx9edm00001",
      "domain": "mail.example.com",
      "status": "pending",
      "dnsRecords": [
        {
          "purpose": "dkim",
          "requirement": "required",
          "type": "CNAME",
          "name": "abc123._domainkey.mail.example.com",
          "value": "abc123.dkim.amazonses.com",
          "priority": null
        }
      ],
      "receivingEnabled": false,
      "receivingStatus": null,
      "receivingCheckedAt": null,
      "mailFromStatus": null,
      "dmarcStatus": null,
      "lastCheckedAt": "2026-09-02T00:00:00.000Z",
      "verifiedAt": null,
      "pendingExpiresAt": "2026-09-05T00:00:00.000Z",
      "createdAt": "2026-09-02T00:00:00.000Z",
      "updatedAt": "2026-09-02T00:00:00.000Z"
    }
  ],
  "meta": {
    "page": 0,
    "pageSize": 0,
    "total": 0
  }
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ]
}