Token of Esteem

List Voices

List the three comedic voices (Hype Man, Best Friend Roast, Conspiracy Theorist) and the cover image model each prefers. Free, no side effects. Call this first to pick a voice.

List Formats

List supported booklet formats. There is one today: manual_v1, a 16-page booklet. Free, no side effects.

List Image Models

List supported cover image models and their per-call cost. Free, no side effects.

Get Pricing

Compute the exact total for a hypothetical gift (format, voice, image model, ship_to) before you commit. Free, no order is created. Call before create_gift so you know the charge.

Validate Brief

Run the content policy on a brief without charging or ordering. Free. Call before create_gift so a refusal surfaces early. A booklet that would wound the recipient is refused here, not at charge time.

Create Gift

Place the order: write, print, and mail the booklet. CHARGES the buyer. The recipient is whoever you name in recipient, which may be your own user. Idempotent on idempotency_key for 24 hours. Pass shared_payment_token to pay tokenlessly, or omit it to charge the account's saved card.

Get Gift

Fetch a gift by gift_id and return its full resource: status, voice, format, pricing, the recipient, and fulfillment (Lulu job id, carrier, tracking URL, estimated delivery). Free and read-only. Use it to poll progress after create_gift: status advances through the pipeline to shipped then delivered, or ends at held, refused, cancelled, or failed.

List Gifts

Paginated list of gifts on the account, with optional status and date filters. Free.

Cancel Gift

Cancel an in-flight gift and receive the refund amount. Free. Only possible before the booklet goes to print; once printing has started it fails with cancel_too_late. Pass the gift_id from create_gift and an optional reason for your records.

Get Account

Return this account's spending caps and month-to-date spend. Free. Use it to confirm budget before create_gift.

List Recipients

Return the account's saved recipients (address book). Free. Reuse a recipient_id in create_gift instead of re-entering an address.

Create Setup Link

Return a hosted Stripe link for the buyer to save a card or wallet to the account. After that, create_gift without a shared_payment_token charges the saved card.