One money report section as CSV

GET /api/v1/exports/billing-reports/{name}

https://app.tanba-ooh.kz/api/v1/exports/billing-reports/{name}

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

Scope read:billing. Sections are months, issuers, payers, kinds, districts, overdue, ageing and cash-calendar.

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

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

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

Параметры

Имя	Где	Тип	Обязательный	Описание	Пример
`name`	путь	string	да	Section of the money report to download. months, issuers, payers, kinds, districts, overdue, ageing, cash-calendar	`months`
`from`	запрос	string	нет	First month, `YYYY-MM`.	`2025-11`
`to`	запрос	string	нет	Last month, `YYYY-MM`.	`2026-10`
`sep`	запрос	string	нет	Column separator; `semicolon` for spreadsheets set to a comma decimal mark. comma, semicolon	`comma`

Ответы

200 CSV в UTF-8 с меткой порядка байтов и строкой заголовков.

`text/csv`

Пример

string

Ошибки

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

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

Примеры кода

curl

curl 'https://app.tanba-ooh.kz/api/v1/exports/billing-reports/months' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Python

import requests

response = requests.get(
    "https://app.tanba-ooh.kz/api/v1/exports/billing-reports/months",
    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/exports/billing-reports/months", 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))
}