---
title: "Export a passport's events as an EPCIS 2.0 document."
method: GET
path: "/api/v1/passports/{id}/epcis"
tags: ["EPCIS"]
---

# Export a passport's events as an EPCIS 2.0 document.

`GET /api/v1/passports/{id}/epcis`

## Request

- Base URL: `https://app.tracepass.eu`
- URL: `https://app.tracepass.eu/api/v1/passports/{id}/epcis`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.tracepass.eu/api/oauth/authorize`, token URL `https://app.tracepass.eu/api/oauth/token`, scopes: `passports:read`)

Returns the passport's supply-chain, service, ownership, and
captured events as a standards-valid EPCIS 2.0 JSON-LD
`EPCISDocument`.

EPCIS export is included on Starter plans and up; a tenant
without it gets `403 epcis_export_not_available`.

A by-serial sibling exists at
`GET /api/v1/passports/by-serial/{serial}/epcis` — identical
response, looked up by your own serial. Counts as one
passport read.

## Path parameters

- `id` string, required

## Response `200`

EPCIS 2.0 document.

## Other responses

- `401`: Missing or invalid API key.
- `403`: EPCIS export not available on this plan.
- `404`: Resource doesn't exist or is in a different workspace.

---

[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)