---
title: "Search Dynamic Accounts"
method: GET
path: "/iserver/account/search/{searchPattern}"
tags: ["tradingAccounts"]
---

# Search Dynamic Accounts

`GET /iserver/account/search/{searchPattern}`

Returns a list of accounts matching a query pattern set in the request. Broker accounts configured with the DYNACCT property will not receive account information at login. Instead, they must dynamically query then set their account number. Customers without the DYNACCT property will receive a 503 error.

## Path parameters

- `searchPattern` string, required

## Response `200`

Returns all accounts that match the searchPattern string.

- DynAccountSearchResponse
  - `matchedAccounts` DynAccountSearchResponseMatchedAccountsItems[] — Contains a series of objects that pertain to the account information requested.
    - `accountId` string — Returns a matching account ID that corresponds to the matching value.
    - `alias` string — Returns the corresponding alias or alternative name for the specific account ID. May be a duplicate of the accountId value in most cases.
    - `allocationId` string — Returns the allocation identifier used internally for the account.
  - `pattern` string — Displays the searchPattern used for the request.

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)