cards

Send a card

Mail the card a quote describes: CONSEQUENTIAL and charged (899 credits handwritten, 399 printed) -- a real card goes to a real person. Takes the quote_id with confirm: true. Sensitive write: it requires the human's approval of the preview (design, full message, recipient and address, tier, price, dispatch date). The same quote_id never sends or charges twice; a card scheduled for a later day can be cancelled for a full refund until it leaves.

post/v1/cards

Request

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

Request body

quote_idstring required

From preview_card. Repeating it never charges twice.

confirmtrue required

Must be true: the human has seen the preview and approved sending and paying for it.

Response

Success.

card_idstring required

Opaque id, "cd_...". Use it with get_card and cancel_card.

status'scheduled' | 'submitted' | 'in_production' | 'mailed' | 'delivered' | 'returned' | 'cancelled' | 'failed' required

scheduled (held until dispatch_on) -> submitted -> in_production -> mailed -> delivered; or returned, cancelled, failed.

tier'handwritten' | 'printed' required

handwritten: a folded card written with a real pen, in a stamped envelope. printed: a 6x9 postcard-style card, message printed on the back where anyone handling it can read it.

dispatch_onstring date required

The day the card goes to the provider.

credits_charged_centsinteger required
balance_centsinteger required

General credit left.

Changes

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