---
title: "Receive token notifications from The Clearing House (TCH)."
method: POST
path: "/tch/notifications"
tags: ["plaid"]
---

# Receive token notifications from The Clearing House (TCH).

`POST /tch/notifications`

This endpoint allows us to receive token notifications from The Clearing House (TCH). The schema is defined by TCH.

## Request body

- TCHNotification — Provides the fields of a notification
  - `messageId` string, required — Unique message identifier (GUID v4 format) of this command, used for tracking purposes. Each request and its response have the same value.
  - `conversationId` string, required — Message identifier assigned for the entire conversation (GUID v4 format). Typically, it is generated by the initiator of the flow. The response has the same value with its request.
  - `tokenRequestorId` string, nullable — Token requestor identifier associated to the domain to which the token belongs.
  - `tokenReferenceId` string, nullable — Unique reference identifier for the token generated.
  - `tokenTimestamp` string, date-time, nullable — The event timestamp of the last state change.

## Response `200`

OK

- TCHNotificationResponse — Provides the fields of a notification response
  - `messageId` string, required — Unique message identifier (GUID v4 format) of this command. It is used for the tracking purpose. Each request and its response have same value.
  - `conversationId` string, required — Message identifier assigned for the entire conversation (GUID v4 format). Typically, it is generated by the initiator of the flow. The response has the same value with its request.
  - `statusCode` string — The five digit status code.
  - `statusMessage` string — Human readable comments about the status.

## Changes

- **2025-07-16** `bb819dcb75b3` — 1 info
  - added the new optional request property `tokenTimestamp`
- **2025-06-12** `b0b8ac37e34d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/tch/notifications/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/bb819dcb75b3/schema)