Retrieve a list of events
Retrieve a paginated list of events for the authenticated workspace.
Events endpoints require a Business plan subscription or higher.
Authorizations
Default authentication mechanism
Query Parameters
The type of event to retrieve analytics for. Defaults to 'clicks'.
clicks
, leads
, sales
The domain to filter analytics for.
The short link slug.
The unique ID of the short link on Dub.
This is the ID of the link in the your database. Must be prefixed with 'ext_' when passed as a query parameter.
The interval to retrieve events for. Takes precedence over start and end. If undefined, defaults to 24h.
24h
, 7d
, 30d
, 90d
, ytd
, 1y
, all
The start date and time when to retrieve analytics from. Takes precedence over interval
.
The end date and time when to retrieve analytics from. If not provided, defaults to the current date. Takes precedence over interval
.
The IANA time zone code for aligning timeseries granularity (e.g. America/New_York). Defaults to UTC.
The continent to retrieve analytics for.
AF
, AN
, AS
, EU
, NA
, OC
, SA
The country to retrieve analytics for.
AF
, AL
, DZ
, AS
, AD
, AO
, AI
, AQ
, AG
, AR
, AM
, AW
, AU
, AT
, AZ
, BS
, BH
, BD
, BB
, BY
, BE
, BZ
, BJ
, BM
, BT
, BO
, BA
, BW
, BV
, BR
, IO
, BN
, BG
, BF
, BI
, KH
, CM
, CA
, CV
, KY
, CF
, TD
, CL
, CN
, CX
, CC
, CO
, KM
, CG
, CD
, CK
, CR
, CI
, HR
, CU
, CY
, CZ
, DK
, DJ
, DM
, DO
, EC
, EG
, SV
, GQ
, ER
, EE
, ET
, FK
, FO
, FJ
, FI
, FR
, GF
, PF
, TF
, GA
, GM
, GE
, DE
, GH
, GI
, GR
, GL
, GD
, GP
, GU
, GT
, GN
, GW
, GY
, HT
, HM
, VA
, HN
, HK
, HU
, IS
, IN
, ID
, IR
, IQ
, IE
, IL
, IT
, JM
, JP
, JO
, KZ
, KE
, KI
, KP
, KR
, KW
, KG
, LA
, LV
, LB
, LS
, LR
, LY
, LI
, LT
, LU
, MO
, MG
, MW
, MY
, MV
, ML
, MT
, MH
, MQ
, MR
, MU
, YT
, MX
, FM
, MD
, MC
, MN
, MS
, MA
, MZ
, MM
, NA
, NR
, NP
, NL
, NC
, NZ
, NI
, NE
, NG
, NU
, NF
, MK
, MP
, NO
, OM
, PK
, PW
, PS
, PA
, PG
, PY
, PE
, PH
, PN
, PL
, PT
, PR
, QA
, RE
, RO
, RU
, RW
, SH
, KN
, LC
, PM
, VC
, WS
, SM
, ST
, SA
, SN
, SC
, SL
, SG
, SK
, SI
, SB
, SO
, ZA
, GS
, ES
, LK
, SD
, SR
, SJ
, SZ
, SE
, CH
, SY
, TW
, TJ
, TZ
, TH
, TL
, TG
, TK
, TO
, TT
, TN
, TR
, TM
, TC
, TV
, UG
, UA
, AE
, GB
, US
, UM
, UY
, UZ
, VU
, VE
, VN
, VG
, VI
, WF
, EH
, YE
, ZM
, ZW
, AX
, BQ
, CW
, GG
, IM
, JE
, ME
, BL
, MF
, RS
, SX
, SS
, XK
The city to retrieve analytics for.
The device to retrieve analytics for.
The browser to retrieve analytics for.
The OS to retrieve analytics for.
The trigger to retrieve analytics for. If undefined, return both QR and link clicks.
qr
, link
The referer to retrieve analytics for.
The full referer URL to retrieve analytics for.
The URL to retrieve analytics for.
Deprecated. Use tagIds
instead. The tag ID to retrieve analytics for.
The tag IDs to retrieve analytics for.
Deprecated. Use the trigger
field instead. Filter for QR code scans. If true, filter for QR codes only. If false, filter for links only. If undefined, return both.
Filter for root domains. If true, filter for domains only. If false, filter for links only. If undefined, return both.
asc
, desc
timestamp
Response
click
Deprecated. Use click.id
instead.
Deprecated. Use link.id
instead.
Deprecated. Use link.domain
instead.
Deprecated. Use link.key
instead.
Deprecated. Use click.url
instead.
Deprecated. Use click.continent
instead.
Deprecated. Use click.country
instead.
Deprecated. Use click.city
instead.
Deprecated. Use click.device
instead.
Deprecated. Use click.browser
instead.
Deprecated. Use click.os
instead.
Deprecated. Use click.qr
instead.
Deprecated. Use click.ip
instead.
Was this page helpful?