---
title: "Add new transaction check(s)"
method: POST
path: "/v2/transaction_check"
tags: ["Transaction Checks"]
---

# Add new transaction check(s)

`POST /v2/transaction_check`

## Request body

- object[] — Transaction monitoring check data to add. Required fields include: check_id, timestamp, status, and type. The related_tx_id or related_tx_ids fields are optional and can be updated later to associate the monitoring check to a transaction.
  - `check_id` string, required — Unique identifier for a monitoring check belonging to a transaction. This is the primary key for a transaction check and should be unique across all transaction checks. Updates to a transaction check should be made using this identifier.
  - `is_test` boolean — Set to true if this is a test transaction check
  - `related_tx_id` string — Unique identifier for the transaction which the check is related to.
  - `related_tx_ids` string[] — Unique identifiers for transactions which the check relates to.
  - `status` 'PENDING' | 'COMPLETED' | 'REQUESTED' | 'ASSIGNED' | 'FAILED', required — Transaction check status. Required when creating new transaction checks, optional for updates.
  - `timestamp` string, date-time, required — When this transaction check was performed in your system, in ISO 8601 format.
  - `type` 'INLINE_MONITORING' | 'DELAYED_MONITORING', required — The type of monitoring check that is being performed. Required when creating new transaction checks, optional for updates.

## Response `201`

Transaction check added successfully

- WriteOperationResponse
  - `message` string, required — Provides additional information about the operation result.
  - `organization_id` string, required — The organization ID for which the operation was performed.
  - `success` boolean, required — Indicates if the write operation was successful.
  - `write_count` integer, required — The number of records written to the database.

## Other responses

- `400` — Invalid transaction check data
- `401` — Unauthorized request
- `409` — Transaction check already exists
- `429` — Rate limit exceeded
- `500` — Server error
- `default` — General error

---

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