List the screens of the market

GET /api/v1/market/inventory

https://app.tanba-ooh.kz/api/v1/market/inventory

Технический текст справочника написан на английском.

Scope read:inventory. Every active structure with what an exchange needs to describe it in a bid request: its code, the operator as publisher, the venue type (OpenOOH 1.2 and the mapped 1.1 id), location, district, format, class, screen size, spot and loop length, whether a player has reported in the last 24 hours, the sellers the operator has authorised, and a ready-to-copy OpenRTB 2.6 dooh and device.geo fragment. There are no prices, no availability, no audience and no client names. Free for registered participants and the same for every one of them. With since only structures changed after that instant are returned (a change of their authorised sellers, including a window that began or ended, counts), including decommissioned ones (status decommissioned) so that a copy can drop them; keep as_of of the last answer as the next since. The answer carries an ETag; send it back in If-None-Match to get 304.

Аутентификация

Ключ API в заголовке Authorization или сессия консоли.

Право доступа: read:inventory

Параметры

Имя	Где	Тип	Обязательный	Описание	Пример
`since`	запрос	string (date-time)	нет	Return only structures changed after this instant (RFC 3339).	`2026-10-14T00:00:00+05:00`
`If-None-Match`	заголовок	string	нет	The `ETag` of a copy you already hold; the answer is then 304 without a body.	`"6f1c0a7d5b2e49c8a3d1e7f0"`

Ответы

200 The screens.

`application/json`

InventoryList

Имя	Тип	Обязательный	Описание	Пример
`as_of`	string (date-time)	да	The instant the answer was read; use it as the next `since`.	`"2026-10-14T10:00:00+05:00"`
`items`	array of InventoryItem	да	Screens ordered by code.
`items[].code`	string	да	Structure code; use it as `dooh.id` and `imp.tagid`.	`"ALM-0001"`
`items[].unos_id`	string \| null	да	Identifier in the national outdoor advertising register, when the operator has recorded it.	`"UNOS-4711"`
`items[].status`	string	да	`decommissioned` appears only in answers with `since`. active, decommissioned
`items[].operator`	object	да	The operator that runs the screen, the publisher in a bid request.
`items[].operator.id`	string (uuid)	да	Id of the operator organisation.	`"0b6f9d0e-6c1e-4a6a-9d55-0f8a6a6f3c11"`
`items[].operator.name`	string	да	Legal name of the operator.	`"Almaty Outdoor LLP"`
`items[].operator.domain`	string \| null	да	Domain of the operator, when recorded.	`"almaty-outdoor.example"`
`items[].venue_type`	object \| null	да	Venue type; null when neither the structure nor its format has one.
`items[].venue_type.v12`	integer	да	Id in the OpenOOH venue taxonomy 1.2.	`304`
`items[].venue_type.v11`	integer \| null	да	Id of the official mapping to OpenOOH 1.1; send this one with `venuetypetax` 5.	`301`
`items[].venue_type.code`	string	да	String code of the type in the 1.2 taxonomy.	`"outdoor.spectacular"`
`items[].lat`	number	да	Latitude in degrees.	`43.238`
`items[].lng`	number	да	Longitude in degrees.	`76.945`
`items[].district`	string	да	District code from the reference list.	`"medeu"`
`items[].format`	string	да	Format code from the reference list.	`"cityboard"`
`items[].class`	string	да	Class of the screen. A, B, C
`items[].outdoor`	boolean	да	True for outdoor formats.	`true`
`items[].screen`	object	да	Size of the screen in pixels.
`items[].screen.w`	integer \| null	да	Width in pixels; null when unknown.	`1920`
`items[].screen.h`	integer \| null	да	Height in pixels; null when unknown.	`1080`
`items[].slot_seconds`	integer \| null	да	Length of one spot in seconds.	`10`
`items[].loop_seconds`	integer \| null	да	Length of the loop in seconds.	`120`
`items[].compliance`	object	да	What the platform knows about the screen's player.
`items[].compliance.connected`	boolean	да	True when a player of the screen reported in the last 24 hours.	`true`
`items[].authorised_sellers`	array of object	да	Sellers whose declaration is valid today, from the structure's own list and from the operator's list for all of its structures.
`items[].authorised_sellers[].seller_id`	string (uuid)	да	Id of the seller organisation. The account to match with `sellers.json` is `seller_account_id`.	`"5d3f3e0a-2a53-4b3c-8d0a-6f63b4d9a111"`
`items[].authorised_sellers[].seller_account_id`	string	да	The seller's account on its exchange, the value that appears in `source.schain`.	`"pub-4711"`
`items[].authorised_sellers[].valid_from`	string (date)	да	First day of the authorisation.	`"2026-10-01"`
`items[].authorised_sellers[].valid_until`	string \| null (date)	да	Last day of the authorisation; null without an end.	`"2026-12-31"`
`items[].authorised_sellers[].scope`	string	да	`structure` for a declaration on this screen, `operator` for one on all screens of the operator. structure, operator
`items[].ortb`	object	да	Fragments to copy into an OpenRTB 2.6 bid request.
`items[].ortb.dooh`	object	да	The `dooh` object.
`items[].ortb.dooh.id`	string	да	Structure code.	`"ALM-0001"`
`items[].ortb.dooh.publisher`	object	да	The operator.
`items[].ortb.dooh.publisher.id`	string	да	Id of the operator organisation.	`"0b6f9d0e-6c1e-4a6a-9d55-0f8a6a6f3c11"`
`items[].ortb.dooh.publisher.name`	string	да	Legal name of the operator.	`"Almaty Outdoor LLP"`
`items[].ortb.dooh.publisher.domain`	string		Domain of the operator; absent when not recorded.	`"almaty-outdoor.example"`
`items[].ortb.dooh.domain`	string		Domain of the operator; absent when not recorded.	`"almaty-outdoor.example"`
`items[].ortb.dooh.venuetype`	array of string		OpenOOH 1.1 id of the venue type as a string; absent when the screen has none.	`["301"]`
`items[].ortb.dooh.venuetypetax`	integer		Venue taxonomy list value: 5 is OpenOOH 1.1. Absent when `venuetype` is.	`5`
`items[].ortb.dooh.keywords`	string	да	Format code and `outdoor` or `indoor`, comma separated.	`"cityboard,outdoor"`
`items[].ortb.device`	object	да	The `device` object.
`items[].ortb.device.geo`	object	да	The location of the screen.
`items[].ortb.device.geo.lat`	number	да	Latitude in degrees.	`43.238`
`items[].ortb.device.geo.lon`	number	да	Longitude in degrees.	`76.945`
`items[].ortb.device.geo.type`	integer	да	Source of the location; 1 is a surveyed position.	`1`
`items[].ortb.device.geo.country`	string	да	ISO 3166-1 alpha-3 country code.	`"KAZ"`
`items[].ortb.device.ext`	object		Extension with the OpenOOH 1.2 venue type id; absent when the screen has no venue type.
`items[].ortb.device.ext.dooh`	object		The `dooh` extension.
`items[].ortb.device.ext.dooh.venuetypeid`	string		Id in the OpenOOH 1.2 taxonomy as a string.	`"304"`
`items[].updated_at`	string (date-time)	да	When the screen or its sellers last changed.	`"2026-10-14T09:30:00+05:00"`

Пример

{
  "as_of": "2026-10-14T10:00:00+05:00",
  "items": [
    {
      "code": "ALM-0001",
      "unos_id": "UNOS-4711",
      "status": "active",
      "operator": {
        "id": "0b6f9d0e-6c1e-4a6a-9d55-0f8a6a6f3c11",
        "name": "Almaty Outdoor LLP",
        "domain": "almaty-outdoor.example"
      },
      "venue_type": {
        "v12": 304,
        "v11": 301,
        "code": "outdoor.spectacular"
      },
      "lat": 43.238,
      "lng": 76.945,
      "district": "medeu",
      "format": "cityboard",
      "class": "B",
      "outdoor": true,
      "screen": {
        "w": 1920,
        "h": 1080
      },
      "slot_seconds": 10,
      "loop_seconds": 120,
      "compliance": {
        "connected": true
      },
      "authorised_sellers": [
        {
          "seller_id": "5d3f3e0a-2a53-4b3c-8d0a-6f63b4d9a111",
          "seller_account_id": "pub-4711",
          "valid_from": "2026-10-01",
          "valid_until": "2026-12-31",
          "scope": "structure"
        }
      ],
      "ortb": {
        "dooh": {
          "id": "ALM-0001",
          "publisher": {
            "id": "0b6f9d0e-6c1e-4a6a-9d55-0f8a6a6f3c11",
            "name": "Almaty Outdoor LLP",
            "domain": "almaty-outdoor.example"
          },
          "domain": "almaty-outdoor.example",
          "venuetype": [
            "301"
          ],
          "venuetypetax": 5,
          "keywords": "cityboard,outdoor"
        },
        "device": {
          "geo": {
            "lat": 43.238,
            "lon": 76.945,
            "type": 1,
            "country": "KAZ"
          },
          "ext": {
            "dooh": {
              "venuetypeid": "304"
            }
          }
        }
      },
      "updated_at": "2026-10-14T09:30:00+05:00"
    }
  ]
}

304 The copy you hold is current.

Без тела.

Ошибки

Ошибки приходят документом problem (application/problem+json) со стабильным полем code.

Статус	Значение
401	Нет действительной сессии или ключа API (`unauthenticated`, `session_expired`, `invalid_api_key`).
403	Роль или право ключа этого не допускает (`forbidden`, `key_scope_denied`, `key_route_denied`).
422	Ошибки полей (`validation_failed`).
default	Ошибка в виде документа problem.

Примеры кода

curl

curl 'https://app.tanba-ooh.kz/api/v1/market/inventory' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Python

import requests

response = requests.get(
    "https://app.tanba-ooh.kz/api/v1/market/inventory",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
    },
)
print(response.status_code, response.text)

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://app.tanba-ooh.kz/api/v1/market/inventory", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	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))
}