---
title: Масов JSON-LD експорт за тенант
description: Пълен експорт на workspace като един JSON-LD документ — всеки продукт, паспорт и template reference. Само dashboard JWT (admin role); не през API key.
canonical: "https://www.tracepass.eu/bg/docs/tenant-export"
locale: bg
source: "https://www.tracepass.eu/bg/docs/tenant-export"
---

# Масов JSON-LD експорт за тенант

> Пълен експорт на workspace като един JSON-LD документ — всеки продукт, паспорт и template reference. Само dashboard JWT (admin role); не през API key.

```http
GET /api/exports/tenant
```

Връща всеки продукт, всеки паспорт (независимо от статуса) и всеки referenced template на категория, които работното пространство притежава, като един JSON-LD документ. Формата отразява per-passport JSON-LD излъчване на публичния преглед на паспорта, обвит в tenant envelope с метаданни за изпълнението на експорта.

**Не е достъпен с API ключ.** Auth е dashboard JWT (admin роля) + paying-customer gate — същото ниво на доверие като изтриването на компанията. Прагматичният flow е: отворете Settings → Data export в таблото и кликнете „Export tenant“. Програмен достъп изисква сесиен cookie, издаден от `/api/auth/login`.

Синхронен отговор с `Content-Disposition: attachment; filename="tracepass-tenant-export-<companyId>-<YYYY-MM-DD>.jsonld"`. Включва URL-и на доказателствени документи, но не и самите байтове на документите; изтеглете ги отделно при нужда от офлайн копия. Без пагинация — всичко или нищо.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Cookie` | header | string | yes | Сесиен cookie на таблото (`tp_session=...`), издаден от `/api/auth/login`. Браузърите го прикачват автоматично, когато експортът е иницииран от таблото. |
| `Accept` | header | string | no | `application/ld+json` (по подразбиране) или `application/json`. Еквивалентни на ниво байтове — променя се само Content-Type на отговора. |

## Examples

```bash
# In practice: open Settings -> Data export in the dashboard.
# For curl, capture the session cookie after a login first:
curl -sS -L \
  --cookie "tp_session=$TRACEPASS_SESSION_COOKIE" \
  -H "Accept: application/ld+json" \
  -o tenant-export.jsonld \
  https://app.tracepass.eu/api/exports/tenant
```

```typescript
import { createWriteStream } from "node:fs";
import { Readable } from "node:stream";
import { finished } from "node:stream/promises";

// session cookie captured from a prior /api/auth/login call
const cookie = process.env.TRACEPASS_SESSION_COOKIE!;

const res = await fetch("https://app.tracepass.eu/api/exports/tenant", {
  headers: {
    Cookie: `tp_session=${cookie}`,
    Accept: "application/ld+json",
  },
});
if (!res.ok || !res.body) throw new Error(`Export failed: ${res.status}`);

const dest = createWriteStream("tenant-export.jsonld");
await finished(Readable.fromWeb(res.body).pipe(dest));
```

```python
import os, requests

cookie = os.environ["TRACEPASS_SESSION_COOKIE"]
with requests.get(
    "https://app.tracepass.eu/api/exports/tenant",
    cookies={"tp_session": cookie},
    headers={"Accept": "application/ld+json"},
    stream=True,
) as res:
    res.raise_for_status()
    with open("tenant-export.jsonld", "wb") as fh:
        for chunk in res.iter_content(chunk_size=1024 * 64):
            fh.write(chunk)
```

## Responses

### 200 — OK

```json
{
  "@context": "https://app.tracepass.eu/schemas/tenant-export-v1.jsonld",
  "@type": "TenantExport",
  "exportedAt": "2026-05-09T12:00:00.000Z",
  "company": { "_id": "...", "name": "Acme Batteries Ltd", "country": "DE" },
  "counts": { "products": 12, "passports": 4327, "templates": 3 },
  "products": [ { "...": "...one entry per product..." } ],
  "passports": [ { "...": "...one entry per passport, with full fieldValues + parties..." } ],
  "templates": [ { "id": "...", "category": "batteries", "version": "v3" } ]
}
```

### 401 — Не сте влезли

```json
{ "error": "Authentication required" }
```

### 402 — Изисква се абонамент

```json
{ "error": "Active paid subscription required" }
```

### 403 — Забранено

```json
{ "error": "admin role required" }
```

## Related

- [Създаване на паспорт](https://www.tracepass.eu/bg/docs/create-passport.md)