mail

Send a postcard

Print and mail a physical postcard through the USPS. CONSEQUENTIAL and charged: 169 credits. A mailed postcard cannot be recalled. Sensitive write: it requires the human's approval of the recipient, content and price. A replay with the same idempotency_key returns the original result and never mails twice.

post/v1/postcards

Request

  • Base URL: https://api.noerrands.com/c/mail
  • URL: https://api.noerrands.com/c/mail/v1/postcards
  • Auth: HTTP bearer

Request body

messagestring required

Back-of-card message, up to 350 characters.

idempotency_keystring

Use one key per human request. Replays within 24 hours return the original result instead of sending again.

Response

Success.

mail_idstring required

Opaque id, "ml_...". Use it with get_mail_status.

kind'letter' | 'postcard' required
status'created' | 'processing' | 'in_transit' | 'delivered' | 'returned' | 'failed' | 'cancelled' required
created_atstring date-time required
expected_delivery_datestring date

YYYY-MM-DD.

credits_charged_centsinteger required
tracking_urlstring uri
balance_centsinteger required

Remaining credit balance after the charge.

Changes

No recorded changes to this operation across all 1 revision of this API.