ReferenceMessages

Deliveries

1 operation. Send Authorization: Bearer $PASSBOOK_KEY. Markdown

GET/api/v1/delivery
passes:readSDK pb.deliveries.list

Query

passIdstring · max 64Required

Returns

200

Errors

CodeStatusFix
DELIVERY_STALEReview the recipient and try again.
EMAIL_INVALIDSend a valid address in the email field.
EMAIL_OUTCOME_UNKNOWNCheck the pass's delivery status before sending again, to avoid a duplicate email.
EMAIL_RATE_LIMITEDWait for Retry-After, then retry.
FORBIDDENUse a key with the scope the operation lists, or ask an org admin.
IDEMPOTENCY_IN_PROGRESSWait a moment and resend the identical request.
IDEMPOTENCY_KEY_INVALIDSend a unique string of 1 to 200 characters, such as a UUID.
IDEMPOTENCY_KEY_REUSEDUse a new key for a new request; resend the identical request to replay.
INVALID_API_KEYCreate a new key in the console and update PASSBOOK_KEY.
MISSING_SCOPECreate a key with the scope the operation lists under security.
ORG_REQUIREDSend orgId with the request, or use a key scoped to one organization.
PASS_CONFLICTFetch the pass with GET /api/v1/passes/{id} and send the request again.
PASS_NOT_FOUNDCheck the id with GET /api/v1/passes and the key's mode.
RATE_LIMITEDWait for Retry-After seconds, then retry. Back off on repeats.
REPLY_TO_LINK_INVALIDRequest a new link with POST /api/v1/settings/reply-to/resend.
REPLY_TO_NOTHING_PENDINGSet a new reply-to address with PUT /api/v1/settings first.
REPLY_TO_RESEND_LIMITEDWait a minute, then call POST /api/v1/settings/reply-to/resend again.
UNAUTHENTICATEDSend Authorization: Bearer $PASSBOOK_KEY.
VALIDATIONFix each field in issues and resend.