BrickLink Store API helper/CLI (OAuth 1.0 request signing). Covers orders, store inventory (read + write), catalog, categories, colors, feedback, and push notifications. Use when this capability is needed.
Use scripts/bricklink.py.
See SETUP.md for prerequisites and setup instructions.
bricklink.py get-orders [--direction in|out] [--status ...] [--include-status ...] [--exclude-status ...] [--filed true|false] - Lists orders you received or placed.
bricklink.py get-order <order_id> - Fetches details for a specific order.
bricklink.py get-order-items <order_id> - Fetches the item batches for a specific order.
bricklink.py get-order-messages <order_id> - Fetches messages associated with a specific order.
bricklink.py get-order-feedback <order_id> - Fetches feedback associated with a specific order.
bricklink.py get-feedback [--direction in|out] - Lists feedback you received (in) or posted (out).
bricklink.py get-feedback-item <feedback_id> - Fetches a single feedback entry by id.
bricklink.py get-notifications - Lists unread push notifications (/notifications).
bricklink.py get-categories - Lists all catalog categories.
bricklink.py get-category <category_id> - Fetches a single category by id.
bricklink.py get-colors - Lists all catalog colors.
bricklink.py get-color <color_id> - Fetches a single color by id.
bricklink.py get-inventories [--item-type ...] [--status ...] [--category-id ...] [--color-id ...] - Lists your store inventory lots (supports include/exclude filters).
bricklink.py get-inventory <inventory_id> - Fetches a single inventory lot by id.
bricklink.py get-item <type> <no> - Fetches a catalog item (PART/SET/MINIFIG/…).
bricklink.py get-supersets <type> <no> [--color-id N] - Lists items that contain the specified item.
bricklink.py get-subsets <type> <no> [--color-id N] [--box true|false] [--instruction true|false] [--break-minifigs true|false] [--break-subsets true|false] - Parts out an item into its included items.
bricklink.py get-price-guide <type> <no> [--color-id N] [--guide-type stock|sold] [--new-or-used N|U] [--country-code XX] [--region ...] [--currency-code XXX] [--vat N|Y|O] - Fetches price guide statistics.
bricklink.py get-known-colors <type> <no> - Lists known colors for a catalog item.
Note: Order mutations (update-order, update-order-status, update-payment-status) only work for store orders (direction=out, where you are the seller). Purchases (direction=in) return 404 — the BrickLink API does not allow buyers to modify order status or file/archive incoming orders. Use the BrickLink website for those.
bricklink.py update-order <order_id> [--remarks ...] [--is-filed true|false] [--shipping-...] [--cost-...] — Updates allowed order fields (tracking, remarks, shipping/cost fields). Store orders only.
bricklink.py update-order-status <order_id> <status> — Updates the status of an order. Store orders only.
bricklink.py update-payment-status <order_id> <payment_status> — Updates the payment status of an order. Store orders only.
bricklink.py send-drive-thru <order_id> [--mail-me] — Sends a "Drive Thru" email for an order.
bricklink.py post-feedback --order-id N --rating 0|1|2 [--comment ...] - Posts new feedback for an order.
bricklink.py reply-feedback <feedback_id> --reply "..." - Replies to feedback you received.
bricklink.py create-inventory [--item-type ... --item-no ... --color-id N --quantity N --unit-price ... --new-or-used N|U ...] - Creates a single inventory lot from flags.
bricklink.py create-inventory --file batch.json - Creates multiple inventory lots from a validated JSON file (workspace or /tmp only).
bricklink.py update-inventory <inventory_id> [--quantity N --unit-price ... --new-or-used N|U --remarks ...] - Updates an inventory lot.
bricklink.py delete-inventory <inventory_id> - Deletes an inventory lot.
bricklink.py order-detail-html <order_id> [--out path] [--inline-images] - Fetches order+items and renders a compact HTML view (similar to BrickLink orderDetail.asp).Converted and distributed by TomeVault Context snippets also available to append to your CLAUDE.md, GEMINI.md, and copilot-instructions.md — download at TomeVault