Retrieve options level approval requests (BETA)

get

https://broker-api.sandbox.alpaca.markets/v1/accounts/options/approvals

This endpoint retrieves options trading level approval requests. Query parameters can be specified to filter the results. If multiple query parameters are specified, the results will be filtered to include only those that match all of the specified parameters. Each query parameter can only be specified once.

Query Params

account_id

uuid

Only return results for the specified account.

requested_level

integer

enum

Only return requests with the specified requested level. 0=Disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.

Allowed:

approved_level

integer

enum

Only return requests with the specified approved level. 0=Disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.

Allowed:

status

string

enum

Only return requests with the specified approval request status.

Allowed:

page_size

integer

1 to 1000

Defaults to 1000

The maximum number of results to return. The default (and maximum value) is 1000.

page_token

string

Used for pagination, this token retrieves the next page of results. It is obtained from the response of the preceding page when additional pages are available.

Responses

200The request was submitted successfully.

400The request body is invalid.

401Client does not exist, you do not have access to the client, or “client_secret” is incorrect.

403The correspondent entity does not have access to options approvals or the account does not exist.