---
title: "Read an envelope's events"
method: GET
path: "/envelopes/{envelope_id}/events"
tags: ["envelope"]
---

# Read an envelope's events

`GET /envelopes/{envelope_id}/events`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/envelopes/{envelope_id}/events`
- Auth: HTTP bearer

Every audit event about one envelope, with the hashes that chain it into the workspace's audit log, as the evidence bundle holds them.

## Path parameters

- `envelope_id` string, required

## Response `200`

The result.

- object
  - `items` object[], required
    - `seq` integer, required
    - `id` string, required
    - `at` string, required
    - `actor` object, required
      - `type` string, required
      - `id` string, required
    - `requester` object, nullable, required
      - `type` string, required
      - `id` string, required
    - `on_behalf_of` string, nullable, required
    - `action` string, required
    - `target` object, nullable, required
      - `type` string, required
      - `id` string, required
    - `payload` object, required
    - `prev_hash` string, required
    - `hash` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

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