---
updatedAt: 2026-04-20T21:43:36.000Z
agentTools:
projectIndex: https://docs.dinari.com/llms.txt
---
# List Order Requests
Lists `OrderRequests`.
Optionally `OrderRequests` can be filtered by certain parameters.
# OpenAPI definition
```json
{
"info": {
"description": "**Dinari API for enterprise usage.**\n\nDinari's dShares let businesses offer tokenized access to stocks to their customers through an easy-to-use API.\nIntegrate Dinari's API and offer over a hundred stocks and ETFs to your customers.\n",
"contact": {
"email": "hello@dinari.com"
},
"license": {
"name": "Contact us"
},
"termsOfService": "https://dinari.com/terms",
"title": "Dinari Enterprise API",
"version": "v20261009-833c33c"
},
"servers": [
{
"url": "https://api-enterprise.sbt.dinari.com",
"description": "Production"
},
{
"url": "https://api-enterprise.sandbox.dinari.com",
"description": "Sandbox"
}
],
"components": {
"securitySchemes": {
"ApiKeyId": {
"type": "apiKey",
"in": "header",
"name": "X-API-Key-Id",
"description": "The API key ID provided on the [Partners Dashboard](https://partners.dinari.com)."
},
"ApiSecretKey": {
"type": "apiKey",
"in": "header",
"name": "X-API-Secret-Key",
"description": "API Secret Key that is only shown once at API Key creation."
}
},
"schemas": {
"BaseOpenApiError": {
"type": "object",
"properties": {
"status": {
"type": "integer",
"description": "HTTP status code"
},
"message": {
"type": "string",
"description": "Human-readable message"
},
"error_id": {
"type": "string",
"description": "Reference Id for Dinari support"
},
"error": {
"description": "Additional context and information"
}
},
"required": [
"error_id",
"message",
"status"
],
"additionalProperties": false
},
"BaseOpenApiFieldError": {
"type": "object",
"properties": {
"field_name": {
"type": "string",
"description": "Name of field with error"
},
"field_error": {
"type": "string",
"description": "Description of error"
}
},
"required": [
"field_error",
"field_name"
],
"additionalProperties": false
},
"BaseOpenApiBodyError": {
"type": "object",
"properties": {
"field_errors": {
"type": "array",
"description": "Contains list of field-specific errors",
"items": {
"$ref": "#/components/schemas/BaseOpenApiFieldError"
}
},
"body_error": {
"type": [
"string",
"null"
],
"description": "Description of body-specific error (ex. JSON issues)"
}
},
"required": [
"field_errors"
],
"additionalProperties": false
},
"BaseOpenApi422Error": {
"type": "object",
"properties": {
"status": {
"default": 422,
"enum": [
422
],
"description": "HTTP status code"
},
"message": {
"default": "Unprocessable Entity",
"enum": [
"Unprocessable Entity"
],
"description": "Human-readable message"
},
"error_id": {
"type": "string",
"description": "Reference Id for Dinari support"
},
"error": {
"description": "Additional context and information",
"$ref": "#/components/schemas/BaseOpenApiBodyError"
}
},
"required": [
"error",
"error_id"
],
"additionalProperties": false
},
"BaseOpenApiPaginationMetadata": {
"type": "object",
"properties": {
"previous": {
"type": "string",
"description": "Cursor for previous page"
},
"next": {
"type": "string",
"description": "Cursor for next page"
}
},
"additionalProperties": false
},
"OrderSide1": {
"type": "string",
"enum": [
"BUY",
"SELL"
]
},
"OrderType1": {
"type": "string",
"enum": [
"MARKET",
"LIMIT"
]
},
"OrderTif1": {
"type": "string",
"enum": [
"DAY",
"GTC",
"IOC",
"FOK"
]
},
"DshareProxiedOrderStatus": {
"type": "string",
"enum": [
"QUOTED",
"PENDING",
"PENDING_BRIDGE",
"SUBMITTED",
"ERROR",
"CANCELLED",
"EXPIRED",
"REJECTED"
]
},
"AccountOrderRequest": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "ID of `OrderRequest`. This is the primary identifier for the `/order_requests` routes."
},
"account_id": {
"type": "string",
"format": "uuid",
"description": "ID of `Account` placing the `OrderRequest`."
},
"status": {
"description": "Status of `OrderRequest`. Possible values:\n- `QUOTED`: Order request created with fee quote provided, ready for processing\n- `PENDING`: Order request is being prepared for submission\n- `PENDING_BRIDGE`: Order is waiting for bridge transaction to complete\n- `SUBMITTED`: Order has been successfully submitted to the order book\n- `ERROR`: An error occurred during order processing\n- `CANCELLED`: Order request was cancelled\n- `EXPIRED`: Order request expired due to deadline passing\n- `REJECTED`: Order request was rejected",
"$ref": "#/components/schemas/DshareProxiedOrderStatus"
},
"created_dt": {
"type": "string",
"format": "date-time",
"description": "Datetime at which the `OrderRequest` was created. ISO 8601 timestamp."
},
"order_side": {
"description": "Indicates whether `Order` is a buy or sell.",
"$ref": "#/components/schemas/OrderSide1"
},
"order_type": {
"description": "Type of `Order`.",
"$ref": "#/components/schemas/OrderType1"
},
"order_tif": {
"description": "Indicates how long `Order` is valid for.",
"$ref": "#/components/schemas/OrderTif1"
},
"recipient_account_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "ID of recipient `Account`."
},
"order_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "ID of `Order` created from the `OrderRequest`. This is the primary identifier for the `/orders` routes."
},
"client_order_id": {
"type": [
"string",
"null"
],
"description": "Customer-supplied ID to map this `OrderRequest` to an order in their own systems."
},
"cancel_message": {
"type": [
"string",
"null"
],
"description": "Reason for the order cancellation if the order status is CANCELLED"
},
"reject_message": {
"type": [
"string",
"null"
],
"description": "Reason for the order rejection if the order status is REJECTED"
}
},
"required": [
"account_id",
"created_dt",
"id",
"order_side",
"order_tif",
"order_type",
"status"
],
"description": "\nA request to create an `Order`.\n\nAn `OrderRequest` is created when a user places an order through the Dinari API.\nThe `OrderRequest` is then fulfilled by creating an `Order` on-chain.\n\nThe `OrderRequest` is a record of the user's intent to place an order, while the `Order` is the actual transaction that occurs on the blockchain.\n "
},
"PaginatedAccountOrderRequestResponse": {
"type": "object",
"properties": {
"_sv": {
"default": "PaginatedAccountOrderRequestResponse:v1",
"enum": [
"PaginatedAccountOrderRequestResponse:v1"
],
"description": "Version"
},
"data": {
"type": "array",
"description": "List of AccountOrder",
"items": {
"$ref": "#/components/schemas/AccountOrderRequest"
}
},
"pagination_metadata": {
"description": "Pagination metadata",
"$ref": "#/components/schemas/BaseOpenApiPaginationMetadata"
}
},
"required": [
"data",
"pagination_metadata"
],
"additionalProperties": false
}
},
"responses": {
"UNPROCESSABLE_ENTITY": {
"description": "Unprocessable Entity",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BaseOpenApi422Error"
}
}
}
},
"DEFAULT_ERROR": {
"description": "Default error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BaseOpenApiError"
}
}
}
}
}
},
"paths": {
"/api/v2/accounts/{account_id}/order_requests": {
"get": {
"parameters": [
{
"in": "query",
"name": "order_request_id",
"description": "Order Request ID for the `OrderRequest`",
"schema": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"required": false
},
{
"in": "query",
"name": "order_id",
"description": "Order ID for the `OrderRequest`",
"schema": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"required": false
},
{
"in": "query",
"name": "client_order_id",
"description": "Customer-supplied ID to map this `OrderRequest` to an order in their own systems.",
"schema": {
"type": [
"string",
"null"
]
},
"required": false
},
{
"in": "query",
"name": "page",
"schema": {
"type": "integer",
"default": 1,
"minimum": 1
},
"required": false
},
{
"in": "query",
"name": "page_size",
"schema": {
"type": "integer",
"default": 10,
"minimum": 1,
"maximum": 25
},
"required": false
},
{
"in": "query",
"name": "limit",
"description": "Number of results to return",
"schema": {
"type": "integer",
"default": 20,
"minimum": 20,
"maximum": 100
},
"required": false
},
{
"in": "query",
"name": "order",
"description": "Sort order",
"schema": {
"default": "asc",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"required": false
},
{
"in": "query",
"name": "next",
"description": "Cursor for next page",
"schema": {
"type": [
"string",
"null"
]
},
"required": false
},
{
"in": "query",
"name": "previous",
"description": "Cursor for previous page",
"schema": {
"type": [
"string",
"null"
]
},
"required": false
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"type": "array",
"items": {
"$ref": "#/components/schemas/AccountOrderRequest"
}
},
{
"$ref": "#/components/schemas/PaginatedAccountOrderRequestResponse"
}
]
}
}
}
},
"422": {
"$ref": "#/components/responses/UNPROCESSABLE_ENTITY"
},
"default": {
"$ref": "#/components/responses/DEFAULT_ERROR"
}
},
"tags": [
"Order Requests"
],
"summary": "List Order Requests",
"description": "Lists `OrderRequests`.
Optionally `OrderRequests` can be filtered by certain parameters.",
"operationId": "getListOrderRequests",
"security": [
{
"ApiKeyId": [],
"ApiSecretKey": []
}
]
},
"parameters": [
{
"in": "path",
"name": "account_id",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
]
}
},
"tags": [
{
"name": "Order Requests",
"description": "**`Order Requests` represent requests for Dinari to create `Orders` on behalf of an `Account`.**\n\n`Order Requests` are created when placing **proxied orders** or **managed orders**. See their respective descriptions for more details.\n"
}
],
"openapi": "3.1.0"
}
```