이메일 목록 조회

한 번에 가져올 데이터의 최대 개수 (최대 100)

특정 이메일 아이디로 필터링

조회할 이메일 아이디 목록(쉼표로 구분). 예) "1024,1025"

• 한 번에 최대 100개까지 지정할 수 있습니다.
• 중복된 아이디는 하나로 처리됩니다.
• 숫자가 아니거나 0 이하인 값이 있으면 400 오류가 발생합니다.
• emailId와 함께 지정하면 두 조건을 모두 만족하는 이메일만 조회됩니다.

조회할 이메일 상태(쉼표로 구분). 예) "0,3" 또는 "WRITING,SENT"

• 상태 코드(숫자)와 상태 이름(statusName) 중 어느 쪽으로도 요청할 수 있습니다.

• 상태 이름은 대소문자를 구분하지 않습니다. 예) "writing,sent"

• 토큰 앞뒤 공백은 허용됩니다. 예) "0, 3"

• 이름도 숫자도 아닌 값은 무시됩니다. 이 경우 400 오류는 발생하지 않습니다.

• 위 목록에 없는 숫자도 무시되지 않고 조회 조건에 그대로 사용됩니다.

• 0 (WRITING): 작성 중

• 1 (RESERVED): 예약

• 3 (SENT): 발송 완료

• 10 (AUTO_DRAFT): 자동 작성 중

• 11 (AUTO_SENDING): 자동 발송 중

• 12 (AUTO_PAUSED): 자동 일시중지

• 13 (AUTO_STOPPED): 자동 중지

• 15 (AUTO_RESERVED): 자동 예약

• 21 (PROCESSING): 처리 중

• 22 (SENDING): 발송 중

• 23 (SENDING_DELAYED): 발송 지연

• 41 (FAILED): 실패

• 42 (SPAM): 스팸

※ 21·22·23은 발송이 진행되는 동안 잠깐 거치는 상태입니다. 같은 조건으로 다시 조회하면 이미 다음 상태(예: 3 발송 완료)로 넘어가 목록에서 빠질 수 있습니다.

조회할 이메일 종류(쉼표로 구분). 예) "1,2" 또는 "NORMAL,AB_TEST"

• 종류 코드(숫자)와 종류 이름(typeName) 중 어느 쪽으로도 요청할 수 있습니다.

• 종류 이름은 대소문자를 구분하지 않습니다. 예) "normal,ab_test"

• 토큰 앞뒤 공백은 허용됩니다. 예) "1, 2"

• 이름도 숫자도 아닌 값은 무시됩니다. 이 경우 400 오류는 발생하지 않습니다.

• 위 목록에 없는 숫자도 무시되지 않고 조회 조건에 그대로 사용됩니다.

• 지정하지 않으면 모든 종류를 반환합니다.

• 1 (NORMAL): 일반 이메일

• 2 (AB_TEST): A/B 이메일

• 3 (AUTO_MAIL): 자동 이메일

• 4 (AUTO_SMS): 자동 문자

이 시각 이후에 발송된 이메일만 조회합니다(해당 시각 제외).

• "2026-05-01 00:00:00" 형식으로 날짜와 시각을 모두 지정해야 합니다.
• 아직 발송되지 않은 이메일은 조회되지 않습니다.

이 시각 이하에 발송된 이메일만 조회합니다(해당 시각 포함).

• sentAfter와 함께 사용해야 합니다. 단독으로 지정하면 400 오류가 발생합니다.
• "2026-05-31 23:59:59" 형식으로 날짜와 시각을 모두 지정해야 합니다.

정렬 기준 필드.

• createdTime: 생성일시

• modifiedTime: 수정일시

• sentTime: 발송일시

• 대소문자를 구분하지 않으며 앞뒤 공백은 무시됩니다. 예) "SENTTIME"

• 위 목록에 없는 값을 보내면 400 오류가 발생합니다.

• sortBy 를 지정하고 sortOrder 를 생략하면 desc 로 정렬됩니다.

• sortBy 를 생략하고 sortOrder 만 지정하면 createdTime 기준으로 정렬됩니다.

• 둘 다 생략하면 정렬 순서를 보장하지 않습니다.

정렬 순서. 기준 필드는 sortBy 로 지정합니다.

• 대소문자를 구분하지 않습니다. 예) "DESC"
• sortBy 를 지정하고 sortOrder 를 생략하면 desc 로 정렬됩니다.
• asc 또는 desc 가 아닌 값을 보내면 400 오류가 발생합니다.