Suggested filters
keyword:keyword:setup
results for a specific keyword
question:question:how do I get started?
AI will suggest the best answer
Dashboard
Edit Article Logout

Get Conversions


Returns the conversions attributed to a URL shortener (tracking link) over a date range. Results are paged and mirror the tracking-link detail export β€” one entry per conversion, including any tenant-specific properties captured with the conversion. To look up the tracking link itself, see Get a URL Shortener.

Path Parameters
idstringrequired
Query Parameters
skipinteger
The number of records to skip. Defaults to 0.
takeinteger
The page size. Defaults to 100.
startstring
The start of the date range in yyyyMMdd format. Defaults to the first day of the current month.
endstring
The end of the date range in yyyyMMdd format. Defaults to today.
HTTP Response Examples
200Success
{ "Status": true, "Message": "", "Response": { "conversions": [ { "conversion_uuid": "3f9c1a72-8e4b-4d2a-9f10-6b5c7d8e9a01", "id": "5z3dzrwk", "dsid": "8a1f9c2b3d4e5f60718293a4b5c6d7e8", "campaign": "Summer Promotion", "campaignId": 1976, "conversion_value": 1250.00, "date_converted": "2026-07-25T14:32:00Z", "properties": { "tournament": "f7523d3c-30c4-4307-93e9-41b94b6aab06", "tournament_name": "Sunshine Coast Pickleball Open 2026", "attributed_url_shortener": "sfwzjtjuagwk" } } ], "take": 100, "skip": 0, "total_count": 3, "filtered_count": 1, "has_more_results": false } }

Response fields

FieldTypeDescription
conversionsarrayOne entry per conversion in the period (paged by skip/take).
conversions[].conversion_uuidstringStable unique identifier for the conversion. Use it as a dedupe key.
conversions[].idstringThe tracking link id.
conversions[].dsidstringThe DailyStory contact id (dsid) that converted. Use it to look up the full contact.
conversions[].campaignstringThe name of the campaign the contact belongs to.
conversions[].campaignIdintegerThe id of the campaign the contact belongs to.
conversions[].conversion_valuenumberThe attributed conversion value.
conversions[].date_convertedstringThe conversion time in UTC, ISO 8601 (e.g. 2026-07-25T14:32:00Z).
conversions[].propertiesobjectTenant-specific attributes captured with the conversion. Keys vary by account.
takeintegerThe page size that was requested.
skipintegerThe number of records skipped.
total_countintegerThe total number of conversions in the period.
filtered_countintegerThe number of conversions returned in this page.
has_more_resultsbooleanTrue when more records remain beyond this page.

Dates are compared in UTC and the range is inclusive of both start and end. When neither is supplied, the endpoint returns conversions for the current month to date. The properties object contains whatever attributes were recorded at conversion time, so its keys differ from one account to the next.


How helpful was this article?

πŸ‘ or πŸ‘Ž

Related Articles

Markdown Version