Value a donation list
value_donation_listRead-onlyIdempotent
Fair-market values for a whole donation list (clothing, shoes, bags and household goods: kitchen, home, electronics, media, toys, baby gear, pets, beauty), each item with the Poshmark sales behind it, a list total and a dated method paragraph the donor can keep with their records. One call values up to 100 items and costs one lookup per item. Call it once with the whole list, not once per item.
items: a list of objects, one per item. Only description is required.
description: what it is, as the donor would say it: "womens handbag", "mens suit", "kids snow pants",
"Levi's 501 jeans", "KitchenAid stand mixer". Put brand and model in brand or description. Goods are
valued only from sales of the same product, so name it as it would be listed; a count in the text
("throw pillows (4)") is read as the quantity.
brand: optional, e.g. "Coach". With a brand the item is priced from that brand's own sales when enough are
saved, else from its category.
condition: optional. new_with_tags, used_like_new, used_excellent, used_good, used_fair, a plain word
(like new, good, fair), or new or used. Default used, which is right for most donations.
category, department, size: optional; read from the description when left out. A kids' size such as
"4T" marks the item as kids'.
kids_age: optional, for kids' items: "baby" (0-24 months), "toddler" (2T-5T) or "big_kids" (4/5 and up).
quantity: optional, default 1. total is value times quantity.
source: "poshmark" (US, USD, default) or "poshmark_ca" (Poshmark Canada, CAD).
examples_per_item: how many of the sales behind each value to include (0-5, default 2). Each has a title,
price, sold date and link.
days: only sales from the last N days (1-3650); 365 is the last 12 months. Default: every sale.
sold_after, sold_before: only sales sold on or after / on or before these dates (YYYY-MM-DD).
On the Free, pass and Starter plans every value uses only sales from the last 90 days (any window is cut to
it, history_days is 90 and history_note says so), except keys issued before Oct 25 2026, which keep the full
archive (history_days is null); Growth and Scale use the full archive, back to 2012.
Each item gets value (the median sold price), low and high (the 25th and 75th percentiles), p10 and p90
(the 10th and 90th), sales_used, oldest_sold and newest_sold (within the window), matched_on ("brand +
item", "item description", "category + department" or "category, all departments"), broadened (true when
the value comes from wider sales than the item as described: no brand match, a description reduced to its
category, all departments, or the condition group instead of the exact grade), condition_matched (the grade
or group the sales are in), by_condition (median and range per grade), a confidence rating and a reason
that says why. basis is the older name of matched_on. An item with nothing to go on has value null and a
reason; never guess a value for it. The list has total, items_valued, method and disclaimer. This is resale
market data, not tax or legal advice; appraisal_may_be_needed is true when a single item, or a group of similar items (same category), is over $5,000.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| items | Yes | ||
| source | No | poshmark | |
| sold_after | No | ||
| sold_before | No | ||
| examples_per_item | No |