---
title: "Searches for a contract by its ID."
method: POST
path: "/api/Contract/searchById"
tags: ["Contract"]
---

# Searches for a contract by its ID.

`POST /api/Contract/searchById`

## Request body

- SearchContractByIdRequest
  - `contractId` string, required

## Response `200`

A response containing the search result, including the matching contract if found.

- SearchContractByIdResponse
  - `success` boolean, required
  - `errorCode` 0 | 1, required — 0 = Success 1 = ContractNotFound
  - `errorMessage` string
  - `contract` ContractModel
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `tickSize` number, required
    - `tickValue` number, required
    - `activeContract` boolean, required
    - `symbolId` string, required

---

[API](https://skmtc.dev/topstepx/apis/projectx-gateway-api.md) · [All operations](https://skmtc.dev/topstepx/apis/projectx-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/topstepx/projectx-gateway-api/revisions/688252f4f704/schema)