이메일 조회 (보낸 것·받은 것)

GET

https://api.claw-ops.com/v1/accounts/:accountId/emails

GET

/v1/accounts/:accountId/emails

curl -G https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/emails \
     -H "Authorization: Bearer <token>" \
     -d direction=inbound \
     -d emailDomainId=clx9dom00001 \
     --data-urlencode from=customer@gmail.com \
     -d limit=100 \
     -d page=0 \
     -d pageSize=20 \
     -d page_size=50 \
     --data-urlencode receivedAfter=2026-09-01T00:00:00Z \
     --data-urlencode receivedBefore=2026-10-01T00:00:00Z \
     --data-urlencode recipient=support@example.com \
     -d status=failed

{
  "data": [
    {
      "emailId": "clx9eml00001",
      "direction": "inbound",
      "status": "sent",
      "from": "no-reply@example.com",
      "to": [
        "customer@gmail.com"
      ],
      "recipientCount": 1,
      "createdAt": "2026-09-03T07:20:00.000Z",
      "cc": [],
      "bcc": [],
      "suppressed": [],
      "subject": "주문이 접수되었습니다",
      "attachmentCount": 1,
      "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
  }
}

이 계정의 이메일을 최신순으로 조회합니다. 보낸 것과 받은 것이 같은 목록에 나오며 direction 으로 구분합니다 — 통화·문자 조회와 같은 방식입니다.

한쪽만 보려면 direction=outbound 또는 direction=inbound 를 주십시오.

⚠️ 보낸 메일의 status 는 공급자 접수 여부입니다 — 수신함 도착이 아닙니다. 전달·반송은 비동기로 확인되며 이 값은 그 뒤에도 바뀌지 않습니다.

⚠️ 본문은 목록에 실리지 않습니다. 단건 조회로 받으십시오.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Query parameters

directionenumOptional

방향 필터. 지정하지 않으면 양방향이 함께 나옵니다.

Allowed values:

statusenumOptional

상태 필터. 받은 메일은 항상 received 입니다.

Allowed values:

fromstringOptionalformat: "email"

발신 주소 필터(정확히 일치). 특정 상대와 오간 메일을 찾을 때 씁니다.

recipientstringOptionalformat: "email"

받은 메일이 실제로 배달된 주소 필터(정확히 일치).

한 도메인에 support@·sales@ 처럼 여러 주소를 두고 처리를 나눈다면 이 필터를 쓰십시오. ⚠️ 숨은 참조(BCC)로 온 메일은 to 헤더에 주소가 없으므로 to 로는 찾을 수 없습니다.

receivedAfterdatetimeOptional

이 시각 이상(포함). direction=inbound 면 공급자가 받은 시각, 그 밖에는 생성 시각 기준입니다.

receivedBeforedatetimeOptional

이 시각 미만(제외).

emailDomainIdstringOptional

발신 도메인 필터. 검증한 도메인이 여럿일 때 씁니다.

pageintegerOptionalDefaults to 0

페이지 번호(0-based)

pageSizeintegerOptional<=100Defaults to 20

페이지 크기(최대 100)

page_sizeintegerOptional<=100Deprecated

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

limitintegerOptional<=100Deprecated

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

Response

이메일 목록

datalist of objects

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error