---
title: "Retrieve events for an order"
method: GET
path: "/v1/orders/{id}/events/"
tags: ["Orders"]
---

# Retrieve events for an order

`GET /v1/orders/{id}/events/`

Returns a list of events for the specified order.

## Query parameters

- `include_refresh_orders` boolean

## Response `200`

List of events for the specified order

- object
  - `results` OrderEvent[], required
    - `object` 'order' | 'notification' | 'link', required — The type of object this event relates to
    - `type` 'order_created' | 'login_attempt' | 'suborder_completed' | 'suborder_canceled' | 'suborder_expired' | 'suborder_no_data' | 'suborder_skipped' | 'email_first_sent' | 'email_first_delivery_error' | 'email_first_delivered' | 'email_first_link_opened' | 'email_first_unsubscribed' | 'email_reminder_sent' | 'email_reminder_delivery_error' | 'email_reminder_delivered' | 'email_reminder_link_opened' | 'email_reminder_unsubscribed' | 'sms_first_sent' | 'sms_first_delivery_error' | 'sms_first_delivered' | 'sms_first_link_opened' | 'sms_first_unsubscribed' | 'sms_reminder_sent' | 'sms_reminder_delivery_error' | 'sms_reminder_delivered' | 'sms_reminder_link_opened' | 'sms_reminder_unsubscribed' | 'certification_completed', required — The specific action or state change that occurred
    - `is_refresh` boolean, required — Whether this event belongs to a refresh order
    - `suborder_id` string, nullable — ID of the related suborder (employer, financial institution, etc.)
    - `task_id` string, nullable — ID of the related task
    - `link_id` string, nullable — ID of the related link
    - `order_id` string, required — ID of the related order that produced this event (initial or refresh)
    - `timestamp` string, date-time, required — Timestamp when the event occurred (ISO 8601)

## Other responses

- `400` — HTTP 400 Bad Request
- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/versions/6542a8962887/schema)