curl https://api.liddie.io/api/v1/widgets \
--cookie "<dashboard session>"
// Dashboard-session endpoint: send your dashboard JWT as a Bearer token
const res = await fetch('https://api.liddie.io/api/v1/widgets', {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const widgets = await res.json()
Widgets
List widgets
List every widget on your Liddie merchant account — embeddable payment and donation buttons and forms that take crypto via the publishable key.
GET
/
api
/
v1
/
widgets
curl https://api.liddie.io/api/v1/widgets \
--cookie "<dashboard session>"
// Dashboard-session endpoint: send your dashboard JWT as a Bearer token
const res = await fetch('https://api.liddie.io/api/v1/widgets', {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const widgets = await res.json()
Lists your widgets. A widget is a button or form you embed on any website; it creates payments through your publishable key (
pk_live_*, safe to expose) instead of your secret key.
This endpoint takes no parameters — the merchant is inferred from your session.
Management endpoints like this one are dashboard-only. The only public widget endpoint is the checkout endpoint, which is what your embedded widgets call.
Who can call this
Send your dashboard JWT (browser session) as a Bearer token, with team rolemerchant_admin or merchant_member plus the widgets:view permission. Widget management is not accessible with an API key. See the Authentication guide.
curl https://api.liddie.io/api/v1/widgets \
--cookie "<dashboard session>"
// Dashboard-session endpoint: send your dashboard JWT as a Bearer token
const res = await fetch('https://api.liddie.io/api/v1/widgets', {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const widgets = await res.json()
Response
Each widget in the list carries the fields documented on Create a widget:type, name, amountMode, fixedAmount, allowedCurrencies, donorFields / requiredDonorFields, allowedOrigins (stored normalized to hostnames), displayMode, successUrl and branding.
See also
- Create a widget — full field documentation for every widget in this list.
- Get a widget — fetch a single widget by id.
- Widget checkout (public) — the one public endpoint these widgets drive.