Offer

An Offer is a Product, under a Brand, at a Price, on terms, made by a Startup. One Product sells as many Offers, and a Customer accepts an Offer, never a Product.

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

{
  "$id": "https://api.sb/petpantry.shop/offers/offer_1",
  "$type": "Offer",
  "price": {
    "amount": 54,
    "currency": "USD"
  },
  "terms": "Full refund within 14 days of purchase. Delivery in 2 business days.",
  "from": "Hypothesis#approach@v1",
  "activation": {},
  "credit": {
    "amount": 54,
    "currency": "USD"
  },
  "atBound": "stop",
  "interval": "once",
  "availableFrom": "2026-10-22T12:00:00Z",
  "availableUntil": "2026-10-22T12:00:00Z",
  "trial": {
    "days": 14,
    "card": true
  },
  "seats": "manual",
  "uptime": {
    "target": 99.9,
    "credits": [
      {
        "below": 99.9,
        "percent": 10
      },
      {
        "below": 99,
        "percent": 25
      }
    ]
  },
  "license": "internal",
  "attribution": "Renewal data from Leaseline",
  "privateTo": "party_1"
}

AnatomyCopy Anchor Link

RouteWise (routewise.dev), a sample business, sells three Offers:

An Entitlement bounded by a Limit has kind limit; one without has kind feature. The kind is computed, never set.

Offer.publish puts each Offer on every buy surface: checkout, paymentLink, pricingTable, portalEntry, mcpBuyTool, http402.

RelationshipsCopy Anchor Link

• An Offer is accepted by many Customers: a party becomes a Customer by accepting any Offer, at any price including zero. acceptedBy, inverse accepts.
• An Offer is branded by one Brand: each Offer carries exactly one Brand, whose name, voice and logo the buyer sees. brandedBy, inverse brands.
• An Offer has many Coupons: a Coupon applies only to the Offers it names; an Offer may accept several Coupons. coupons, inverse discounts.
• An Offer has many Funnels: each Funnel’s path ends at one Offer, after its landing Page, opt-in and Sequence. funnels, inverse leadsTo.
• An Offer is governed by one Outcome Contract: an Outcome Contract warrants the result an Offer sells: its done state, acceptance, assurance and remedy. governedBy, inverse governs.
• An Offer grants many Entitlements: an accepted Offer grants Entitlements, each a Verb on a Noun, optionally bounded by a Limit. grants, inverse grantedBy.
• An Offer includes one Product: each Offer sells one Product; one Product sits inside many Offers at different prices and terms. includes, inverse includedIn.
• An Offer is offered by one Startup: each Offer has one maker, which earns its revenue and answers for its terms. offeredBy, inverse offers.
• An Offer is ordered in many Orders: an Order commits to buying one or more Offers once. orderedIn, inverse buys.
• An Offer is priced at one Price: every Offer embeds one Price: amount, currency, unit and tiers; zero is a Price. pricedAt, inverse priceOf.
• An Offer is promoted by many Ads: each Ad sells one Offer. promotedBy, inverse promotes.
• An Offer is pursued in many Deals: a Deal asks one buyer to accept one or more Offers. pursuedIn, inverse pursues.
• An Offer is quoted in many Quotes: a Quote prices one or more Offers for one buyer. quotedIn, inverse proposes.
• An Offer has many Reviews: a Review evaluates one Offer; Reviews of a Product or Brand roll up through its Offers. reviews, inverse evaluates.
• An Offer is sold in one Motion: each Offer sells through one Motion, which says who buys and who acts for them. soldIn, inverse sells.
• An Offer has many Subscriptions: a Subscription bills one recurring Offer each Period until canceled. subscriptions, inverse renews.
• An Offer targets many Personas: an Offer speaks to and is priced for named Personas. targets, inverse targetedBy.
• An Offer has one Waitlist: a Waitlist admits its Leads to one Offer once that Offer opens. waitlist, inverse awaits.

LifecycleCopy Anchor Link

VerbsCopy Anchor Link

1. createCreates an Offer.
   POST /{namespace}/offersdoOffer.created
2. getReturns one Offer by id.
   GET /{namespace}/offers/{id}readNo Event
3. listReturns Offers, newest first, one page at a time.
   GET /{namespace}/offersreadNo Event
4. updateChanges the given properties of an Offer.
   PATCH /{namespace}/offers/{id}doOffer.updated
5. deleteDeletes an Offer; its history is kept.
   DELETE /{namespace}/offers/{id}doOffer.deleted
6. acceptAccept records that a party takes an Offer, which makes that party a Customer of the Startup.
   POST /{namespace}/offers/{offer}/acceptdoOffer.accepted
7. grantGrant adds an Entitlement to an Offer: a Verb its Customers may call, optionally bounded by a Limit.
   POST /{namespace}/offers/{offer}/grantdoOffer.granted
8. publishPublish makes an Offer available for parties to accept.
   POST /{namespace}/offers/{offer}/publishdoOffer.published
9. subscribeSubscribe accepts a recurring Offer as a Subscription that renews each period until it ends.
   POST /{namespace}/offers/{offer}/subscribedoOffer.subscribed
10. trialTrial starts a Customer on an Offer free for a set number of days, with or without a card, converting or ending by its terms.
    POST /{namespace}/offers/{offer}/trialdoOffer.trialed
11. withdrawWithdraw closes a published Offer to new Customers and leaves every existing Order and Subscription in force.
    POST /{namespace}/offers/{offer}/withdrawdoOffer.withdrawn

PermissionsCopy Anchor Link

Which Access level may call each Verb. One-way Verbs wait their delay window.

StripeCopy Anchor Link

Product (product). The source of truth is db.sb, and Stripe holds a copy written from it.

Call itCopy Anchor Link

Publish the offer “RouteWise API”.

ExampleCopy Anchor Link

A dental bookkeeping Startup sells one Product as two Offers: $600 a month for monthly closes, or $2,400 once for catch-up books. Both carry its one Brand.