---
title: "Retrieve a conversion value rule"
method: GET
path: "/ad_conversion_value_rules/{id}"
tags: ["Ad Conversion Value Rules"]
---

# Retrieve a conversion value rule

`GET /ad_conversion_value_rules/{id}`

## Response `200`

Rule

- AdConversionValueRule
  - `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.

## Changes

> 72 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/:id/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/86b97292852d?raw)