Structure sticker page

GET /v1/structure/{code}

https://verify.tanba-ooh.kz/v1/structure/{code}

What a printed sticker opens (/s/{code} on the verify host). The structure, its operator and the approvals in force on it now; no personal data. Send Accept of application/json for JSON.

Authentication

None. This call is public.

Parameters

Name	In	Type	Required	Description	Example
`code`	path	string	yes	Structure code printed on the sticker.	`ALM-0012`

Responses

200 The structure and its approvals in force.

`application/json`

PublicStructure

Name	Type	Required	Description	Example
`structure`	object	yes	The structure the sticker belongs to.
`structure.code`	string	yes	Structure code printed on the sticker.	`"ALM-0012"`
`structure.format`	object	yes	Name of the structure format in each language.
`structure.format.kk`	string	yes	The text in Kazakh.	`"Ситиборд"`
`structure.format.ru`	string	yes	The text in Russian.	`"Ситиборд 3,7x2,7"`
`structure.format.en`	string	yes	The text in English.	`"City board 3.7x2.7"`
`structure.district`	object	yes	Name of the district in each language.
`structure.district.kk`	string	yes	The text in Kazakh.	`"Ситиборд"`
`structure.district.ru`	string	yes	The text in Russian.	`"Ситиборд 3,7x2,7"`
`structure.district.en`	string	yes	The text in English.	`"City board 3.7x2.7"`
`structure.operator`	string	yes	Name of the operating organisation.	`"Alma Outdoor LLP"`
`approvals`	array of object	yes	Approvals in force on the structure now.
`approvals[].number`	string	yes	Approval number.	`"TNB-2026-000123"`
`approvals[].status`	string	yes	State of the approval. active, expiring
`approvals[].valid_from`	string (date)	yes	First day the approval is in force.	`"2026-10-01"`
`approvals[].valid_until`	string (date)	yes	Last day the approval is in force.	`"2026-12-31"`
`approvals[].regulation`	object	yes	The regulation the approval was issued under.

Example

{
  "structure": {
    "code": "ALM-0012",
    "format": {
      "kk": "Ситиборд",
      "ru": "Ситиборд 3,7x2,7",
      "en": "City board 3.7x2.7"
    },
    "district": {
      "kk": "Ситиборд",
      "ru": "Ситиборд 3,7x2,7",
      "en": "City board 3.7x2.7"
    },
    "operator": "Alma Outdoor LLP"
  },
  "approvals": [
    {
      "number": "TNB-2026-000123",
      "status": "active",
      "valid_from": "2026-10-01",
      "valid_until": "2026-12-31",
      "regulation": {}
    }
  ]
}

`text/html`

Errors

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

Status	Meaning
404	Not a known structure code (the same answer as an unknown approval number).
429	Rate limit; see `Retry-After`.

Code samples

curl

curl 'https://verify.tanba-ooh.kz/v1/structure/ALM-0012' \
  -H 'Accept: application/json'

Python

import requests

response = requests.get(
    "https://verify.tanba-ooh.kz/v1/structure/ALM-0012",
    headers={
        "Accept": "application/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/structure/ALM-0012", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	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))
}