# Search connected accounts

### Search connected accounts

`POST /api/v1/connected-accounts/search`

Operation ID: `searchConnectedAccounts`

Find connected accounts by display name or handle. Every word in query must appear. Use the id with Get a connected account.

**Request body** (required)

- `query` (string, required): Text to match. Every word must appear in the record.

**200**: Matching connected accounts.

- `connectedAccounts` (object[], required): Up to 20 matches.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload