---
title: "Get a contract event by ID"
method: GET
path: "/contracts/{contract_id}/events/{event_id}"
tags: ["Contract - Events"]
---

# Get a contract event by ID

`GET /contracts/{contract_id}/events/{event_id}`

Use this endpoint to retrieve a specific contract event by its ID.

## Path parameters

- `contract_id` integer, required
- `event_id` integer, required

## Headers

- `x-oneflow-api-token` string, required
- `x-oneflow-user-email` string, email

## Response `200`

Returns the requested [contract event](contract-event).

- object — Contract event schema
  - `_links` object — Links to related endpoints.
    - `comments` object
      - `href` string, nullable
    - `contracts` object
      - `href` string, nullable
    - `contract` object
      - `href` string, nullable
    - `create` object
      - `href` string, nullable
    - `data_field` object
      - `href` string, nullable
    - `data_fields` object
      - `href` string, nullable
    - `events` object
      - `href` string, nullable
    - `event` object
      - `href` string, nullable
    - `files` object
      - `href` string, nullable
    - `file` object
      - `href` string, nullable
    - `next` object
      - `href` string, nullable
    - `parties` object
      - `href` string, nullable
    - `party` object
      - `href` string, nullable
    - `previous` object
      - `href` string, nullable
    - `publish` object
      - `href` string, nullable
    - `self` object
      - `href` string, nullable
    - `template_types` object
      - `href` string, nullable
    - `template_type` object
      - `href` string, nullable
    - `template` object
      - `href` string, nullable
    - `templates` object
      - `href` string, nullable
    - `workspaces` object
      - `href` string, nullable
    - `workspace` object
      - `href` string, nullable
    - `playbooks` object
      - `href` string, nullable
  - `actor` object, nullable, required — Participant that triggers the event
    - `id` integer — Participant ID
    - `name` string — Participant name
    - `party` object, nullable — The participant's party
      - `id` integer — Party ID of the participant
      - `name` string — Party name of the participant
  - `created_time` string, datetime, required
  - `data` object, required
    - `subject` union, required — Primary object this event acts on
      - object — Event subject representing contract object
        - `id` integer, required — Contract ID
      - object — Event subject representing participant object
        - `id` integer, required — Participant ID
        - `name` string, required — Participant name
        - `is_draft_approver` boolean — returns true when a participant is a draft approver
        - `is_pending_approver` boolean — returns true when a participant is a pending approver
        - `party` object, nullable, required — Event subject representing a party object
          - `id` integer, required — Party ID
          - `name` string, required — Party name
      - object, nullable — Event subject representing a party object
        - `id` integer, required — Party ID
        - `name` string, required — Party name
      - object — Event subject representing a product object
        - `id` integer, required — Product data ID
        - `name` string, required — Product name
      - object — Event subject representing a data_field object
        - `contract_id` integer, required — Unique ID of the contract
        - `custom_id` string, nullable, required — The unique name that was given to the data field
        - `id` integer, required — Unique ID of the data field
        - `name` string, required — Data field name
      - object — Event subject representing a comment object
        - `contract_id` integer, required — Contract ID
        - `id` integer, required — Comment ID
      - object — Event subject representing AI extraction complete event
        - `id` integer, required — Contract ID
        - `result_id` integer — The ID of the AI import result.
        - `status` 'ready' | 'failed' — The status of the AI import result.
    - `changes` object[], required — For update events, this will contain a list of applied changes.
      - `attribute` string — Attribute name of the subject
      - `from` string, nullable — Value before update
      - `to` string, nullable — Value after update
  - `id` integer, required
  - `type` 'contract:content_update' | 'contract:create' | 'contract:decline' | 'contract:delete' | 'contract:draft_approval_flow:start' | 'contract:draft_approval_flow:complete' | 'contract:draft_approval_flow:reset' | 'contract:lifecycle_settings:update' | 'contract:lifecycle_state:cancel' | 'contract:lifecycle_state:end' | 'contract:lifecycle_state:new_period' | 'contract:lifecycle_state:start' | 'contract:lifecycle_state:terminate' | 'contract:lifecycle_reminder:end' | 'contract:lifecycle_reminder:new' | 'contract:ai_extract:complete' | 'reminder:expire' | 'contract:publish' | 'contract:restore' | 'contract:sign' | 'contract:signature_reset' | 'contract:signing_period_expire' | 'contract:signing_period_revive' | 'contract:workspace_update' | 'comment:create' | 'participant:create' | 'participant:decline' | 'participant:delegate' | 'participant:delete' | 'participant:delivery_failure' | 'participant:draft_approval_flow:approve' | 'participant:draft_approval_flow:reset' | 'participant:first_visit' | 'participant:publish' | 'participant:sign' | 'participant:signature_reset' | 'participant:update' | 'party:create' | 'party:delete' | 'party:update' | 'product:create' | 'product:delete' | 'product:update' | 'data_field:update', required — One of the [contract event types](contract-event#contract-event-type).

## Other responses

- `400` — Invalid format or content of the request.
- `401` — The API token or the user email is invalid.
- `404` — A required entity is missing.

---

[API](https://skmtc.net/oneflow/apis/public-api-for-oneflow.md) · [All operations](https://skmtc.net/oneflow/apis/public-api-for-oneflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneflow/public-api-for-oneflow/versions/0e73a45dec15/schema)