--- updatedAt: 2026-08-13T02:07:15.000Z agentTools: projectIndex: https://developer.drivewealth.com/apis/llms.txt --- # List Exercise and Do-Not-Exercise request details by account ![beta](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDY0IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtQkVUQSIgeDE9IjAiIHkxPSIwIiB4Mj0iMCIgeTI9IjEiPjxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9InJnYmEoMTQsMTY1LDIzMywwLjIyKSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0icmdiYSgxNCwxNjUsMjMzLDAuMDYpIi8+PC9saW5lYXJHcmFkaWVudD48ZmlsdGVyIGlkPSJnbG93LUJFVEEiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iNjIiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjMGVhNWU5IiBmaWx0ZXI9InVybCgjZ2xvdy1CRVRBKSIgb3BhY2l0eT0iMC41NSIvPjxyZWN0IHg9IjAuNSIgeT0iMC41IiB3aWR0aD0iNjMiIGhlaWdodD0iMTkiIHJ4PSIxMCIgZmlsbD0idXJsKCNncmFkLUJFVEEpIiBzdHJva2U9IiMwZWE1ZTkiIHN0cm9rZS13aWR0aD0iMSIvPjxjaXJjbGUgY3g9IjEwIiBjeT0iMTAiIHI9IjQuNSIgZmlsbD0iIzBlYTVlOSIgZmlsdGVyPSJ1cmwoI2dsb3ctQkVUQSkiIG9wYWNpdHk9IjAuNSIvPjxjaXJjbGUgY3g9IjEwIiBjeT0iMTAiIHI9IjMiIGZpbGw9IiMwZWE1ZTkiLz48dGV4dCB4PSIxOCIgeT0iMTMuNSIgZm9udC1mYW1pbHk9IkhlbHZldGljYSwgQXJpYWwsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTAiIGZvbnQtd2VpZ2h0PSI3MDAiIGxldHRlci1zcGFjaW5nPSIwLjYiIGZpbGw9IiMwYzhlZTAiPkJFVEE8L3RleHQ+PC9zdmc+) Retrieve detailed exercise and do-not-exercise requests for a specific account. Supports optional filters by instrument, request type, and date range. By default, requests from today (UTC) are returned. # OpenAPI definition ```json { "openapi": "3.0.2", "info": { "title": "Core APIs", "version": "2026-10-08", "contact": { "email": "producteng@drivewealth.tech" } }, "servers": [ { "url": "https://bo-api.drivewealth.io/back-office", "description": "Sandbox (No Real World Financial/Trading Impact)" }, { "url": "https://bo-api.drivewealth.net/back-office", "description": "Production" } ], "security": [ { "bearerAuth": [] } ], "x-readme": { "explorer-enabled": false, "headers": [ { "key": "dw-client-app-key", "value": "{{yourAppKey}}" } ] }, "tags": [ { "name": "Position Management" }, { "name": "Options" } ], "paths": { "/accounts/{accountID}/positions/options/requests/details": { "get": { "x-audience": "beta", "tags": [ "Position Management", "Options" ], "summary": "List Exercise and Do-Not-Exercise request details by account", "description": "![beta](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDY0IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtQkVUQSIgeDE9IjAiIHkxPSIwIiB4Mj0iMCIgeTI9IjEiPjxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9InJnYmEoMTQsMTY1LDIzMywwLjIyKSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0icmdiYSgxNCwxNjUsMjMzLDAuMDYpIi8+PC9saW5lYXJHcmFkaWVudD48ZmlsdGVyIGlkPSJnbG93LUJFVEEiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iNjIiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjMGVhNWU5IiBmaWx0ZXI9InVybCgjZ2xvdy1CRVRBKSIgb3BhY2l0eT0iMC41NSIvPjxyZWN0IHg9IjAuNSIgeT0iMC41IiB3aWR0aD0iNjMiIGhlaWdodD0iMTkiIHJ4PSIxMCIgZmlsbD0idXJsKCNncmFkLUJFVEEpIiBzdHJva2U9IiMwZWE1ZTkiIHN0cm9rZS13aWR0aD0iMSIvPjxjaXJjbGUgY3g9IjEwIiBjeT0iMTAiIHI9IjQuNSIgZmlsbD0iIzBlYTVlOSIgZmlsdGVyPSJ1cmwoI2dsb3ctQkVUQSkiIG9wYWNpdHk9IjAuNSIvPjxjaXJjbGUgY3g9IjEwIiBjeT0iMTAiIHI9IjMiIGZpbGw9IiMwZWE1ZTkiLz48dGV4dCB4PSIxOCIgeT0iMTMuNSIgZm9udC1mYW1pbHk9IkhlbHZldGljYSwgQXJpYWwsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTAiIGZvbnQtd2VpZ2h0PSI3MDAiIGxldHRlci1zcGFjaW5nPSIwLjYiIGZpbGw9IiMwYzhlZTAiPkJFVEE8L3RleHQ+PC9zdmc+)\nRetrieve detailed exercise and do-not-exercise requests for a specific account. Supports optional filters by instrument, request type, and date range. By default, requests from today (UTC) are returned.", "parameters": [ { "in": "path", "name": "accountID", "schema": { "$ref": "#/components/schemas/accountID" }, "required": true, "description": "Account ID to list requests for." }, { "in": "query", "name": "instrumentID", "schema": { "type": "string" }, "required": false, "description": "Filter to list all requests for an instrument." }, { "in": "query", "name": "requestType", "schema": { "type": "string", "enum": [ "EXERCISE", "DO_NOT_EXERCISE" ], "x-enumDescriptions": { "EXERCISE": "Exercise the option.", "DO_NOT_EXERCISE": "Do not exercise the option." } }, "required": false, "description": "Filter to list all Exercise or Do-Not-Exercise requests." }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "required": false, "description": "Start date for filtering requests (YYYY-MM-DD in UTC). If not provided, defaults to today's date." }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "required": false, "description": "End date for filtering requests (YYYY-MM-DD in UTC). If not provided, defaults to today's date." }, { "in": "query", "name": "instructionID", "schema": { "type": "string" }, "required": false, "description": "Filter to retrieve a specific exercise or do-not-exercise request by its ID." } ], "responses": { "200": { "description": "Successfully retrieved requests.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OptionsExerciseRequestList" }, "examples": { "ByStatus": { "value": { "data": [ { "accountID": "123e4567-e89b-12d3-a456-00000000013c.1234567890192", "accountNo": "QQQQ000068", "clientID": "", "instructionID": "123e4567-e89b-12d3-a456-00000000013d", "instrumentID": "123e4567-e89b-12d3-a456-00000000013b", "miscFees": [], "osiSymbol": "F280121C00015000", "partnerID": "123e4567-e89b-12d3-a456-00000000013e", "quantity": 1, "requestType": "OPXRC", "requestedAt": "2026-08-07T13:18:52.627005", "settlementDate": "2026-08-10", "status": "INITIATED", "tradeDate": "2026-08-07", "tradingType": "CASH", "updatedAt": "2026-08-07T13:18:52.627005" }, { "accountID": "123e4567-e89b-12d3-a456-00000000013c.1234567890192", "accountNo": "QQQQ000068", "clientID": "", "instructionID": "123e4567-e89b-12d3-a456-00000000013f", "instrumentID": "123e4567-e89b-12d3-a456-000000000140", "miscFees": [], "osiSymbol": "SPY271217P00050000", "partnerID": "123e4567-e89b-12d3-a456-00000000013e", "quantity": 1, "requestType": "OPXRC", "requestedAt": "2026-08-12T14:59:01.518976", "settlementDate": "2026-08-13", "status": "REJECTED", "tradeDate": "2026-08-12", "tradingType": "CASH", "updatedAt": "2026-08-12T14:59:18.549344" }, { "accountID": "123e4567-e89b-12d3-a456-00000000013c.1234567890192", "accountNo": "QQQQ000068", "clientID": "", "instructionID": "123e4567-e89b-12d3-a456-000000000141", "instrumentID": "123e4567-e89b-12d3-a456-000000000142", "miscFees": [], "osiSymbol": "SPY271217C00765000", "partnerID": "123e4567-e89b-12d3-a456-00000000013e", "quantity": 1, "requestType": "OPXRC", "requestedAt": "2026-08-12T13:30:31.760102", "settlementDate": "2026-08-13", "status": "PROCESSED", "tradeDate": "2026-08-12", "tradingType": "CASH", "updatedAt": "2026-08-12T13:30:32.782570" } ], "page": { "hasMore": false } } } } } } } } } } }, "components": { "schemas": { "accountID": { "type": "string", "example": "123e4567-e89b-12d3-a456-000000000004.1234567890125", "description": "The user's unique account identifier." }, "accountNo": { "type": "string", "example": "FFFF000005", "description": "The user's unique account number, that is human readable." }, "tradingType": { "type": "string", "example": "CASH", "description": "The type of trading the account will participate in.", "enum": [ "CASH", "MARGIN" ], "x-enumDescriptions": { "CASH": "A cash account; trades settle using available cash only.", "MARGIN": "A margin account; trades may be placed using borrowed funds." } }, "instrumentID": { "type": "string", "format": "uuid", "example": "123e4567-e89b-12d3-a456-000000000006", "description": "A unique ID created by DriveWealth to identify a specific instrument." }, "partnerID": { "type": "string", "example": "123e4567-e89b-12d3-a456-000000000005", "description": "The partner's unique identifier." }, "OptionsExerciseRequest": { "type": "object", "description": "Represents an options exercise or do-not-exercise request with status.", "properties": { "accountID": { "$ref": "#/components/schemas/accountID" }, "accountNo": { "$ref": "#/components/schemas/accountNo" }, "clientID": { "type": "string", "description": "Client identifier associated with the request." }, "instructionID": { "type": "string", "description": "Unique identifier for the request." }, "instrumentID": { "$ref": "#/components/schemas/instrumentID" }, "miscFees": { "type": "array", "items": { "type": "object", "properties": { "feeType": { "type": "string" }, "feeAmount": { "type": "number" } } } }, "osiSymbol": { "type": "string", "description": "OCC option symbology (e.g., SPY271217C00765000).", "example": "SPY271217C00765000" }, "partnerID": { "$ref": "#/components/schemas/partnerID" }, "quantity": { "type": "number", "description": "Number of contracts." }, "requestType": { "type": "string", "description": "Type of the request.", "example": "OPXRC" }, "requestedAt": { "type": "string", "format": "date-time", "description": "Timestamp when the request was submitted." }, "settlementDate": { "type": "string", "format": "date", "description": "Settlement date for the request." }, "status": { "type": "string", "enum": [ "INITIATED", "PROCESSED", "REJECTED" ], "description": "Current status of the request.", "x-enumDescriptions": { "INITIATED": "The exercise request has been initiated.", "PROCESSED": "The exercise request has been processed.", "REJECTED": "The exercise request was rejected." } }, "tradeDate": { "type": "string", "format": "date", "description": "Trade date of the request." }, "tradingType": { "$ref": "#/components/schemas/tradingType" }, "updatedAt": { "type": "string", "format": "date-time", "description": "Timestamp when the request was last updated." } } }, "OptionsExerciseRequestList": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OptionsExerciseRequest" } }, "page": { "type": "object", "properties": { "hasMore": { "type": "boolean", "example": false, "description": "Indicates whether more pages are available." } } } } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } } } ``` # Sibling pages * [Request Exercise for options position](https://developer.drivewealth.com/apis/reference/post_accounts-accountid-positions-options-exercise.md) * [Request Do-Not-Exercise for options position](https://developer.drivewealth.com/apis/reference/post_accounts-accountid-positions-options-do-not-exercise.md) * [List Exercise and Do-Not-Exercise summary totals by instrument](https://developer.drivewealth.com/apis/reference/get_accounts-accountid-positions-options-requests-summary.md)