Documentation
Sign inGet started

List receive rules

GET
/v1/email/mailboxes/{mailbox_id}/receive-rules
for await (const rule of bird.email.mailboxes.receiveRules.list("mbx_01abc")) {
  console.log(rule.action, rule.entry);
}
Returns a paginated list of the mailbox's receive rules, oldest first. Filter by action to see only allow or only block entries.
Abfrageparameter
action
string
Return only allow or block rules; omit to return both actions.
Possible values: allow, block
limit
integer
Maximum number of items to return per page.
starting_after
string
Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.
ending_before
string
Cursor from the prev_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order.
Antwort-Payload
data
array of object
required
Show child attributes
data.id
string
required
Identifies this rule for deletion. There is no update operation.
data.mailbox_id
string
required
The mailbox the rule applies to.
data.action
string
required
What the rule does when it matches. Block rules always win: over allow rules and over the reply admission on allowlist mailboxes.
Possible values: allow, block
data.entry
string
required
The sender address or domain the rule matches. Domains also match their subdomains.
data.entry_type
string
required
Whether the entry is a full address or a domain.
Possible values: address, domain
data.note
nullable string
required
Your own note about why the rule exists. null when unset.
data.created_at
string
required
When the rule was created.
next_cursor
nullable string
required
Cursor for the next page. Pass back as starting_after to advance forward. null when no next page exists.
prev_cursor
nullable string
required
Cursor for the previous page. Pass back as ending_before to step backward. null when no previous page exists.
refresh_cursor
nullable string
required
Refresh anchor. Pass back as ending_before later to fetch items that have appeared since this response. Non-null whenever data is non-empty; null only on an empty page. Distinct from prev_cursor.