Listing object
Seller API v1 · Updated 7 November 2026
A listing as the API returns it. When you create or update one, send the fields in the table.
Fields
| Field | Type | Description |
|---|---|---|
| item_type | string | set, minifig, part, gear or book, with item_no in klodivo numbers (6080-1, 3001). Or use bricklink_type (S, M, P, I, O, G, B) and bricklink_no. |
| color_id | integer | Parts: the colour. Or bricklink_color_id. |
| kind | string | Sets only: item, instructions or box. |
| state | string | new or used. |
| grade | string | Used items: like_new, good or acceptable. |
| completeness | string | Sets, instructions and boxes: sealed, complete or incomplete. |
| has_box | boolean | Comes with its box. |
| has_instructions | boolean | Comes with its instructions. |
| notes | string | Shown to buyers, up to 500 characters. Required for a used set. |
| quantity | integer | 0 to 99,999. 0 marks it sold out. |
| price | string | Price per unit in your store's currency, like "12.50". |
| status | string | active or hidden. |
| external_ref | string | Your own id for the listing, up to 64 characters. |
Still stuck? Contact us; we reply within 2 business days.