List the per-spot export jobs of the organisation

GET /api/v1/delivery/exports

https://app.tanba-ooh.kz/api/v1/delivery/exports

Анықтамалықтың техникалық мәтіні ағылшын тілінде жазылған.

Scope read:delivery. The newest 100 jobs.

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

Authorization тақырыбындағы API кілті немесе консоль сеансы.

Рұқсат: read:delivery

Жауаптар

200 The jobs, newest first.

`application/json`

Атауы	Түрі	Міндетті	Сипаттама	Мысал
`items`	array of DeliveryExport	иә	The export jobs of the organisation.
`items[].id`	string (uuid)	иә	Id of the job.	`"1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f"`
`items[].status`	string	иә	State of the job. queued, running, done, failed
`items[].approval_number`	string \| null	иә	The approval exported; null for a campaign.	`"TNB-2026-000123"`
`items[].campaign_id`	string \| null	иә	The campaign exported; null for one approval.	`null`
`items[].period_from`	string (date)	иә	First day exported.	`"2026-10-01"`
`items[].period_to`	string (date)	иә	Last day exported.	`"2026-10-14"`
`items[].row_count`	integer \| null	иә	Rows written; null until the job is done.	`10000`
`items[].file_sha256`	string \| null	иә	Hex SHA-256 of the file; null until the job is done.	`"7c8d9e0f1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5"`
`items[].error`	string \| null	иә	Why a job failed: `too_many_rows` or `internal`.	`null`
`items[].created_at`	string	иә	When the job was requested, Almaty time.	`"2026-10-14T17:00:00+05:00"`
`items[].finished_at`	string \| null	иә	When the job ended, Almaty time.	`"2026-10-14T17:00:09+05:00"`

Мысал

{
  "items": [
    {
      "id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "status": "done",
      "approval_number": "TNB-2026-000123",
      "campaign_id": null,
      "period_from": "2026-10-01",
      "period_to": "2026-10-14",
      "row_count": 10000,
      "file_sha256": "7c8d9e0f1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5",
      "error": null,
      "created_at": "2026-10-14T17:00:00+05:00",
      "finished_at": "2026-10-14T17:00:09+05:00"
    }
  ]
}

Қателер

Қателер problem құжаты (application/problem+json) түрінде, тұрақты code өрісімен келеді.

Мәртебесі	Мағынасы
401	No valid session or API key (`unauthenticated`, `session_expired`, `invalid_api_key`).
403	The role or the key's scope does not allow this (`forbidden`, `key_scope_denied`, `key_route_denied`).
default	An error as a problem document.

Код мысалдары

curl

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

Python

import requests

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