Skip to main content
GET
/
api
/
pricing
/
proposals
List Proposals
curl --request GET \
  --url https://api.merchantops.ai/api/pricing/proposals
{
  "items": [
    {}
  ],
  "limit": 123,
  "skip": 123,
  "total": 123
}

Headers

​
authorization
string | null
​
X-Organization-ID
string | null

Query Parameters

​
brand_key
string | null

Filter by brand key

​
status
string | null

Filter by status

​
comparison_run_id
string | null

Filter by comparison run ID

​
batch_id
string | null

Filter by batch ID

​
is_exception
boolean | null

Filter by exception flag

​
search
string | null

Search product name, key, or style ID

​
sort_by
string | null

Optional sort override. reviewed_at_desc surfaces the most-recently reviewed proposals first (used by the Approved/Rejected tabs). Default = stable product-name order.

​
skip
integer
default:0
Required range: x >= 0
​
limit
integer
default:50
Required range: 1 <= x <= 200

Cookies

​
stytch_session
string | null

Response

Successful Response

Standard paginated list response.

​
items
Items · object[]
required
​
limit
integer
required
​
skip
integer
required
​
total
integer
required