---
title: "Bulk EPCIS 2.0 tenant export."
method: GET
path: "/api/exports/tenant/epcis"
tags: ["Exports"]
---

# Bulk EPCIS 2.0 tenant export.

`GET /api/exports/tenant/epcis`

## Request

- Base URL: `https://app.tracepass.eu`
- URL: `https://app.tracepass.eu/api/exports/tenant/epcis`
- Auth: API key in cookie `tp_session`

Returns every **published** passport the workspace owns,
merged into a single EPCIS 2.0 `EPCISDocument` (supply-chain,
service, ownership, and captured events). The EPCIS sibling of
the JSON-LD tenant export at `GET /api/exports/tenant`.

Only published passports are included — draft / suspended /
archived / expired passports are not part of a traceability
feed. The tenant exporting their own data sees the full event
set (authority access level).

**Not API-key reachable.** Auth is dashboard JWT (admin role) —
same privileged-action trust level as the JSON-LD tenant export.
No plan or billing gate: every plan, Free included, whatever the
billing status and after cancelling ("Download EPCIS" in
Settings → Data export). Programmatic access requires a
session cookie from `/api/auth/login`; the per-passport v1
EPCIS routes cover API-key access.

Synchronous response with `Content-Disposition: attachment`.
No pagination.

## Headers

- `Accept` 'application/ld+json' | 'application/json'

## Response `200`

EPCIS 2.0 document covering every published passport.

- EpcisDocument: A GS1 EPCIS 2.0 JSON-LD document. The shape is defined by the GS1 EPCIS 2.0 standard, not by TracePass — only the top-level envelope is sketched here.
  - `@context` unknown
  - `type` 'EPCISDocument' | 'EPCISQueryDocument'
  - `schemaVersion` string
  - `creationDate` string, date-time
  - `epcisBody` object: Carries `eventList` (an array of EPCIS events) for an EPCISDocument, or `queryResults` for an EPCISQueryDocument.

## Other responses

- `401`: Missing or invalid API key.
- `403`: Admin role required.

---

[API](https://skmtc.dev/tracepass/apis/tracepass-api.md) · [All operations](https://skmtc.dev/tracepass/apis/tracepass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracepass/apis/tracepass-api/revisions/60ddeb25638b?raw)