Skip to main content
POST
Run Economic Intelligence

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-09-11"

Body

application/json
input
string
required

What the owner wants, in their own words. Up to 1000 characters.

Maximum string length: 1000
Example:

"get more repeat buyers for my taurine supplement"

account_id
string

Account ID, prefixed biz_. Defaults to the API key's own account.

Example:

"biz_xxxxxxxxxxxxxx"

Response

recommendation queued

account_id
string
required

The account this recommendation is for, prefixed biz_

Example:

"biz_xxxxxxxxxxxxxx"

action_type
string | null
required

The playbook action this card recommends, or null for an untyped card; new values may be added, so handle unknown types gracefully

Example:

"scale_winning_ads"

created_at
string
required

When the recommendation was created, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

executed_at
string | null
required

When the card was run, as an ISO 8601 timestamp, or null

Example:

"2026-01-01T12:00:00.000Z"

execution_type
enum<string>
required

How the card runs. whop_ai means prompt is sent to Whop AI, which carries out every step.

Available options:
whop_ai
Example:

"whop_ai"

expected_delta
object | null
required

Expected change in that ledger line over the evaluation window, in USD, negative when the action reduces it, or null

expected_ledger_line
string | null
required

The ledger line the action is expected to move, or null when the card carries no expectation

Example:

"ad_spend_charge"

id
string
required

Economic intelligence ID, prefixed reca_

Example:

"reca_xxxxxxxxxxxxxx"

inference_version
string
required

The engine that generated the card, e.g. whop-ai-v5

Example:

"whop-ai-v5"

input
string | null
required

What the owner asked for, in their own words, when this recommendation was requested, or null when the engine chose the action on its own

Example:

"more sales from ads"

prompt
string | null
required

The step-by-step brief Whop AI executes when the card is run, or null

Example:

"Create a 20% off promo code for my members."

reasoning
string | null
required

The signal and number the recommendation rests on, or null

Example:

"Capped 9 of 14 days."

status
enum<string>
required

queued once requested and not yet picked up; pending while the engine is generating; ready when the card is written and the owner can run it; executed once it was run; superseded when a newer card of the same action type replaced it; failed when the engine had nothing to recommend for the request

Available options:
queued,
pending,
ready,
executed,
superseded,
failed
Example:

"ready"

superseded_at
string | null
required

When a newer card replaced this one, as an ISO 8601 timestamp, or null

title
string | null
required

The recommendation as the owner sees it: one command with the payoff, or null until the engine has written the card

Example:

"Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"