이메일 조회 (보낸 것·받은 것)
이 계정의 이메일을 최신순으로 조회합니다. 보낸 것과 받은 것이 같은 목록에 나오며
direction 으로 구분합니다 — 통화·문자 조회와 같은 방식입니다.
한쪽만 보려면 direction=outbound 또는 direction=inbound 를 주십시오.
⚠️ 보낸 메일의 status 는 공급자 접수 여부입니다 — 수신함 도착이 아닙니다.
전달·반송은 비동기로 확인되며 이 값은 그 뒤에도 바뀌지 않습니다.
⚠️ 본문은 목록에 실리지 않습니다. 단건 조회로 받으십시오.
Authorization
BearerAuth API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
계정 ID
Query Parameters
방향 필터. 지정하지 않으면 양방향이 함께 나옵니다.
"outbound" | "inbound"상태 필터. 받은 메일은 항상 received 입니다.
"sent" | "failed" | "received"발신 주소 필터(정확히 일치). 특정 상대와 오간 메일을 찾을 때 씁니다.
email받은 메일이 실제로 배달된 주소 필터(정확히 일치).
한 도메인에 support@·sales@ 처럼 여러 주소를 두고 처리를 나눈다면 이 필터를
쓰십시오. ⚠️ 숨은 참조(BCC)로 온 메일은 to 헤더에 주소가 없으므로 to 로는
찾을 수 없습니다.
email이 시각 이상(포함). direction=inbound 면 공급자가 받은 시각, 그 밖에는
생성 시각 기준입니다.
date-time이 시각 미만(제외).
date-time발신 도메인 필터. 검증한 도메인이 여럿일 때 씁니다.
페이지 번호(0-based)
0페이지 크기(최대 100)
20value <= 100pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
value <= 100pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/emails?direction=inbound&status=failed&from=customer%40gmail.com&recipient=support%40example.com&receivedAfter=2026-09-01T00%3A00%3A00Z&receivedBefore=2026-10-01T00%3A00%3A00Z&emailDomainId=clx9dom00001&page=0&pageSize=20&page_size=50&limit=100"{
"data": [
{
"emailId": "clx9eml00001",
"direction": "inbound",
"status": "sent",
"from": "no-reply@example.com",
"to": [
"customer@gmail.com"
],
"cc": [],
"bcc": [],
"suppressed": [],
"subject": "주문이 접수되었습니다",
"recipientCount": 1,
"attachmentCount": 1,
"createdAt": "2026-09-03T07:20:00.000Z",
"failureCode": null,
"failureMessage": null,
"replyTo": [
"support@example.com"
],
"messageId": "CAF7n8xW1p_abc@mail.gmail.com",
"inReplyTo": null,
"references": [
"CAF7n8xW1p_xyz@mail.gmail.com",
"CAF7n8xW1p_abc@mail.gmail.com"
],
"recipients": [
"support@example.com"
],
"receivedAt": "2026-09-04T05:48:00.000Z",
"sizeBytes": 4030,
"verdicts": {
"spam": "PASS",
"virus": "PASS",
"spf": "PASS",
"dkim": "PASS",
"dmarc": "GRAY"
},
"parseStatus": "parsed"
}
],
"meta": {
"page": 0,
"pageSize": 20,
"total": 137
}
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}