sellers-1.0.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://iabtechlab.com/sellers.schema.json",
  "title": "IAB Tech Lab Sellers.json",
  "description": "As part of a broader effort to eliminate the ability to profit from counterfeit inventory in the open digital advertising ecosystem, Sellers.json provides a mechanism to enable buyers to discover who the entities are that are either direct sellers of or intermediaries in the selling of digital advertising.",
  "type": "object",
  "properties": {
    "sellers": {
      "description": "The list of all Seller objects that are represented by the advertising system. All sellers must be included even if they are confidential.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "seller_id": {
            "description": "This is the same ID that appears in an ads.txt file and in the SupplyChain.nodes array sid property. In most cases will also appear in the Publisher.Id property of an OpenRTB request.",
            "type": "string"
          },
          "is_confidential": {
            "description": "Indicates whether the identity of the seller is confidential, where 0 = is not confidential and 1 = is confidential.",
            "type": "number",
            "enum": [0, 1],
            "default": 0
          },
          "seller_type": {
            "description": "An enumeration of the type of account, either PUBLISHER, INTERMEDIARY, or BOTH. A value of 'PUBLISHER' indicates that the inventory sold through this account is on a site, app, or other medium owned by the named entity and the advertising system pays them directly. A value of 'INTERMEDIARY' indicates that the inventory sold through this account is not owned by the named entity or the advertising system does not pay them directly. 'BOTH' indicates that both types of inventory are transacted by this seller. Note that this field should be treated as case insensitive when interpreting the data.",
            "type": "string",
            "enum": ["PUBLISHER", "INTERMEDIARY", "BOTH"]
          },
          "is_passthrough": {
            "description": "A passthrough seller is a facilitator of inventory from the upstream supplier to the consumer of the inventory. The upstream supplier and consumer must establish a business relationship with each other such that the upstream supplier has control of their account within the consumer’s platform. A value of 1 indicates the following: - This seller has an account control relationship with the downstream/consuming advertising system. - If this seller is the last link in a SupplyChain, the buying system has to have established an account control relationship with this seller to transact the seller’s inventory. - If this is not the last link in a SupplyChain than this seller should exist between two entities that have an account control relationship. A value of 0 indicates: - The downstream/consuming advertising system has no account control relationship with this seller.",
            "type": "number",
            "enum": [0, 1],
            "default": 0
          },
          "name": {
            "description": "The name of the company (the legal entity) that is paid for inventory that is transacted under the given seller_id. Can be omitted only when is_confidential is set to 1.",
            "type": "string"
          },
          "domain": {
            "description": "The business domain name of the company (the legal entity) that is paid for inventory that is transacted under the given seller_id. When the seller_type property is set to INTERMEDIARY or BOTH, this should be the root domain name of the seller’s Sellers.json file. Can be omitted when is_confidential is set to 1 or when the seller doesn’t have a web presence.",
            "type": "string"
          },
          "comment": {
            "description": "Any helpful description for this inventory. It is useful for sellers that have multiple seller ids to describe what this seller_id represents.",
            "type": "string"
          },
          "ext": {
            "description": "Placeholder for advertising-system specific extensions to this object.",
            "type": "object",
            "additionalProperties": true
          }
        },
        "if": {
          "properties": {
            "is_confidential": { "const": "0" }
          }
        },
        "then": { "required": ["seller_id", "seller_type", "name"] },
        "else": { "required": ["seller_id", "seller_type"] },
        "additionalProperties": false
      }
    },
    "identifiers": {
      "description": "Array of Identifier objects associated with this advertising system. Examples could be TAG-Ids, Dun & Bradstreet business identifiers, or any custom identifier that a consuming advertising system might need.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The description of the identifier",
            "type": "string",
            "enum": ["TAG-ID", "DUNS"]
          },
          "value": {
            "description": "The value of the identifier",
            "type": "string"
          }
        },
        "required": ["name", "value"],
        "additionalProperties": false
      }
    },
    "contact_email": {
      "description": "An email address to use to contact the Advertising System for questions or inquiries about this file.",
      "type": "string"
    },
    "contact_address": {
      "description": "The business address of the advertising system.",
      "type": "string"
    },
    "version": {
      "description": "The version of this spec, currently the only valid value is 1.0.",
      "type": "string",
      "enum": ["1.0"]
    },
    "ext": {
      "description": "Placeholder for advertising-system specific extensions to this object.",
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": ["sellers", "version"],
  "additionalProperties": false
}