Acquisition · StartupBuilder

Properties

Property	Type	Required	Description
`kind`	`string`	required	The referrer kind: one of `search`, `answer`, `agent`, `referral`, `ad`, `outbound`, or `direct`.
`play`	Play		The Play that produced the first touch, when one did.
`venue`	`string`		The venue id where the touch happened, such as a search engine, an answer engine, or a Mailbox.
`campaign`	Campaign		The Campaign behind a paid placement or a scheduled send.
`ad`	Ad		The Ad clicked, for a paid or house placement.
`page`	Page		The first Page the Visitor saw.
`keyword`	Keyword		The Keyword or prompt, when the venue reports it.
`angle`	`string`		The angle the first touch carried: the message the Play ran.
`referrer`	`string`		The linking host, as the request reported it.
`partner`	Partner		The Partner or creator credited, for referral, creator and commission Plays.
`reported`	`text`		What the person answered when asked how they heard, kept word for word.
`at`	`datetime`	required	When the first Event arrived.

Object

JSON

{
  "$id": "https://api.sb/routewise.dev/acquisitions/acquisition_1",
  "$type": "Acquisition",
  "kind": "search",
  "play": "play_1",
  "venue": "google-search",
  "campaign": "campaign_1",
  "ad": "ad_1",
  "page": "page_1",
  "keyword": "keyword_1",
  "angle": "Example angle",
  "referrer": "news.ycombinator.com",
  "partner": "partner_1",
  "reported": "Example reported",
  "at": "2026-10-22T12:00:00Z"
}

Relationships

An Acquisition has many Customers: a Customer inherits the Acquisition of the Lead it was; Metrics and payouts read this one row. customers, inverse acquiredBy.
An Acquisition has many Leads: each Lead keeps the Acquisition that first brought it, through either door: a Visit or an outbound reply. leads, inverse acquiredBy.
An Acquisition has many Prospects: a Prospect’s Acquisition names the outbound Play and Mailbox that first reached it. prospects, inverse acquiredBy.

Verbs

getReturns one Acquisition by id.
GET /{namespace}/acquisitions/{id}readNo Event
listReturns Acquisitions, newest first, one page at a time.
GET /{namespace}/acquisitionsreadNo Event

An Acquisition is kept forever and never edited: it has no update or delete.

Permissions

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

Operation	`owner`	`admin`	`member`	`viewer`
`Acquisition.get`	Yes	Yes	Yes	Yes
`Acquisition.list`	Yes	Yes	Yes	Yes

Call it

Text

Show me the latest acquisition.

A clinic manager asks ChatGPT for shift-scheduling software and opens the pricing Page it cites. Her first Event writes an Acquisition with kind: answer, venue: chatgpt and the answer engine optimization Play. When she subscribes, her Customer record keeps it, and that Play’s ledger counts her revenue.

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

RelationshipsCopy Anchor Link

VerbsCopy Anchor Link

PermissionsCopy Anchor Link

Call itCopy Anchor Link

ExampleCopy Anchor Link