{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"BrickPicker Public API","description":"Read-only LEGO catalog, market-value, Brickfolio, retail-watch, and Sales Ledger data. Private data is always limited to the authenticated BrickPicker account.","version":"1.0.0","termsOfService":"https://brickpicker.com/legal/terms","contact":{"name":"BrickPicker Support","url":"https://brickpicker.com/support","email":"support@brickpicker.com"},"license":{"name":"BrickPicker API Terms","url":"https://brickpicker.com/legal/terms"}},"servers":[{"url":"https://api.brickpicker.com/api/v1"}],"paths":{"/set/{number}":{"get":{"operationId":"getSet","parameters":[{"name":"number","required":true,"in":"path","description":"LEGO set number (e.g. 75192)","schema":{"type":"string","example":"75192"}}],"responses":{"200":{"description":"Set details","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Set"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"set_number":"75192","title":"Millennium Falcon","theme":"Star Wars","subtheme":"Ultimate Collector Series","pieces":7541,"minifigs_count":8,"msrp_usd":849.99,"release_date":"2017-10-01","retire_date":null,"status_id":1,"data_tier":"verified","image_url":"https://images.brickpicker.com/images/sets/75192.jpg","new_value_usd":799.99,"used_value_usd":645,"value_range":{"low":760,"high":835,"calculated_at":"2026-07-28T04:00:00.000Z"},"retailers":[{"retailer":"amazon","retailer_name":"Amazon","current_price":849.99,"list_price":849.99,"discount_percent":0,"in_stock":true,"is_first_party":true,"product_url":"https://www.amazon.com/dp/B075SDMND1","last_checked_at":"2026-07-28T12:00:00.000Z"}],"minifigs":["sw1034"],"barcodes":{"upc":"673419267656","ean":null},"box":{"width_in":23,"height_in":19,"depth_in":15,"weight_lbs":29.1}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"404":{"description":"Set not found","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"NotFound","message":"The requested BrickPicker resource was not found."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Get set metadata, current value, retailer prices, prediction consensus","tags":["Public API v1"],"description":"Returns one set’s identity, BrickPicker-derived current values, value range, public barcodes, box data, contained minifig identifiers, and current retailer summaries. Licensed source rows are never returned.","x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/minifig/{number}":{"get":{"operationId":"getMinifig","parameters":[{"name":"number","required":true,"in":"path","description":"BrickLink minifig number / part_no (e.g. sw0001a)","schema":{"type":"string","example":"sw0001a"}}],"responses":{"200":{"description":"Minifig details","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Minifig"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"minifig_number":"sw0001a","name":"Battle Droid with One Straight Arm","category":"Star Wars","year_released":1999,"image_url":null,"current_value_usd":4.25,"value_range":{"low":3.5,"high":5.25},"set_count":3,"sets":["7101","7121","7151"]},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"404":{"description":"Minifig not found","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"NotFound","message":"The requested BrickPicker resource was not found."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Get minifig metadata + current market value","tags":["Public API v1"],"description":"Returns one minifigure’s identity, BrickPicker-derived market value and range, plus the set numbers in which it appears.","x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/catalog/sets/search":{"get":{"description":"Searches catalog identity only; it does not return valuations. Use each returned set_number with getSet. Paginate with limit and offset.","operationId":"searchSets","parameters":[{"name":"offset","required":false,"in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based number of records to skip."},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":50},"description":"Maximum records to return in this page."},{"name":"q","required":true,"in":"query","schema":{"type":"string","minLength":2,"example":"Millennium Falcon"},"description":"Catalog search term; match a set/minifigure number or name."}],"responses":{"200":{"description":"Matching sets (identity only)","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":"string"},"title":{"type":"string"},"theme":{"type":["string","null"]},"subtheme":{"type":["string","null"]},"pieces":{"type":["integer","null"]},"year":{"type":["integer","null"]},"retired":{"type":"boolean"},"image_url":{"type":["string","null"]}},"required":["set_number","title","theme","subtheme","pieces","year","retired","image_url"]}},"pagination":{"$ref":"#/components/schemas/ApiPagination"}},"required":["results","pagination"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"results":[{"set_number":"75192","title":"Millennium Falcon","theme":"Star Wars","subtheme":"Ultimate Collector Series","pieces":7541,"year":2017,"retired":false,"image_url":"https://images.brickpicker.com/images/sets/75192.jpg"}],"pagination":{"total":1,"limit":50,"offset":0,"has_more":false}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Search the set catalog by number, name, or theme (identity only)","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/catalog/minifigs/search":{"get":{"description":"Searches minifigure identity only; it does not return valuations. Use each returned minifig_number with getMinifig. Paginate with limit and offset.","operationId":"searchMinifigs","parameters":[{"name":"offset","required":false,"in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based number of records to skip."},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":50},"description":"Maximum records to return in this page."},{"name":"q","required":true,"in":"query","schema":{"type":"string","minLength":2,"example":"Millennium Falcon"},"description":"Catalog search term; match a set/minifigure number or name."}],"responses":{"200":{"description":"Matching minifigs (identity only)","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"minifig_number":{"type":"string"},"name":{"type":"string"},"category":{"type":["string","null"]},"year_released":{"type":["integer","null"]},"image_url":{"type":["string","null"]}},"required":["minifig_number","name","category","year_released","image_url"]}},"pagination":{"$ref":"#/components/schemas/ApiPagination"}},"required":["results","pagination"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"results":[{"minifig_number":"sw0001a","name":"Battle Droid with One Straight Arm","category":"Star Wars","year_released":1999,"image_url":"https://images.brickpicker.com/minifigs/sw0001a.jpg"}],"pagination":{"total":1,"limit":50,"offset":0,"has_more":false}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Search the minifig catalog by number or name (identity only)","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/catalog/themes":{"get":{"operationId":"getThemes","parameters":[],"responses":{"200":{"description":"Themes with set counts","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"themes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"theme":{"type":"string"},"set_count":{"type":"integer","minimum":0}},"required":["theme","set_count"]}}},"required":["themes"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"themes":[{"theme":"Star Wars","set_count":912}]},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"List all LEGO themes in the catalog + set counts","tags":["Public API v1"],"description":"Lists catalog themes and the number of sets in each theme. This compact reference list is not paginated.","x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/catalog/batch":{"post":{"description":"Looks up as many as 100 unique sets and minifigures. A batch of N items consumes N daily calls; missing items return found=false without failing the batch.","operationId":"batchLookup","parameters":[],"requestBody":{"required":true,"description":"One or both arrays must contain at least one identifier; the combined maximum is 100 unique items.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchLookupRequest"},"example":{"sets":["75192"],"minifigs":["sw0001a"]}}}},"responses":{"200":{"description":"Per-item results + summary","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"sets":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/BatchSet"},{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":"string"},"found":{"type":"boolean","const":false}},"required":["set_number","found"]}]}},"minifigs":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/BatchMinifig"},{"type":"object","additionalProperties":false,"properties":{"minifig_number":{"type":"string"},"found":{"type":"boolean","const":false}},"required":["minifig_number","found"]}]}},"summary":{"type":"object","additionalProperties":false,"properties":{"requested":{"type":"integer","minimum":1,"maximum":100},"found":{"type":"integer","minimum":0,"maximum":100}},"required":["requested","found"]}},"required":["sets","minifigs","summary"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"sets":[{"set_number":"75192","title":"Millennium Falcon","theme":"Star Wars","subtheme":"Ultimate Collector Series","pieces":7541,"minifigs_count":8,"msrp_usd":849.99,"release_date":"2017-10-01","retire_date":null,"status_id":1,"data_tier":"verified","image_url":"https://images.brickpicker.com/images/sets/75192.jpg","new_value_usd":799.99,"used_value_usd":645,"value_range":{"low":760,"high":835,"calculated_at":"2026-07-28T04:00:00.000Z"},"retailers":[{"retailer":"amazon","retailer_name":"Amazon","current_price":849.99,"list_price":849.99,"discount_percent":0,"in_stock":true,"is_first_party":true,"product_url":"https://www.amazon.com/dp/B075SDMND1","last_checked_at":"2026-07-28T12:00:00.000Z"}],"minifigs":["sw1034"],"barcodes":{"upc":"673419267656","ean":null},"box":{"width_in":23,"height_in":19,"depth_in":15,"weight_lbs":29.1},"found":true}],"minifigs":[{"minifig_number":"not-a-minifig","found":false}],"summary":{"requested":2,"found":1}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Look up many sets and/or minifigs in one call (batch of N charges N quota)","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":"one-per-item"}},"/set/{number}/history":{"get":{"description":"Returns finalized monthly BrickPicker market-value history for one set and one condition. In-progress months are excluded.","operationId":"getSetHistory","parameters":[{"name":"number","required":true,"in":"path","description":"LEGO set number (e.g. 75192)","schema":{"type":"string","example":"75192"}},{"name":"condition","required":false,"in":"query","schema":{"enum":["sealed","used"],"type":"string","default":"sealed"},"description":"Market-value condition."}],"responses":{"200":{"description":"Monthly value history","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":"string"},"condition":{"type":"string","enum":["sealed","used"]},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"value_usd":{"type":["number","null"]},"range_low":{"type":["number","null"]},"range_high":{"type":["number","null"]},"sales_count":{"type":["integer","null"]},"event":{"type":["string","null"]}},"required":["month","value_usd","range_low","range_high","sales_count","event"]}}},"required":["set_number","condition","history"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"set_number":"75192","condition":"sealed","history":[{"month":"2026-06","value_usd":799.99,"range_low":760,"range_high":835,"sales_count":18,"event":null}]},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"404":{"description":"Set not found","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"NotFound","message":"The requested BrickPicker resource was not found."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Finalized monthly market-value history for a single set","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/set/{number}/retail-prices":{"get":{"description":"Returns current Amazon and Walmart pricing intelligence for one set number, or null when no retailer row exists.","operationId":"getRetailPrices","parameters":[{"name":"number","required":true,"in":"path","description":"LEGO set number (e.g. 75192)","schema":{"type":"string","example":"75192"}}],"responses":{"200":{"description":"Retail prices for the set","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/RetailWatchRow"},{"type":"null"}]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"setNumber":"75192","name":"Millennium Falcon","asin":"B075SDMND1","upc":"673419267656","ean":null,"paid":699.99,"amazon":{"price":849.99,"sellerType":"retailer","changedAt":"2026-07-28T12:00:00.000Z","lastChange":-50,"flip1pTo3p":false,"atLowest":false,"lowest":734.99,"inStock":true},"walmart":{"price":null,"sellerType":null,"changedAt":null,"lastChange":null,"flip1pTo3p":false,"atLowest":false,"lowest":null,"inStock":null},"amazonExit":{"lowestFba":829.99,"fbaSellers":4,"buyBox":849.99,"netFba":665.4}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Current Amazon/Walmart retail price + Buy Box owner (1P/3P) for a set","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/retail-prices":{"get":{"description":"Resolves one set by set number, ASIN, or UPC/EAN and returns current Amazon and Walmart pricing intelligence. Returns null when no identifier matches.","operationId":"lookupRetailPrices","parameters":[{"name":"set","required":false,"in":"query","description":"LEGO set number (e.g. 75192)","schema":{"type":"string","example":"75192"}},{"name":"asin","required":false,"in":"query","description":"Amazon ASIN (e.g. B075SDMND1)","schema":{"type":"string","example":"B075SDMND1"}},{"name":"upc","required":false,"in":"query","description":"UPC or EAN","schema":{"type":"string","example":"673419267656"}}],"responses":{"200":{"description":"","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/RetailWatchRow"},{"type":"null"}]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"setNumber":"75192","name":"Millennium Falcon","asin":"B075SDMND1","upc":"673419267656","ean":null,"paid":699.99,"amazon":{"price":849.99,"sellerType":"retailer","changedAt":"2026-07-28T12:00:00.000Z","lastChange":-50,"flip1pTo3p":false,"atLowest":false,"lowest":734.99,"inStock":true},"walmart":{"price":null,"sellerType":null,"changedAt":null,"lastChange":null,"flip1pTo3p":false,"atLowest":false,"lowest":null,"inStock":null},"amazonExit":{"lowestFba":829.99,"fbaSellers":4,"buyBox":849.99,"netFba":665.4}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Look up one set's live Amazon/Walmart price by set number, ASIN, or UPC","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"single-item-or-bounded-read","x-brickpicker-daily-quota-cost":1}},"/brickfolio/retail-watch":{"get":{"description":"Returns current Amazon and Walmart price, Buy Box state, and cost-basis context for holdings owned by the authenticated account. Optional filters reduce the returned rows.","operationId":"getBrickfolioRetailWatch","parameters":[{"name":"changed_within","required":false,"in":"query","description":"Return holdings whose Amazon or Walmart price changed in this window.","schema":{"type":"string","pattern":"^\\d+(m|h|d)$","example":"24h"}},{"name":"since","required":false,"in":"query","description":"Return holdings whose retailer price changed on or after this instant.","schema":{"type":"string","format":"date-time","example":"2026-07-28T00:00:00.000Z"}},{"name":"asin","required":false,"in":"query","description":"ASIN, or comma-separated ASINs — return only these sets","schema":{"type":"string","example":"B075SDMND1"}},{"name":"upc","required":false,"in":"query","description":"UPC/EAN, or comma-separated — return only these sets","schema":{"type":"string","example":"673419267656"}}],"responses":{"200":{"description":"Retail Watch rows for the caller","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RetailWatchRow"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"setNumber":"75192","name":"Millennium Falcon","asin":"B075SDMND1","upc":"673419267656","ean":null,"paid":699.99,"amazon":{"price":849.99,"sellerType":"retailer","changedAt":"2026-07-28T12:00:00.000Z","lastChange":-50,"flip1pTo3p":false,"atLowest":false,"lowest":734.99,"inStock":true},"walmart":{"price":null,"sellerType":null,"changedAt":null,"lastChange":null,"flip1pTo3p":false,"atLowest":false,"lowest":null,"inStock":null},"amazonExit":{"lowestFba":829.99,"fbaSellers":4,"buyBox":849.99,"netFba":665.4}}],"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Amazon/Walmart price + margin vs cost for every set in the caller's Brickfolio","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"authenticated-account-only","x-brickpicker-daily-quota-cost":1}},"/brickfolio":{"get":{"description":"Returns lightweight summaries for Brickfolios owned by the authenticated account and monthly cost-basis rollups. Retrieve individual holdings with getBrickfolioEntries.","operationId":"getBrickfolio","parameters":[],"responses":{"200":{"description":"Brickfolio summaries + monthly periods","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"brickfolios":{"type":"array","items":{"$ref":"#/components/schemas/BrickfolioSummary"}},"monthly_periods":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"entry_count":{"type":"integer","minimum":0},"items":{"type":"integer","minimum":0},"cost_basis_usd":{"type":["number","null"]}},"required":["month","entry_count","items","cost_basis_usd"]}}},"required":["brickfolios","monthly_periods"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"brickfolios":[{"id":42,"name":"Main Collection","description":null,"is_default":true,"owned_set_count":85,"owned_item_count":93,"total_cost_basis_usd":6210.45,"total_current_value_usd":7885.2,"unrealized_gain_loss_usd":1674.75,"created_at":"2024-01-15T14:12:00.000Z"}],"monthly_periods":[{"month":"2024-11","entry_count":8,"items":10,"cost_basis_usd":924.5}]},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Get the caller's brickfolio summaries + monthly cost-basis periods","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"authenticated-account-only","x-brickpicker-daily-quota-cost":1}},"/brickfolio/analytics":{"get":{"description":"Returns aggregate value, cost basis, unrealized performance, top movers, and value history for the authenticated account’s holdings.","operationId":"getBrickfolioAnalytics","parameters":[{"name":"period","required":false,"in":"query","schema":{"enum":["30d","90d","1y"],"type":"string","default":"1y"},"description":"Portfolio analytics lookback period."}],"responses":{"200":{"description":"Brickfolio analytics","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"period":{"type":"string","enum":["30d","90d","1y"]},"summary":{"type":"object","additionalProperties":false,"properties":{"total_sets":{"type":"integer","minimum":0},"total_items":{"type":"integer","minimum":0},"total_cost_basis_usd":{"type":"number"},"total_current_value_usd":{"type":"number"},"unrealized_gain_loss_usd":{"type":"number"},"unrealized_gain_loss_pct":{"type":"number"},"top_gainer":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":["string","null"]},"title":{"type":["string","null"]},"gain_pct":{"type":["number","null"]}},"required":["set_number","title","gain_pct"]},{"type":"null"}]},"top_loser":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":["string","null"]},"title":{"type":["string","null"]},"loss_pct":{"type":["number","null"]}},"required":["set_number","title","loss_pct"]},{"type":"null"}]}},"required":["total_sets","total_items","total_cost_basis_usd","total_current_value_usd","unrealized_gain_loss_usd","unrealized_gain_loss_pct","top_gainer","top_loser"]},"value_history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string"},"total_value_usd":{"type":"number"},"cost_basis_usd":{"type":"number"},"gain_loss_usd":{"type":"number"},"gain_loss_pct":{"type":"number"}},"required":["date","total_value_usd","cost_basis_usd","gain_loss_usd","gain_loss_pct"]}}},"required":["period","summary","value_history"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"period":"1y","summary":{"total_sets":85,"total_items":93,"total_cost_basis_usd":6210.45,"total_current_value_usd":7885.2,"unrealized_gain_loss_usd":1674.75,"unrealized_gain_loss_pct":26.97,"top_gainer":{"set_number":"21325","title":"Medieval Blacksmith","gain_pct":51.2},"top_loser":null},"value_history":[{"date":"2026-07-01","total_value_usd":7885.2,"cost_basis_usd":6210.45,"gain_loss_usd":1674.75,"gain_loss_pct":26.97}]},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"The caller's portfolio analytics — summary + value history","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"authenticated-account-only","x-brickpicker-daily-quota-cost":1}},"/brickfolio/entries":{"get":{"description":"Returns a bounded page of holdings owned by the authenticated account. Continue with offset + limit until pagination.has_more is false.","operationId":"getBrickfolioEntries","parameters":[{"name":"brickfolio_id","required":false,"in":"query","schema":{"type":"number","minimum":1,"example":42},"description":"Optional Brickfolio identifier owned by the authenticated account."},{"name":"offset","required":false,"in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based number of records to skip."},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":50},"description":"Maximum records to return in this page."}],"responses":{"200":{"description":"Paginated brickfolio holdings","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/Holding"}},"pagination":{"$ref":"#/components/schemas/ApiPagination"}},"required":["entries","pagination"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"entries":[{"brickfolio_id":42,"set_number":"75192","title":"Millennium Falcon","theme":"Star Wars","quantity":1,"condition":"new","purchase_price_usd":699.99,"purchase_date":"2024-11-29","status":"owned","current_value_usd":799.99,"total_current_value_usd":799.99,"unrealized_gain_loss_usd":100,"unrealized_gain_loss_pct":14.29}],"pagination":{"total":1,"limit":50,"offset":0,"has_more":false}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"404":{"description":"brickfolio_id not found for caller","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"NotFound","message":"The requested BrickPicker resource was not found."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Get the caller's holdings, paginated (default 50/page, max 250)","tags":["Public API v1"],"x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"authenticated-account-only","x-brickpicker-daily-quota-cost":1}},"/salesledger":{"get":{"operationId":"getSalesLedger","parameters":[{"name":"offset","required":false,"in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based number of records to skip."},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":50},"description":"Maximum records to return in this page."}],"responses":{"200":{"description":"Sales ledger entries","headers":{"X-Request-Id":{"description":"Unique identifier for support and diagnostics.","schema":{"type":"string","format":"uuid"}},"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}},"X-RateLimit-Limit":{"description":"Daily request allowance for this API key.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Requests remaining before the UTC reset.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"UTC time at which the daily allowance resets.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"sales":{"type":"array","items":{"$ref":"#/components/schemas/Sale"}},"pagination":{"$ref":"#/components/schemas/ApiPagination"}},"required":["sales","pagination"]},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"sales":[{"id":901,"set_number":"21325","title":"Medieval Blacksmith","theme":"Ideas","platform":"eBay","sale_date":"2026-07-15","quantity":1,"condition":"New","gross_proceeds_usd":219.99,"platform_fees_usd":28.6,"payment_fees_usd":0,"shipping_cost_usd":14.2,"shipping_charged_usd":0,"net_proceeds_usd":177.19,"profit_loss_usd":47.2,"roi_pct":36.31,"cost_basis_usd":129.99,"purchase_date":"2023-11-24"}],"pagination":{"total":1,"limit":50,"offset":0,"has_more":false}},"meta":{"request_id":"9cf9eac3-d389-45ad-a1c4-441b4956f319","api_version":"1","rate_limit":{"limit":1000,"remaining":999,"reset":"2026-07-30T00:00:00.000Z"}}}}}},"400":{"description":"The request parameters or body are invalid.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"BadRequest","message":"Correct the invalid request fields and try again."}}}}},"401":{"description":"The bearer API key is missing, invalid, expired, or revoked.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"InvalidApiKey","message":"Supply a valid BrickPicker API key as a Bearer token."}}}}},"403":{"description":"The authenticated account does not have the required plan entitlement.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"TierRequired","message":"The BrickPicker Reseller plan is required for the Public API."}}}}},"429":{"description":"The API key has exhausted its daily request allowance.","headers":{"X-API-Version":{"description":"BrickPicker Public API contract version.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"example":{"error":{"code":"QuotaExceeded","message":"The daily request allowance is exhausted. Retry after the reset time."}}}}}},"security":[{"bearer":[]}],"summary":"Get the caller's sales ledger (Reseller-tier only)","tags":["Public API v1"],"description":"Returns a bounded page of sales owned by the authenticated Reseller account, including proceeds, fees, cost basis, profit, and ROI.","x-brickpicker-entitlement":"reseller","x-brickpicker-data-scope":"authenticated-account-only","x-brickpicker-daily-quota-cost":1}}},"components":{"schemas":{"ApiPagination":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":250},"offset":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}},"required":["total","limit","offset","has_more"]},"ApiRateLimit":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1},"remaining":{"type":"integer","minimum":0},"reset":{"type":"string","format":"date-time"}},"required":["limit","remaining","reset"]},"ApiMeta":{"type":"object","additionalProperties":false,"properties":{"request_id":{"type":"string","format":"uuid"},"api_version":{"type":"string","const":"1"},"rate_limit":{"$ref":"#/components/schemas/ApiRateLimit"}},"required":["request_id","api_version","rate_limit"]},"ApiErrorMeta":{"type":"object","additionalProperties":false,"properties":{"request_id":{"type":"string","format":"uuid"},"api_version":{"type":"string","const":"1"},"rate_limit":{"$ref":"#/components/schemas/ApiRateLimit"}},"required":["api_version"]},"ApiError":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable, machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation safe to show to an end user."}},"required":["code","message"]},"ApiErrorEnvelope":{"type":"object","additionalProperties":false,"properties":{"error":{"$ref":"#/components/schemas/ApiError"},"meta":{"$ref":"#/components/schemas/ApiErrorMeta"}},"required":["error"]},"BatchLookupRequest":{"type":"object","additionalProperties":false,"properties":{"sets":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"minifigs":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}}},"required":[],"anyOf":[{"required":["sets"],"properties":{"sets":{"type":"array","minItems":1}}},{"required":["minifigs"],"properties":{"minifigs":{"type":"array","minItems":1}}}]},"ValueRange":{"type":"object","additionalProperties":false,"properties":{"low":{"type":["number","null"]},"high":{"type":["number","null"]},"calculated_at":{"type":["string","null"],"format":"date-time"}},"required":["low","high","calculated_at"]},"Set":{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":"string"},"title":{"type":"string"},"theme":{"type":["string","null"]},"subtheme":{"type":["string","null"]},"pieces":{"type":["integer","null"]},"minifigs_count":{"type":["integer","null"]},"msrp_usd":{"type":["number","null"]},"release_date":{"type":["string","null"]},"retire_date":{"type":["string","null"]},"status_id":{"type":["integer","null"]},"data_tier":{"type":["string","null"]},"image_url":{"type":["string","null"]},"new_value_usd":{"type":["number","null"]},"used_value_usd":{"type":["number","null"]},"value_range":{"oneOf":[{"$ref":"#/components/schemas/ValueRange"},{"type":"null"}]},"retailers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"retailer":{"type":"string"},"retailer_name":{"type":"string"},"current_price":{"type":["number","null"]},"list_price":{"type":["number","null"]},"discount_percent":{"type":["number","null"]},"in_stock":{"type":"boolean"},"is_first_party":{"type":"boolean"},"product_url":{"type":["string","null"]},"last_checked_at":{"type":["string","null"],"format":"date-time"}},"required":["retailer","retailer_name","current_price","list_price","discount_percent","in_stock","is_first_party","product_url","last_checked_at"]}},"minifigs":{"type":"array","items":{"type":"string"}},"barcodes":{"type":"object","additionalProperties":false,"properties":{"upc":{"type":["string","null"]},"ean":{"type":["string","null"]}},"required":["upc","ean"]},"box":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"width_in":{"type":["number","null"]},"height_in":{"type":["number","null"]},"depth_in":{"type":["number","null"]},"weight_lbs":{"type":["number","null"]}},"required":["width_in","height_in","depth_in","weight_lbs"]},{"type":"null"}]}},"required":["set_number","title","theme","subtheme","pieces","minifigs_count","msrp_usd","release_date","retire_date","status_id","data_tier","image_url","new_value_usd","used_value_usd","value_range","retailers","minifigs","barcodes","box"]},"Minifig":{"type":"object","additionalProperties":false,"properties":{"minifig_number":{"type":"string"},"name":{"type":"string"},"category":{"type":["string","null"]},"year_released":{"type":["integer","null"]},"image_url":{"type":["string","null"]},"current_value_usd":{"type":["number","null"]},"value_range":{"type":"object","additionalProperties":false,"properties":{"low":{"type":["number","null"]},"high":{"type":["number","null"]}},"required":["low","high"]},"set_count":{"type":"integer","minimum":0},"sets":{"type":"array","items":{"type":"string"}}},"required":["minifig_number","name","category","year_released","image_url","current_value_usd","value_range","set_count","sets"]},"RetailerSnapshot":{"type":"object","additionalProperties":false,"properties":{"price":{"type":["number","null"]},"sellerType":{"type":["string","null"],"enum":["retailer","third_party",null]},"changedAt":{"type":["string","null"],"format":"date-time"},"lastChange":{"type":["number","null"]},"flip1pTo3p":{"type":"boolean"},"atLowest":{"type":"boolean"},"lowest":{"type":["number","null"]},"inStock":{"type":["boolean","null"]}},"required":["price","sellerType","changedAt","lastChange","flip1pTo3p","atLowest","lowest","inStock"]},"RetailWatchRow":{"type":"object","additionalProperties":false,"properties":{"setNumber":{"type":"string"},"name":{"type":["string","null"]},"asin":{"type":["string","null"]},"upc":{"type":["string","null"]},"ean":{"type":["string","null"]},"paid":{"type":["number","null"]},"amazon":{"$ref":"#/components/schemas/RetailerSnapshot"},"walmart":{"$ref":"#/components/schemas/RetailerSnapshot"},"amazonExit":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"lowestFba":{"type":"number"},"fbaSellers":{"type":"integer","minimum":0},"buyBox":{"type":["number","null"]},"netFba":{"type":["number","null"]}},"required":["lowestFba","fbaSellers","buyBox","netFba"]},{"type":"null"}]}},"required":["setNumber","name","asin","upc","ean","paid","amazon","walmart","amazonExit"]},"BrickfolioSummary":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"integer"},"name":{"type":"string"},"description":{"type":["string","null"]},"is_default":{"type":"boolean"},"owned_set_count":{"type":["integer","null"]},"owned_item_count":{"type":["integer","null"]},"total_cost_basis_usd":{"type":["number","null"]},"total_current_value_usd":{"type":["number","null"]},"unrealized_gain_loss_usd":{"type":["number","null"]},"created_at":{"type":"string","format":"date-time"}},"required":["id","name","description","is_default","owned_set_count","owned_item_count","total_cost_basis_usd","total_current_value_usd","unrealized_gain_loss_usd","created_at"]},"Holding":{"type":"object","additionalProperties":false,"properties":{"brickfolio_id":{"type":["integer","null"]},"set_number":{"type":"string"},"title":{"type":["string","null"]},"theme":{"type":["string","null"]},"quantity":{"type":"integer","minimum":1},"condition":{"type":["string","null"]},"purchase_price_usd":{"type":["number","null"]},"purchase_date":{"type":["string","null"]},"status":{"type":["string","null"]},"current_value_usd":{"type":["number","null"]},"total_current_value_usd":{"type":["number","null"]},"unrealized_gain_loss_usd":{"type":["number","null"]},"unrealized_gain_loss_pct":{"type":["number","null"]}},"required":["brickfolio_id","set_number","title","theme","quantity","condition","purchase_price_usd","purchase_date","status","current_value_usd","total_current_value_usd","unrealized_gain_loss_usd","unrealized_gain_loss_pct"]},"Sale":{"type":"object","additionalProperties":false,"properties":{"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"set_number":{"type":"string"},"title":{"type":["string","null"]},"theme":{"type":["string","null"]},"platform":{"type":["string","null"]},"sale_date":{"type":["string","null"]},"quantity":{"type":"integer","minimum":1},"condition":{"type":["string","null"]},"gross_proceeds_usd":{"type":"number"},"platform_fees_usd":{"type":"number"},"payment_fees_usd":{"type":"number"},"shipping_cost_usd":{"type":"number"},"shipping_charged_usd":{"type":"number"},"net_proceeds_usd":{"type":"number"},"profit_loss_usd":{"type":["number","null"]},"roi_pct":{"type":["number","null"]},"cost_basis_usd":{"type":["number","null"]},"purchase_date":{"type":["string","null"]}},"required":["id","set_number","title","theme","platform","sale_date","quantity","condition","gross_proceeds_usd","platform_fees_usd","payment_fees_usd","shipping_cost_usd","shipping_charged_usd","net_proceeds_usd","profit_loss_usd","roi_pct","cost_basis_usd","purchase_date"]},"BatchSet":{"type":"object","additionalProperties":false,"properties":{"set_number":{"type":"string"},"title":{"type":"string"},"theme":{"type":["string","null"]},"subtheme":{"type":["string","null"]},"pieces":{"type":["integer","null"]},"minifigs_count":{"type":["integer","null"]},"msrp_usd":{"type":["number","null"]},"release_date":{"type":["string","null"]},"retire_date":{"type":["string","null"]},"status_id":{"type":["integer","null"]},"data_tier":{"type":["string","null"]},"image_url":{"type":["string","null"]},"new_value_usd":{"type":["number","null"]},"used_value_usd":{"type":["number","null"]},"value_range":{"oneOf":[{"$ref":"#/components/schemas/ValueRange"},{"type":"null"}]},"retailers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"retailer":{"type":"string"},"retailer_name":{"type":"string"},"current_price":{"type":["number","null"]},"list_price":{"type":["number","null"]},"discount_percent":{"type":["number","null"]},"in_stock":{"type":"boolean"},"is_first_party":{"type":"boolean"},"product_url":{"type":["string","null"]},"last_checked_at":{"type":["string","null"],"format":"date-time"}},"required":["retailer","retailer_name","current_price","list_price","discount_percent","in_stock","is_first_party","product_url","last_checked_at"]}},"minifigs":{"type":"array","items":{"type":"string"}},"barcodes":{"type":"object","additionalProperties":false,"properties":{"upc":{"type":["string","null"]},"ean":{"type":["string","null"]}},"required":["upc","ean"]},"box":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"width_in":{"type":["number","null"]},"height_in":{"type":["number","null"]},"depth_in":{"type":["number","null"]},"weight_lbs":{"type":["number","null"]}},"required":["width_in","height_in","depth_in","weight_lbs"]},{"type":"null"}]},"found":{"type":"boolean","const":true}},"required":["set_number","title","theme","subtheme","pieces","minifigs_count","msrp_usd","release_date","retire_date","status_id","data_tier","image_url","new_value_usd","used_value_usd","value_range","retailers","minifigs","barcodes","box","found"]},"BatchMinifig":{"type":"object","additionalProperties":false,"properties":{"minifig_number":{"type":"string"},"name":{"type":"string"},"category":{"type":["string","null"]},"year_released":{"type":["integer","null"]},"image_url":{"type":["string","null"]},"current_value_usd":{"type":["number","null"]},"value_range":{"type":"object","additionalProperties":false,"properties":{"low":{"type":["number","null"]},"high":{"type":["number","null"]}},"required":["low","high"]},"set_count":{"type":"integer","minimum":0},"sets":{"type":"array","items":{"type":"string"}},"found":{"type":"boolean","const":true}},"required":["minifig_number","name","category","year_released","image_url","current_value_usd","value_range","set_count","sets","found"]}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"bp_live_…","description":"Reseller API key created in BrickPicker Settings. Send as Authorization: Bearer <key>."}}},"tags":[{"name":"Public API v1"}],"externalDocs":{"description":"BrickPicker Public API documentation","url":"https://brickpicker.com/developers/api"}}