---
title: "Get order requirement details for an order"
method: GET
path: "/trading/orders/{orderId}/requirement"
tags: ["Trading"]
---

# Get order requirement details for an order

`GET /trading/orders/{orderId}/requirement`

## Request

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

Fetch order requirement details for an order that is in `AWAITING_INFORMATION` status.

The response includes `requirementId` and `dueBy` metadata, a
`requiredData` JSON Schema (Draft-7) describing the shape of the `data` object expected on
`POST /trading/orders/{orderId}/requirement/data`, and `requiredFiles` descriptors for any files the
provider requires (uploaded via `POST /trading/orders/{orderId}/requirement/file`).

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

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

## Response `200`

Order requirement details

- OrderRequirementDetails: Order requirement details for an order that is awaiting compliance requirements. Returned by GET /trading/orders/{orderId}/requirement.
  - `requirementId` string, required: Unique identifier of the order requirement request as issued by the provider.
  - `dueBy` string, date-time: ISO-8601 timestamp indicating when the order requirement submission is due.
  - `requiredData` string, required: A JSON Schema (Draft-7) in string format describing the shape of the `data` object expected on the corresponding POST /trading/orders/{orderId}/requirement/data request. The schema is the contract: the client builds the `data` payload to match it, and SDKs can validate before sending. The string content is expected to be valid JSON (application/json).
  - `requiredFiles` OrderRequirementFile[], required: Descriptors for files the provider requires as part of the order requirement response. Empty when no files are required. Each entry's `fileKey` is used to correlate uploads on the corresponding upload request.
    - `fileKey` string, required: Stable identifier for this required file. Used to correlate uploads on submission.
    - `description` string, required: Human-readable description of what the file should contain.
    - `allowedFileTypes` OrderRequirementAllowedFileType[], required: File formats the provider accepts for this entry.

## Other responses

- `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)