One screen of the market

GET /api/v1/market/inventory/{code}

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

Authentication

API key in the Authorization header, or a console session.

Scope: read:inventory

Parameters

Responses

200 The screen.

application/json

InventoryItem

Example

{
  "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.

No body.

Errors

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

Code samples

curl

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

import requests

response = requests.get(
    "https://app.tanba-ooh.kz/api/v1/market/inventory/ALM-0001",
    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/ALM-0001", 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))
}