TEASEDocs
API ReferenceSmart Links

Get smart link drill-down

Returns the per-fan breakdown (top spenders) and the by-conversion-type breakdown for a single smart link. Requires a read-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Path Parameters

provider_id*string

The smart link's provider_id.

Response Body

application/json

application/json

application/json

application/json

GET
/api/admin/smart-links/{provider_id}
curl -X GET "https://example.com/api/admin/smart-links/string"
{  "provider_id": "lnk_8fq2",  "offer": "paid",  "name": "IG bio - paid",  "active": true,  "fans": [    {      "fan_id": "fan_812377",      "total_net_cents": 48900,      "purchases": 6,      "last_at": "2026-06-28T14:11:02Z"    }  ],  "by_type": [    {      "conversion_type": "subscription",      "count": 118,      "revenue_net_cents": 742100    },    {      "conversion_type": "ppv",      "count": 19,      "revenue_net_cents": 356200    }  ]}
{  "detail": {    "code": "unauthorized",    "message": "Invalid or missing API key"  }}
{  "detail": {    "code": "engine_not_connected",    "message": "Connect your engine to access this data."  }}
{  "detail": {    "code": "smart_link_not_found",    "message": "Smart link 'lnk_unknown' not found"  }}

Create a smart link

Creates a smart link for the offer slot. At most one active link per offer slot is allowed. Requires a write-scoped key.

Retire a smart link

Soft-retires a smart link (sets it inactive) while preserving its stats and conversion history. Returns no content. Requires a write-scoped key.