API Reference
이메일 단건 조회 (본문 포함)
이메일 한 건을 조회합니다. 목록 항목의 모든 필드에 본문과 첨부 목록이 더해집니다.
받은 메일이면 text·html 에 본문이, attachments 에 첨부(각각 단기 내려받기 링크
포함)가, raw 에 원문 전체를 받는 단기 링크가 담깁니다. 보낸 메일은 이 필드들이 모두
null 입니다 — 보낸 본문은 여러분이 만든 것이라 우리가 따로 보관하지 않습니다.
⚠️ 응답에 담긴 링크들은 잠시 뒤 만료됩니다(expiresAt). 저장해 두지 말고 필요할 때
다시 호출하십시오.
⚠️ 보관기간이 지나면 본문과 raw 가 null 이 됩니다. 그때도 발신자·제목·시각·판정
같은 메타데이터는 그대로 조회됩니다 — 메일이 왔다는 사실은 사라지지 않습니다.
다른 계정의 메일은 조회할 수 없습니다. 남의 것을 요청하면 없는 것과 같은 404 가
돌아옵니다 — 구분해서 알리면 그 ID 가 실재하는지 알아낼 수 있기 때문입니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
emailId*string
발송 응답의 emailId, 목록의 emailId, 또는 email.received 웹훅의 EmailId.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/emails/clx9eml00001"{
"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",
"text": "재고 문의드립니다. 언제쯤 입고될까요?",
"html": "<p>재고 문의드립니다…</p>",
"bodyTruncated": false,
"attachments": [
{
"attachmentId": "clx9att00001",
"filename": "주문서.pdf",
"contentType": "application/pdf",
"sizeBytes": 182034,
"contentId": "logo@example.com",
"inline": false,
"downloadUrl": "http://example.com",
"expiresAt": "2026-09-04T07:15:00.000Z"
}
],
"raw": {
"downloadUrl": "http://example.com",
"expiresAt": "2026-09-04T07:15:00.000Z"
}
}{
"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·대표번호만 발급됩니다."
}
]
}