schema.json

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "alias": {
        "s": "https://schema.org"
    },
    "$defs": {
        "description": {
            "$anchor": "description",
            "s:additionalType": "s:Text",
            "s:sameAs": "s:description",
            "type": "string"
        },
        "email": {
            "$anchor": "email",
            "s:additionalType": "s:Text",
            "s:sameAs": "s:email",
            "type": "string"
        },
        "location": {
            "$anchor": "location",
            "properties": {
                "address": {
                    "properties": {
                        "addressCountry": {
                            "s:additionalType": "s:Text",
                            "s:sameAs": "s:addressCountry",
                            "type": "string"
                        },
                        "addressLocality": {
                            "s:additionalType": "s:Text",
                            "s:sameAs": "s:addressLocality",
                            "type": "string"
                        },
                        "addressRegion": {
                            "s:additionalType": "s:Text",
                            "s:sameAs": "s:addressRegion",
                            "type": "string"
                        },
                        "postalCode": {
                            "s:additionalType": "s:Text",
                            "s:sameAs": "s:postalCode",
                            "type": "string"
                        },
                        "streetAddress": {
                            "s:additionalType": "s:Text",
                            "s:sameAs": "s:streetAddress",
                            "type": "string"
                        }
                    },
                    "s:additionalType": "s:PostalAddress",
                    "s:sameAs": "s:address",
                    "type": "object"
                },
                "geo": {
                    "properties": {
                        "latitude": {
                            "s:additionalType": "s:Number",
                            "s:sameAs": "s:latitude",
                            "type": "number"
                        },
                        "longitude": {
                            "s:additionalType": "s:Number",
                            "s:sameAs": "s:longitude",
                            "type": "number"
                        }
                    },
                    "s:additionalType": "s:GeoCoordinates",
                    "s:sameAs": "s:geo",
                    "type": "object"
                }
            },
            "s:additionalType": "s:Place",
            "s:sameAs": "s:location",
            "type": "object"
        },
        "name": {
            "$anchor": "name",
            "s:additionalType": "s:Text",
            "s:sameAs": "s:name",
            "type": "string"
        },
        "organization": {
            "$anchor": "organization",
            "properties": {
                "description": {
                    "$ref": "#/$defs/description"
                },
                "email": {
                    "$ref": "#/$defs/email"
                },
                "ethicsPolicy": {
                    "s:additionalType": "s:URL",
                    "s:sameAs": "s:ethicsPolicy",
                    "type": "string"
                },
                "location": {
                    "$ref": "#/$defs/location"
                },
                "name": {
                    "$ref": "#/$defs/name"
                },
                "parentOrganization": {
                    "$ref": "#",
                    "s:sameAs": "s:parentOrganization"
                },
                "telephone": {
                    "$ref": "#/$defs/telephone"
                },
                "url": {
                    "$ref": "#/$defs/url"
                }
            },
            "s:additionalType": "s:Organization",
            "s:sameAs": "s:agent",
            "type": "object"
        },
        "person": {
            "$anchor": "person",
            "properties": {
                "affiliation": {
                    "$ref": "#/$defs/organization",
                    "s:sameAs": "s:affiliation"
                },
                "description": {
                    "$ref": "#/$defs/description"
                },
                "email": {
                    "$ref": "#/$defs/email"
                },
                "location": {
                    "$ref": "#/$defs/location"
                },
                "name": {
                    "$ref": "#/$defs/name"
                },
                "telephone": {
                    "$ref": "#/$defs/telephone"
                },
                "url": {
                    "$ref": "#/$defs/url"
                }
            },
            "s:additionalType": "s:Person",
            "s:sameAs": "s:agent",
            "type": "object"
        },
        "telephone": {
            "$anchor": "telephone",
            "s:additionalType": "s:Text",
            "s:sameAs": "s:telephone",
            "type": "string"
        },
        "url": {
            "$anchor": "url",
            "s:additionalType": "s:URL",
            "s:sameAs": "s:url",
            "type": "string"
        }
    },
    "description": "The schema uses https://schema.org/TradeAction as a base type then branches to https://schema.org/BuyAction or https://schema.org/SellAction type depending on whether property instance is https://schema.org/buyer or https://schema.org/seller",
    "items": {
        "properties": {
            "buyer": {
                "$ref": "#/$defs/person",
                "description": "The participant that bought the thing",
                "s:additionalType": "s:SellAction",
                "s:sameAs": "s:buyer"
            },
            "dateCreated": {
                "format": "date",
                "s:additionalType": "s:Date",
                "s:sameAs": "s:dateCreated",
                "type": "string"
            },
            "datePublished": {
                "format": "date",
                "s:additionalType": "s:Date",
                "s:sameAs": "s:datePublished",
                "type": "string"
            },
            "datePurchased": {
                "format": "date",
                "s:additionalType": "s:Date",
                "type": "string"
            },
            "dateUpdated": {
                "format": "date",
                "s:additionalType": "s:Date",
                "type": "string"
            },
            "priceSpecification": {
                "properties": {
                    "deliveryChargeSpecification": {
                        "properties": {
                            "eligibleRegion": {
                                "description": "Must use https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 (country codes)",
                                "examples": [
                                    "gb"
                                ],
                                "items": {
                                    "type": "string"
                                },
                                "s:additionalType": "s:Text",
                                "s:sameAs": "s:eligibleRegion",
                                "type": "array"
                            },
                            "price": {
                                "$ref": "price"
                            }
                        },
                        "s:additionalType": "s:DeliveryChargeSpecification",
                        "type": "object"
                    },
                    "price": {
                        "$id": "price",
                        "s:additionalType": "s:Number",
                        "s:sameAs": "s:price",
                        "type": "number"
                    },
                    "priceCurrency": {
                        "description": "Must use https://en.wikipedia.org/wiki/ISO_4217 (currency code)",
                        "examples": [
                            "gbp"
                        ],
                        "s:additionalType": "s:Text",
                        "s:sameAs": "s:priceCurrency",
                        "type": "string"
                    },
                    "totalPrice": {
                        "description": "price + deliveryChargeSpecification.price",
                        "s:additionalType": "s:Number",
                        "s:sameAs": "s:totalPrice",
                        "type": "number"
                    },
                    "totalPriceUnit": {
                        "description": "totalPrice / unitPriceSpecification.referenceQuantity",
                        "type": "number"
                    },
                    "unitPriceSpecification": {
                        "properties": {
                            "referenceQuantity": {
                                "s:additionalType": "s:QuantitativeValue",
                                "value": "number"
                            }
                        },
                        "s:additionalType": "s:UnitPriceSpecification",
                        "type": "object"
                    },
                    "valueAddedTaxIncluded": {
                        "s:additionalType": "s:Boolean",
                        "s:sameAs": "s:valueAddedTaxIncluded",
                        "type": "boolean"
                    }
                },
                "s:additionalType": "s:PriceSpecification",
                "type": "object"
            },
            "product": {
                "properties": {
                    "brand": {
                        "properties": {
                            "name": {
                                "s:additionalType": "s:Text",
                                "type": "string"
                            },
                            "url": {
                                "$ref": "#/$defs/url"
                            }
                        },
                        "s:additionalType": "s:Brand",
                        "s:sameAs": "s:brand",
                        "type": "object"
                    },
                    "identifier": {
                        "properties": {
                            "gtin": {
                                "s:additionalType": "s:Text",
                                "s:sameAs": "s:gtin",
                                "type": "string"
                            },
                            "productID": {
                                "s:additionalType": "s:Text",
                                "s:sameAs": "s:productID",
                                "type": "string"
                            }
                        },
                        "s:additionalType": "s:PropertyValue",
                        "s:sameAs": "s:identifier",
                        "type": "object"
                    },
                    "manufacturer": {
                        "$ref": "#/$defs/organization",
                        "s:sameAs": "s:manufacturer"
                    },
                    "model": {
                        "s:additionalType": "s:Text",
                        "s:sameAs": "s:model",
                        "type": "string"
                    },
                    "mpn": {
                        "s:additionalType": "s:Text",
                        "s:sameAs": "s:mpn",
                        "type": "string"
                    },
                    "name": {
                        "$ref": "#/$defs/name"
                    },
                    "size": {
                        "s:additionalType": "s:Text",
                        "s:sameAs": "s:size",
                        "type": "string"
                    },
                    "url": {
                        "$ref": "#/$defs/url"
                    }
                },
                "s:additionalType": "s:Product",
                "type": "object"
            },
            "seller": {
                "anyOf": [
                    {
                        "if": {
                            "properties": {
                                "agentType": {
                                    "const": "person"
                                }
                            }
                        },
                        "then": {
                            "properties": {
                                "agent": {
                                    "$ref": "#/$defs/person"
                                }
                            }
                        }
                    },
                    {
                        "if": {
                            "properties": {
                                "agentType": {
                                    "const": "organization"
                                }
                            }
                        },
                        "then": {
                            "properties": {
                                "agent": {
                                    "$ref": "#/$defs/organization"
                                }
                            }
                        }
                    }
                ],
                "description": "The participant that sold the thing",
                "properties": {
                    "agentType": {
                        "enum": [
                            "person",
                            "organization"
                        ],
                        "type": "string"
                    }
                },
                "s:additionalType": "s:BuyAction",
                "s:sameAs": "s:seller",
                "type": "object"
            },
            "service": {
                "s:additionalType": "s:Service",
                "type": "object"
            }
        },
        "title": "Structured data for buying/selling something",
        "type": "object"
    },
    "type": "array"
}