List 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"
}
}
],
"take": 100,
"skip": 0,
"total_count": 3,
"filtered_count": 1,
"has_more_results": false
}
}
Response fields
| Field | Type | Description |
|---|---|---|
| conversions | array | One entry per conversion in the period (paged by skip/take). |
| conversions[].conversion_uuid | string | Stable unique identifier for the conversion. Use it as a dedupe key. |
| conversions[].id | string | The tracking link id. |
| conversions[].dsid | string | The DailyStory contact id (dsid) that converted. Use it to look up the full contact. |
| conversions[].campaign | string | The name of the campaign the contact belongs to. |
| conversions[].campaignId | integer | The id of the campaign the contact belongs to. |
| conversions[].conversion_value | number | The attributed conversion value. |
| conversions[].date_converted | string | The conversion time in UTC, ISO 8601 (e.g. 2026-07-25T14:32:00Z). |
| conversions[].properties | object | Tenant-specific attributes captured with the conversion. Keys vary by account. |
| take | integer | The page size that was requested. |
| skip | integer | The number of records skipped. |
| total_count | integer | The total number of conversions in the period. |
| filtered_count | integer | The number of conversions returned in this page. |
| has_more_results | boolean | True 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.