---
title: "Poll an EPCIS capture job."
method: GET
path: "/api/v1/epcis/capture/{id}"
tags: ["EPCIS"]
---

# Poll an EPCIS capture job.

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

## Request

- Base URL: `https://app.tracepass.eu`
- URL: `https://app.tracepass.eu/api/v1/epcis/capture/{id}`
- 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`)

The read side of the EPCIS 2.0 async capture model. Returns
the job's status, how many events were captured, and any
per-event errors. Counts as one read.

## Path parameters

- `id` string, required

## Response `200`

Capture job status.

- EpcisCaptureJob: An EPCIS capture-job record, returned by the poll endpoint.
  - `captureJobId` string
  - `status` 'running' | 'success' | 'failed'
  - `eventCount` integer
  - `capturedCount` integer
  - `errors` object[]
    - `index` integer
    - `message` string
  - `createdAt` string, date-time
  - `finishedAt` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `403`: EPCIS capture add-on not enabled.
- `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)