---
title: "Retrieve an event"
method: GET
path: "/channel/v1/events/{eventId}"
tags: ["Event"]
---

# Retrieve an event

`GET /channel/v1/events/{eventId}`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/channel/v1/events/{eventId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/channel/v1/events/:eventId/get.ts> (a function with typed inputs; its response is checked against the schema)

This call returns all details for a specific event.

## Path parameters

- `eventId` string, required

## Response `200`

Event read.

- EventWS: A subscription related integration event
  - `asynchronous` boolean: Whether the event is asynchronous or not
  - `company` CompanyWS, nullable: Company information being used in an event
    - `links` Link[]: Resource links
      - `href` string
      - `rel` string
    - `companyId` string: Company id
    - `name` string: Company name
  - `consumed` boolean: Whether the event has been consumed by vendor or not
  - `creationDate` number: Date when the event was created
  - `error` ErrorWS
    - `code` string, nullable
    - `message` string, nullable
  - `manuallyResolved` boolean: Whether the event has been manually resolved
  - `orderId` number: Order id
  - `product` EventProductWS, nullable: Production information being used in an event
    - `links` Link[]: Resource links
      - `href` string
      - `rel` string
    - `name` string: Product name
    - `productId` number: Product id
  - `subscriptionId` number: Subscription id
  - `successful` boolean: If the event is consumed, then whether it's successful or not
  - `type` 'SUBSCRIPTION_ORDER' | 'SUBSCRIPTION_CHANGE' | 'SUBSCRIPTION_CANCEL' | 'SUBSCRIPTION_NOTICE' | 'USER_ASSIGNMENT' | 'USER_UNASSIGNMENT' | 'USER_UPDATED' | 'ADDON_ORDER' | 'ADDON_CHANGE' | 'ADDON_CANCEL' | 'ADDON_BIND' | 'ADDON_UNBIND'
  - `uuid` string: Unique event identifier

## Other responses

- `404`: Event not found.

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/events/:eventId/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)