---
title: "Get RFQ"
method: GET
path: "/communications/rfqs/{rfq_id}"
tags: ["communications"]
---

# Get RFQ

`GET /communications/rfqs/{rfq_id}`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/communications/rfqs/{rfq_id}`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

Endpoint for getting a single RFQ by id

## Path parameters

- `rfq_id` string, required

## Response `200`

RFQ retrieved successfully

- GetRFQResponse
  - `rfq` RFQ, required
    - `id` string, required: UUID of the RFQ. Preserve the exact returned string.
    - `creator_id` string, required: Public communications ID of the RFQ creator (pseudonymous). When obscure_creator_id is enabled, other users receive the shared placeholder "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" (SHA-256 of empty input). The creator sees their normal ID. After successful quote execution, subsequent RFQ responses show the normal public communications ID to all viewers.
    - `market_ticker` string, required: The ticker of the market this RFQ is for
    - `contracts_fp` string, required: Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `target_cost_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `target_cost_excludes_fees` boolean: True when the target cost is principal-only and quote sizes are computed without reserving taker fees (fees are charged on top).
    - `status` 'open' | 'closed', required: Current status of the RFQ (open, closed)
    - `created_ts` string, date-time, required: Timestamp when the RFQ was created
    - `mve_collection_ticker` string: Ticker of the MVE collection this market belongs to
    - `mve_selected_legs` MveSelectedLeg[]: Selected legs for the MVE collection
      - `event_ticker` string: Unique identifier for the selected event
      - `market_ticker` string: Unique identifier for the selected market
      - `side` string: The side of the selected market
      - `yes_settlement_value_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `rest_remainder` boolean: Whether to rest the remainder of the RFQ after execution
    - `cancellation_reason` string: Reason for RFQ cancellation if cancelled
    - `creator_user_id` string: User ID of the RFQ creator (private field)
    - `creator_subaccount` integer: Subaccount number of the RFQ creator (visible when the caller is the RFQ creator)
    - `cancelled_ts` string, date-time: Timestamp when the RFQ was cancelled
    - `updated_ts` string, date-time: Timestamp when the RFQ was last updated
    - `rfq_batch_id` string: Identifier of the RFQ batch this RFQ is a child of. Omitted for an RFQ outside a batch. A child can be quoted like a single RFQ, with the differences described in [Request for Quote](/getting_started/rfqs#rfq-batch-children).

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-10-26** `c3b2035a5d57`: 1 info
  - added the optional property `rfq/rfq_batch_id` to the response with the `200` status
- **2026-09-15** `75098a17c536`: 1 info
  - added the non-success response with the status `400`
- **2026-09-08** `c68a2add4c0a`: 1 info
  - added the optional property `rfq/target_cost_excludes_fees` to the response with the `200` status
- **2026-07-31** `a07481be8bf9`: 3 warning
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `404` status
  - removed the optional property `service` from the response with the `500` status
- **2026-05-18** `7e31fc4590e0`: 1 info
  - added the optional property `rfq/creator_subaccount` to the response with the `200` status

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/communications/rfqs/:rfq_id/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)