Registered sellers

GET /v1/market/sellers.json

https://verify.tanba-ooh.kz/v1/market/sellers.json

The adtech organisations registered with the platform that may be named as sellers of screens, in the field names of the IAB sellers.json format: seller_id (the seller account that appears in source.schain), name, domain and seller_type. Seller accounts of supply-side platforms and trading desks with a domain that operators authorise today are listed, once per account; every entry has the type INTERMEDIARY. Compare the source.schain of a bid request with this list and with authorised_sellers[].seller_account_id of the screen in the inventory. No credentials. Cached for five minutes; send If-None-Match to revalidate.

Authentication

None. This call is public.

Parameters

Name	In	Type	Required	Description	Example
`If-None-Match`	header	string	no	The `ETag` of a copy you already hold; the answer is then 304 without a body.	`"6f1c0a7d5b2e49c8a3d1e7f0"`

Responses

200 The list of sellers.

`application/json`

SellersJson

Name	Type	Required	Description	Example
`version`	string	yes	Version of the sellers.json format.	`"1.0"`
`sellers`	array of object	yes	Registered sellers, ordered by name.
`sellers[].seller_id`	string	yes	The seller account, as in `source.schain`; the value to compare with `seller_account_id` of the screen's authorised sellers.	`"pub-4711"`
`sellers[].name`	string	yes	Legal name of the organisation that holds the account.	`"SSP One LLP"`
`sellers[].domain`	string	yes	Domain of the organisation.	`"ssp-one.example"`
`sellers[].seller_type`	string	yes	The sellers.json type; always `INTERMEDIARY`. INTERMEDIARY

Example

{
  "version": "1.0",
  "sellers": [
    {
      "seller_id": "pub-4711",
      "name": "SSP One LLP",
      "domain": "ssp-one.example",
      "seller_type": "INTERMEDIARY"
    }
  ]
}

304 The copy you hold is current.

No body.

Errors

Errors are problem documents (application/problem+json) with a stable code.

Status	Meaning
429	Rate limit; see `Retry-After`.

Code samples

curl

curl 'https://verify.tanba-ooh.kz/v1/market/sellers.json'

Python

import requests

response = requests.get(
    "https://verify.tanba-ooh.kz/v1/market/sellers.json",
)
print(response.status_code, response.text)

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://verify.tanba-ooh.kz/v1/market/sellers.json", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}