Stream 6 — Attribution - Droplinked Developers

BETA. The attribution stream projects affiliate attribution records from AffiliateAttributionRecord (joined to the merchant’s products).

The attribution stream is the affiliate attribution record: the link token that drove the visit, the affiliate agent, the product, the session, and the attribution-window expiry. Rows are scoped to the products owned by the API key’s merchant.

Endpoint

GET /v1/api/inventory-os/streams/attribution

Query parameters:

Param	Type	Notes
`limit`	int	1–200, default 50
`cursor`	string	Opaque pagination token
`since`	ISO-8601	Optional; records created on or after this timestamp

Row shape

{
  "id": "665fattr123…",
  "linkToken": "lnk_4xy…",
  "agentId": "665fagt123…",
  "productId": "665f8abc123…",
  "sessionId": "sess_a1b2c3…",
  "expiresAt": "2026-07-01T11:55:42.000Z",
  "createdAt": "2026-06-01T11:55:42.000Z"
}

Field	Meaning
`id`	`AffiliateAttributionRecord` id; pagination cursor advances on this field
`linkToken`	The affiliate link token that produced the attribution
`agentId`	The affiliate agent credited
`productId`	The attributed product (join key to the catalog stream)
`sessionId`	Visitor session
`expiresAt`	Attribution-window expiry

Response envelope

{
  "streamType": "attribution",
  "merchantId": "65df8abc123…",
  "data": [ /* rows */ ],
  "count": 50,
  "nextCursor": "NjY1ZmF0dHIxMjM..."
}

curl

curl "https://apiv3.droplinked.com/v1/api/inventory-os/streams/attribution?since=2026-05-31T00:00:00.000Z&limit=200" \
  -H "x-droplinked-api-key: REPLACE_ME"

Affiliate-engine usage

The attribution stream pairs with the sell-through stream (3, commission events) and the settlement stream (7, order payments) to reconcile which agent and link drove each settled sale. Use since to pull only the new attributions since the last sync.

Rate limits

Low-budget class — 250 reads/min/key, up to 3 subscriptions/key.

Sell-through stream — commission events per merchant
Settlement stream — order payment + financial detail
Webhook subscriptions — attribution.changed events

Get Started

InventoryOS API

Lending Application API

KYB & Cohorts

Stream 6 — Attribution

Endpoint

Row shape

Response envelope

curl

Affiliate-engine usage

Rate limits

​Endpoint

​Row shape

​Response envelope

​curl

​Affiliate-engine usage

​Rate limits

​Related

Endpoint

Row shape

Response envelope

curl

Affiliate-engine usage

Rate limits

Related