---
title: "Verify PTC CSV"
method: POST
path: "/gw/api/v1/restrictions/verify"
tags: ["preTradeComplianceRestrictions"]
---

# Verify PTC CSV

`POST /gw/api/v1/restrictions/verify`

Validates CSV content without applying changes. Must be called before `/csv/v2/apply` with the same `requestId`.

The master account identity is resolved from the `accountId` claim in the Authorization header JWT. Do not include `masterAcctId` in the request body.

A missing or invalid Authorization header does not return HTTP 401. The request proceeds and fails at validation with `success: false, message: "Master account not specified and not emp track"` unless `isEmpTrack: T` is set in the body.<br><br>**Scope**: `restrictions.write`<br>**Security Policy**: `Signed JWT`

## Headers

- `Authorization` string, required

## Request body

- VerifyRequest — CSV verification request body. Do not include `masterAcctId`; it is extracted from the Authorization JWT `accountId` claim automatically.
  - `userName` string, required — IBKR username.
  - `requestId` integer, required — Unique request identifier.
  - `payload` string, byte, required — Base64-encoded CSV content. Supported operations: `RESTR_ADD`, `RESTR_DELETE`, `RESTR_ASSOC_ADD`, `RESTR_ASSOC_DELETE`.
  - `isEmpTrack` string — Set to `T` for employer-track authorization.

## Response `200`

Always HTTP 200. Inspect the `success` field to determine the outcome. All failure conditions — authentication, authorization, validation, and internal errors — return `success: false`.

- CSVResponse — Response body for all CSV endpoints. Always returned with HTTP 200.
  - `success` boolean, required — Indicates whether the operation succeeded.
  - `requestId` integer — Echoed from the request. Absent only on early apply failures (inactive body token, missing payload) where the `requestId` has not yet been parsed.
  - `message` union — `OK` on success. On failure, either a plain string describing the error or a JSON object for structured bridge validation errors.
    - string
    - object

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)