---
title: "List conversions"
method: GET
path: "/conversions"
tags: ["Conversions"]
---

# List conversions

`GET /conversions`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/conversions`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `goal` string
- `goal_id` string
- `campaign_id` string
- `automation_id` string
- `email` string, email

## Response `200`

Conversion list

- ListConversionsResponse
  - `data` Conversion[], required
    - `id` string, required
    - `goal_id` string, required
    - `contact_id` string, nullable, required: Null when no contact matched; the email is kept either way.
    - `email` string, email, nullable, required
    - `value_cents` integer, required: Minor units of `currency`. Always 0 unless the goal is `revenue` (`visit`, `feedback`, `waitlist`, and `qualify` are count-only).
    - `currency` string, required
    - `external_id` string, nullable, required
    - `source` 'api' | 'script' | 'event', required
    - `occurred_at` string, date-time, required
    - `attributed_campaign_id` string, nullable, required
    - `attributed_variant_id` string, nullable, required
    - `attributed_recipient_id` string, nullable, required
    - `attributed_automation_id` string, nullable, required: The automation credited with the conversion, when the winning touch was an email that automation sent. Null otherwise (including when a campaign is credited).
    - `attributed_run_id` string, nullable, required: The automation run that sent that email. Null unless `attributed_automation_id` is set.
    - `attribution_kind` 'click' | 'open' | 'send' | 'none', required: How the conversion was tied to a campaign or automation, strongest first. Reported so you can discount weak attribution rather than treat every conversion as earned: `click` came from a click id or a clicked email, `open` and `send` from the last campaign or automation email that reached the person inside the goal's window, and `none` means the conversion is unattributed.
    - `ad_gclid` string, nullable, required: Google Ads click id (`gclid`) tied to the conversion: the ad click the tracking script saw in the browser when it reported the conversion, otherwise the ad click that first brought the contact in. Null when there is none.
    - `ad_gbraid` string, nullable, required: Google Ads `gbraid` click id, used instead of `gclid` for iOS app-to-web clicks. Same sourcing as `ad_gclid`.
    - `ad_wbraid` string, nullable, required: Google Ads `wbraid` click id, used instead of `gclid` for web-to-web clicks where no cross-site identifier can be set. Same sourcing as `ad_gclid`.
    - `created_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid cursor
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)