Developers · API

A REST surface as honest as the data behind it.

Authenticate with a bearer key, hit a handful of predictable endpoints, and subscribe to events when revenue settles. Versioned, rate-limited, and documented.

Core endpoints

POST/v2/touches

Record a first-party touch for a visitor.

POST/v2/orders/attribute

Stitch a settled order and return per-channel credit.

GET/v2/visitors/:id/journey

Retrieve the ordered touch timeline for a visitor.

GET/v2/reports/revenue

Query attributed revenue by channel, model, and window.

POST/v2/webhooks

authenticate

curl https://api.headlessbuilds.com/v2/reports/revenue \
  -H 'Authorization: Bearer tl_live_***' \
  -d 'model=data_driven&window=30d'

webhook payload

{
  "event": "attribution.settled",
  "orderId": "gid://shopify/Order/123",
  "revenue": "184.00",
  "credits": { "paid_search": 0.41, "email": 0.59 }
}

Build on top of your attribution.

Pull attributed revenue into your own tools, or react to settlement events in real time. The API is yours.

Get an API key SDK reference