---
title: "List conversion value rules"
method: GET
path: "/ad_conversion_value_rules"
tags: ["Ad Conversion Value Rules"]
---

# List conversion value rules

`GET /ad_conversion_value_rules`

List saved rules the caller can read. Filter by business with account_id.

## Query parameters

- `account_id` string
- `status` 'active' | 'paused'
- `platform` 'tiktok' | 'meta' | 'google'
- `resource_id` string
- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'created_at'
- `direction` 'asc' | 'desc'

## Response `200`

Rules

- object
  - `data` AdConversionValueRule[], required
    - `account_id` string, required — Business that owns this shared, editable rule.
    - `adjustment_type` 'fixed' | 'percentage', required — Set a fixed amount or change the original value by a signed percentage.
    - `created_at` string, required — When the rule was created, as an ISO 8601 timestamp.
    - `events` AdConversionValueRuleEvent[], required
      - `custom_name` string, nullable, required — Exact custom event name. Null for standard events.
      - `event_name` 'purchase' | 'subscribe' | 'start_trial' | 'lead' | 'complete_registration' | 'submit_application' | 'schedule' | 'contact' | 'view_content' | 'add_to_cart' | 'custom', required — Event to adjust. Purchase includes Whop purchases and external purchase events.
    - `fixed_value` Money, required
      - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
      - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
      - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `id` string, required — Conversion value rule ID, prefixed adcvr_.
    - `metadata` object, required — Free-form string keys and values for the caller.
    - `percentage_change` number, nullable, required — Signed percent change: 20 increases by 20%, negative 20 decreases by 20%. The sent value cannot go below zero. Null for a fixed rule.
    - `status` 'active' | 'paused', required — Whether this rule is active or paused.
    - `targets` AdConversionValueRuleTarget[], required
      - `platform` 'tiktok' | 'meta' | 'google', required — Ad platform that receives the adjusted value.
      - `resource_id` string, nullable, required — Selected campaign, ad group, or ad ID. Null for a business target.
      - `resource_title` string, nullable, required — Name of the selected item. Null when it is no longer available.
      - `scope` 'business' | 'campaign' | 'ad_group' | 'ad', required — Business, campaign, ad group, or ad covered by this target.
    - `updated_at` string, required — When the rule was edited, as an ISO 8601 timestamp.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Changes

> 70 revisions in range; 1 not diffed.

- **2026-09-21** `ac2b9b1c6a00` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/ad_conversion_value_rules/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/7fcefabddb0a?raw)