메인 콘텐츠로 건너뛰기
GET
curl

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

쿼리 매개변수

q
string

이름 또는 제목에 이 텍스트가 포함된 1회성 발송만 반환합니다(1~100자). 일반 텍스트로 비교하므로 %, _는 와일드카드가 아닙니다. NUL 문자(%00)가 포함되면 VALIDATION_ERROR로 거부됩니다.

Required string length: 1 - 100
status
enum<string>

이 상태의 1회성 발송만 반환합니다. paused는 받지 않지만, 보류된 1회성 발송도 목록에는 나올 수 있습니다.

사용 가능한 옵션:
draft,
scheduled,
sending,
sent,
partial,
failed
sentAfter
string<date-time>

이 시각 이후(해당 시각 포함)에 발송된 건만 반환합니다(RFC 3339, 예 2026-10-01T00:00:00Z).

sentBefore
string<date-time>

이 시각 이전(해당 시각 미포함)에 발송된 건만 반환합니다(RFC 3339). sentAfter보다 빠를 수 없으며 범위는 366일을 넘을 수 없습니다.

limit
integer
기본값:20

페이지당 1회성 발송 수.

필수 범위: 1 <= x <= 100
cursor
string

이전 페이지의 nextCursor.

Maximum string length: 512

응답

1회성 발송 한 페이지.

data
object[]
필수

이 페이지의 1회성 발송 목록입니다.

nextCursor
string | null
필수

다음 페이지를 가져오려면 cursor로 전달합니다. 마지막 페이지에서는 null.