---
title: "List Conversion Updates"
method: GET
path: "/reports/conversions/updates"
tags: ["Reports"]
---

# List Conversion Updates

`GET /reports/conversions/updates`

List conversion updates within a date range [start, end]. Start date must be before end date and the date range must not be greater than 60 days

## Query parameters

- `orderId` string
- `subid1` string
- `subid2` string
- `clickid` string
- `start` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `end` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `conversionId` string
- `marketplace` 'all' | 'walmart.com' | 'shopify.com', required — Represents a Levanta marketplace with conversion level data (ex: walmart.com, shopify.com).
- `cursor` string — The cursor returned from the last request, if omitted the first page will be returned
- `limit` number — The maximum number of items to return

## Response `200`

Success

- object
  - `updates` object[], required
    - `id` string, required
    - `date` string, date-time, required — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
    - `quantityDiff` number, required
    - `salesDiff` string, required
    - `commissionAmountDiff` string, required
    - `conversion` object, required
      - `date` string, date-time, required — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
      - `subid1` string
      - `subid2` string
      - `sharedId` string
      - `clickid` string
      - `id` string, required
      - `orderId` string, required
      - `quantity` number, required
      - `sales` string, required
      - `commissionAmount` string, required
      - `marketplace` 'walmart.com' | 'shopify.com', required
      - `product` object, required
        - `primaryId` string, required
        - `ids` object[], required
          - `label` 'ASIN' | 'SKU' | 'GTIN' | 'Walmart Item ID' | 'Variant ID', required
          - `value` string, required
        - `title` string, required
      - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'PAID', required — The status of the conversion. - PENDING: The conversion is pending approval. - APPROVED: The conversion was approved and due to be paid out. - REJECTED: The conversion was rejected. - PAID: The conversion has been paid out.
  - `cursor` string, nullable, required — The cursor to use for the next request, if empty there are no more items to return

## Other responses

- `401` — Unauthorized
- `422` — Input Validation Failed

---

[API](https://skmtc.dev/levanta/apis/levanta-creator-api-v2.md) · [All operations](https://skmtc.dev/levanta/apis/levanta-creator-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/levanta/levanta-creator-api-v2/revisions/f5dfab95939b/schema)
