Get message delivery quote(s)
/permissions/quoteReturns pricing information for sending a message to one or more recipients in a named message box. The caller (sender) is identified by their auth headers.
Single-recipient response uses the legacy shape
{ status, description, quote: { deliveryFee, recipientFee } }.
Multi-recipient response adds quotesByRecipient, totals, and
blockedRecipients fields. Blocked recipients are still returned in
the list; the caller decides whether to abort or proceed with the
non-blocked subset.
Persisted recipient fees are safe integers from -1 through 2147483647; server delivery fees are safe integers from 0 through 2147483647. Invalid persisted values fail the quote closed.
Query Parameters
Identity key of the recipient. Repeat the parameter for multiple
recipients: ?recipient=A&recipient=B.
Message box type to quote against.
Response
Quote(s) generated.
Missing or invalid parameters.
Codes: ERR_MISSING_PARAMETERS, ERR_INVALID_PUBLIC_KEY
Machine-readable error code (see specs/errors.md).
Human-readable explanation.
Authentication required (ERR_AUTHENTICATION_REQUIRED).
Machine-readable error code (see specs/errors.md).
Human-readable explanation.
Internal server error (ERR_INTERNAL).
Machine-readable error code (see specs/errors.md).
Human-readable explanation.