DevelopersFeed Reference
This table in this section explains available feed structure.
Overview of feed structure
barnebys
Root node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| @version | xs:decimal | optional | Current version set to 2.0 | |
| items | items | 1..unbounded | This entity represents the auction node |
items
Items node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| @id | xs:string | required | Unique ID for the items or auction | |
| item | item | 1..unbounded | This entity represents the lot node |
item
Object node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| @id | xs:string | optional | Unique ID for each item | |
| title | xs:string | 1..1 | Title of the object | |
| description | xs:string | 1..1 | Description of the object | |
| url | xs:anyURI | 1..1 | Image URL of the object | |
| image | xs:anyURI | 1..1 | URL of the object | |
| category | xs:string | 0..1 | Category of the object | |
| availability | enum | 0..1 | The availability of the object, one of 'withdrawn' or 'sold' | |
| price | price | 1..1 | Price Node | |
| auction | auction | 0..1 | Auction Node | |
| lot | lot | 0..1 | Lot details Node | |
| location | location | 0..1 | Location Node |
price
Price node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| amount | xs:decimal | 0..1 | Price price/hammer estimate of the object | |
| estimate | xs:decimal | 0..1 | Price estimate of the object | |
| bid | xs:decimal | 0..1 | Current bid of the object | |
| currency | currency | 3 | 1..1 | Currency of the price/estimate using ISO 4217 |
auction
Auction node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| start | xs:dateTime | 1..1 | Start date for the auction using ISO 8601 | |
| end | xs:dateTime | 1..1 | End date for the auction ISO 8601 |
lot
Lot details node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| artist | xs:string | 1..1 | The artist of the lot |
location
Location node
| Name | Type | Length | Cardinality | Description |
|---|---|---|---|---|
| country | country | 2 | 1..1 | Two-letter country code ISO 3166 |
| city | city | 3 | 0..1 | Three-letter city code LOCODE |
| state | xs:string | 0..1 | A subdivision name from ISO-3166-2 standard. ISO 3166-2 |