Lego
Lego sets, minifigures, and gear products. Each asset represents a product identity (e.g., "Millennium Falcon") and each configuration represents a specific release (e.g., "UCS Millennium Falcon 75192").
External IDs
| Field | Required | Description | Example |
|---|---|---|---|
| LEGO_SET | No | Official Lego set number | "75192" |
Asset Details
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| id | Yes | string | Internal Tradepost asset ID (UUID) | "e5fe8163-7af8-4521-a437-51fd48b28c5c" |
| theme | No | string | Lego theme/franchise | "Star Wars", "Technic", "City", "Botanical" |
Config Details
Configuration-level details distinguish different releases within the same product identity.
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| id | Yes | string | Internal Tradepost asset configuration ID (UUID) | "4c4d074c-a173-4096-a1b7-320e472cbb2d" |
| name | No | string | Full product name | "Millennium Falcon" |
| image_url | No | string | Primary product image URL | "https://cdn.tradepost.co/media/asset-configurations/.../1000x1000.webp" |
| set_number | No | string | Official Lego set number | "75192" |
| variety | No | string | Product type | "SET", "MINIFIGURE", "GEAR" |
| product_line | No | string | Product line within the theme | "Ultimate Collector Series", "Microfighters" |
| piece_count | No | integer | Total piece count | 7541 |
| minifigure_count | No | integer | Number of minifigures included | 10 |
| year_released | No | integer | Release year | 2017 |
| retired | No | boolean | Whether the set is retired/discontinued | false |
Product Types:
SET: Boxed Lego sets and polybagsMINIFIGURE: Individual minifigures (CMF, exclusives)GEAR: Keychains, watches, display items, promotional products
Item Details
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| key_id | No | string | Internal Tradepost key ID for grouping items (UUID) | "38c9bbe2-1c33-473d-9a69-9568e1c561dc" |
| key_ids | No | string[] | Array of internal Tradepost key IDs for this item | ["38c9bbe2...", "4c4d074c..."] |
| fair_values | No | array | Fair value pricing information | [] |
| condition | Yes | string | Product condition | "UNOPENED" |
| quantity | Yes | integer | Number of units | 1 |
Condition:
UNOPENED: Factory sealed, never openedOPENED: Previously openedDAMAGED: Visible damage to product or packaging
Example
{
"asset_type": "LEGO",
"external_ids": {
"LEGO_SET": "75192"
},
"asset_details": {
"id": "e5fe8163-7af8-4521-a437-51fd48b28c5c",
"theme": "Star Wars"
},
"config_details": {
"id": "4c4d074c-a173-4096-a1b7-320e472cbb2d",
"name": "Millennium Falcon",
"image_url": "https://cdn.tradepost.co/media/asset-configurations/4c4d074c-a173-4096-a1b7-320e472cbb2d/image/1000x1000.webp",
"set_number": "75192",
"variety": "SET",
"product_line": "Ultimate Collector Series",
"piece_count": 7541,
"minifigure_count": 10,
"year_released": 2017,
"retired": false
},
"item_details": {
"key_id": "38c9bbe2-1c33-473d-9a69-9568e1c561dc",
"key_ids": [
"38c9bbe2-1c33-473d-9a69-9568e1c561dc",
"4c4d074c-a173-4096-a1b7-320e472cbb2d"
],
"fair_values": [],
"condition": "UNOPENED",
"quantity": 1
}
}