---
title: "Submit a response to an order requirement"
method: POST
path: "/trading/orders/{orderId}/requirement/data"
tags: ["Trading"]
---

# Submit a response to an order requirement

`POST /trading/orders/{orderId}/requirement/data`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/trading/orders/{orderId}/requirement/data`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/trading/orders/:orderId/requirement/data/post.ts> (a function with typed inputs; its response is checked against the schema)

Submit the user's textual response to an order requirement on an order that is in `AWAITING_INFORMATION` status.

The request body carries `data` — a free-form object conforming to the `requiredData` JSON Schema
returned by the GET endpoint. Any required files are uploaded separately via
`POST /trading/orders/{orderId}/requirement/file`.

Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Editor.

For detailed information about error codes and troubleshooting, please refer to our [API Error Codes documentation](https://developers.fireblocks.com/reference/api-error-codes).

## Path parameters

- `orderId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- SubmitOrderRequirementRequest: Body of POST /trading/orders/{orderId}/requirement/data. Carries the textual response (`data`). Any required files are uploaded separately via POST /trading/orders/{orderId}/requirement/file.
  - `data` object, required: Free-form object that MUST conform to the `requiredData` JSON Schema returned by the GET endpoint. Carries text/select fields.

## Response `202`

Order requirement submission accepted for processing.

## Other responses

- `400`: Bad request: invalid input parameters, malformed request body, or validation failure.
- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Forbidden: insufficient permissions, disabled feature, or restricted access.
- `404`: Not found: the order does not exist.
- `409`: Conflict: the order exists but does not have an active order requirement (e.g., the order is not in `AWAITING_INFORMATION`).
- `429`: Rate limit exceeded: slow down and retry later.
- `5XX`: Internal error while processing the request.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)