Deals API 1.0 JSON Schema Unofficial

Example payloads

One realistic Deal and one BuyerSeat for each build. Each value is the first one the specification's own examples give at that field, where the build's schema accepts it, and else an illustrative value of ours. Every payload is valid against its schema, and breaks no rule that one payload decides.

main · As written

Deal

Open in the type map
{16 members
  • "adtypes":
    [2 items
    • 1
    • 2
    ]
  • "auxdata": 3
  • "bseat":
    [1 item
    • "agency-seat-0007"
    ]
  • "created": "2026-10-15T09:30:00Z"
  • "curation":
    {4 members
    • "cdealid": "curator-q4-0451"
    • "curator": "examplecurator.example"
    • "curfeetype": 4
    • "ext": {}
    }
  • "desc": "Weekday business news readers on desktop and mobile web and in the publisher's app."
  • "dinventory": 1
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "inventory":
    {8 members
    • "appbundles":
      [1 item
      • "com.examplepub.news"
      ]
    • "cat":
      [2 items
      • "52"
      • "379"
      ]
    • "cattax": 7
    • "devicetype":
      [2 items
      • 2
      • 4
      ]
    • "ext": {}
    • "inclinventory":
      [2 items
      • 1
      • 2
      ]
    • "sellerids":
      [1 item
      • "pub-88231"
      ]
    • "sitedomains":
      [1 item
      • "examplepub.example"
      ]
    }
  • "name": "Business news, US and Canada, Q4 2026"
  • "origin": "examplessp.example"
  • "pubcount": 1
  • "seller": "examplepub.example"
  • "sellerstatus": 0
  • "terms":
    {10 members
    • "countries":
      [2 items
      • "USA"
      • "CAN"
      ]
    • "cur": "USD"
    • "dealfloor": 12.5
    • "enddate": "2026-12-31T23:59:59Z"
    • "ext": {}
    • "guar": 1
    • "pricetype": 3
    • "startdate": "2026-11-01T00:00:00Z"
    • "totalcost": 50000
    • "units": 4000000
    }
}

Where the example holds less than every member:

  • /wseat is left out: rule:object-deal:c221f2e9: /bseat: the deal sends both wseat and bseat

Illustrative values, ours and not the specification's:

  • /inventory/cat: Business and Finance and News and Politics, in the IAB Tech Lab Content Taxonomy 3.0 that cattax 7 names.

BuyerSeat

Open in the type map
{4 members
  • "buyerstatus":
    [1 item
    • {3 members
      • "buyerseatid": "agency-seat-1042"
      • "ext": {}
      • "status": 3
      }
    ]
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "version": "1.0"
}

Illustrative values, ours and not the specification's:

  • /buyerstatus/0/status: Ready to serve, as a programmatic guaranteed deal is once it is in a campaign; the deal the examples show is guaranteed at a fixed price.

main · With our proposals

Deal

Open in the type map
{16 members
  • "adtypes":
    [2 items
    • 1
    • 2
    ]
  • "auxdata": 3
  • "bseat":
    [1 item
    • "agency-seat-0007"
    ]
  • "created": "2026-10-15T09:30:00Z"
  • "curation":
    {4 members
    • "cdealid": "curator-q4-0451"
    • "curator": "examplecurator.example"
    • "curfeetype": 4
    • "ext": {}
    }
  • "desc": "Weekday business news readers on desktop and mobile web and in the publisher's app."
  • "dinventory": 1
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "inventory":
    {8 members
    • "appbundles":
      [1 item
      • "com.examplepub.news"
      ]
    • "cat":
      [2 items
      • "52"
      • "379"
      ]
    • "cattax": 7
    • "devicetype":
      [2 items
      • 2
      • 4
      ]
    • "ext": {}
    • "inclinventory":
      [2 items
      • 1
      • 2
      ]
    • "sellerids":
      [1 item
      • "pub-88231"
      ]
    • "sitedomains":
      [1 item
      • "examplepub.example"
      ]
    }
  • "name": "Business news, US and Canada, Q4 2026"
  • "origin": "examplessp.example"
  • "pubcount": 1
  • "seller": "examplepub.example"
  • "sellerstatus": 0
  • "terms":
    {10 members
    • "countries":
      [2 items
      • "USA"
      • "CAN"
      ]
    • "cur": "USD"
    • "dealfloor": 12.5
    • "enddate": "2026-12-31T23:59:59Z"
    • "ext": {}
    • "guar": 1
    • "pricetype": 3
    • "startdate": "2026-11-01T00:00:00Z"
    • "totalcost": 50000
    • "units": 4000000
    }
}

Where the example holds less than every member:

  • /wseat is left out: rule:object-deal:c221f2e9: /bseat: the deal sends both wseat and bseat

Illustrative values, ours and not the specification's:

  • /inventory/cat: Business and Finance and News and Politics, in the IAB Tech Lab Content Taxonomy 3.0 that cattax 7 names.

BuyerSeat

Open in the type map
{4 members
  • "buyerstatus":
    [1 item
    • {3 members
      • "buyerseatid": "agency-seat-1042"
      • "ext": {}
      • "status": 3
      }
    ]
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "version": "1.0"
}

Illustrative values, ours and not the specification's:

  • /buyerstatus/0/status: Ready to serve, as a programmatic guaranteed deal is once it is in a campaign; the deal the examples show is guaranteed at a fixed price.

Tag 1.0-202602 · As written

Deal

Open in the type map
{16 members
  • "adtypes":
    [2 items
    • 1
    • 2
    ]
  • "auxdata": 3
  • "bseat":
    [1 item
    • "agency-seat-0007"
    ]
  • "created": "2026-10-15T09:30:00Z"
  • "curation":
    {4 members
    • "cdealid": "curator-q4-0451"
    • "curator": "examplecurator.example"
    • "curfeetype": 4
    • "ext": {}
    }
  • "desc": "Weekday business news readers on desktop and mobile web and in the publisher's app."
  • "dinventory": 1
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "inventory":
    {8 members
    • "appbundles":
      [1 item
      • "com.examplepub.news"
      ]
    • "cat":
      [2 items
      • "52"
      • "379"
      ]
    • "cattax": 7
    • "devicetype":
      [2 items
      • 2
      • 4
      ]
    • "ext": {}
    • "inclinventory":
      [2 items
      • 1
      • 2
      ]
    • "sellerids":
      [1 item
      • "pub-88231"
      ]
    • "sitedomains":
      [1 item
      • "examplepub.example"
      ]
    }
  • "name": "Business news, US and Canada, Q4 2026"
  • "origin": "examplessp.example"
  • "pubcount": 1
  • "seller": "examplepub.example"
  • "sellerstatus": 0
  • "terms":
    {10 members
    • "countries":
      [2 items
      • "USA"
      • "CAN"
      ]
    • "cur": "USD"
    • "dealfloor": 12.5
    • "enddate": "2026-12-31T23:59:59Z"
    • "ext": {}
    • "guar": 1
    • "pricetype": 3
    • "startdate": "2026-11-01T00:00:00Z"
    • "totalcost": 50000
    • "units": 4000000
    }
}

Where the example holds less than every member:

  • /wseat is left out: rule:object-deal:c221f2e9: /bseat: the deal sends both wseat and bseat

Illustrative values, ours and not the specification's:

  • /inventory/cat: Business and Finance and News and Politics, in the IAB Tech Lab Content Taxonomy 3.0 that cattax 7 names.

BuyerSeat

Open in the type map
{4 members
  • "buyerstatus":
    [1 item
    • {3 members
      • "buyerseatid": "agency-seat-1042"
      • "ext": {}
      • "status": 3
      }
    ]
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "version": "1.0"
}

Illustrative values, ours and not the specification's:

  • /buyerstatus/0/status: Ready to serve, as a programmatic guaranteed deal is once it is in a campaign; the deal the examples show is guaranteed at a fixed price.

Tag 1.0-202602 · With our proposals

Deal

Open in the type map
{16 members
  • "adtypes":
    [2 items
    • 1
    • 2
    ]
  • "auxdata": 3
  • "bseat":
    [1 item
    • "agency-seat-0007"
    ]
  • "created": "2026-10-15T09:30:00Z"
  • "curation":
    {4 members
    • "cdealid": "curator-q4-0451"
    • "curator": "examplecurator.example"
    • "curfeetype": 4
    • "ext": {}
    }
  • "desc": "Weekday business news readers on desktop and mobile web and in the publisher's app."
  • "dinventory": 1
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "inventory":
    {8 members
    • "appbundles":
      [1 item
      • "com.examplepub.news"
      ]
    • "cat":
      [2 items
      • "52"
      • "379"
      ]
    • "cattax": 7
    • "devicetype":
      [2 items
      • 2
      • 4
      ]
    • "ext": {}
    • "inclinventory":
      [2 items
      • 1
      • 2
      ]
    • "sellerids":
      [1 item
      • "pub-88231"
      ]
    • "sitedomains":
      [1 item
      • "examplepub.example"
      ]
    }
  • "name": "Business news, US and Canada, Q4 2026"
  • "origin": "examplessp.example"
  • "pubcount": 1
  • "seller": "examplepub.example"
  • "sellerstatus": 0
  • "terms":
    {10 members
    • "countries":
      [2 items
      • "USA"
      • "CAN"
      ]
    • "cur": "USD"
    • "dealfloor": 12.5
    • "enddate": "2026-12-31T23:59:59Z"
    • "ext": {}
    • "guar": 1
    • "pricetype": 3
    • "startdate": "2026-11-01T00:00:00Z"
    • "totalcost": 50000
    • "units": 4000000
    }
}

Where the example holds less than every member:

  • /wseat is left out: rule:object-deal:c221f2e9: /bseat: the deal sends both wseat and bseat

Illustrative values, ours and not the specification's:

  • /inventory/cat: Business and Finance and News and Politics, in the IAB Tech Lab Content Taxonomy 3.0 that cattax 7 names.

BuyerSeat

Open in the type map
{4 members
  • "buyerstatus":
    [1 item
    • {3 members
      • "buyerseatid": "agency-seat-1042"
      • "ext": {}
      • "status": 3
      }
    ]
  • "ext": {}
  • "id": "ssp-deal-2026-q4-0193"
  • "version": "1.0"
}

Illustrative values, ours and not the specification's:

  • /buyerstatus/0/status: Ready to serve, as a programmatic guaranteed deal is once it is in a campaign; the deal the examples show is guaranteed at a fixed price.