List Connected Accounts

Get all Connected accounts

Returns a list of all connected accounts.

/connected_accounts/list

post

Returns a list of all connected accounts.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session_with_customer

Body

user_identifier_keystringOptional

Your user ID for the user by which you want to filter connected accounts.

customer_idsstring · uuid[]Optional

limitintegerOptional

Maximum number of records to return per page.

Default: 11000

page_cursorstring | nullableOptional

Identifies the specific page of results to return, obtained from the previous page's next_page_cursor.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /connected_accounts/list HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer API Key
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "user_identifier_key": "text",
  "custom_metadata_has": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "customer_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "limit": 11000,
  "page_cursor": "text"
}

{
  "connected_accounts": [
    {
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-06-03T21:05:59.500Z",
      "user_identifier": {
        "username": "text",
        "api_url": "text",
        "email": "text",
        "phone": "text",
        "exclusive": true
      },
      "account_type": "text",
      "account_type_display_name": "text",
      "errors": [
        {
          "created_at": "2025-06-03T21:05:59.500Z",
          "message": "text",
          "is_connected_account_error": true,
          "is_bridge_error": true,
          "error_code": "account_disconnected"
        }
      ],
      "warnings": [
        {
          "created_at": "2025-06-03T21:05:59.500Z",
          "message": "text",
          "warning_code": "scheduled_maintenance_window"
        }
      ],
      "custom_metadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "automatically_manage_new_devices": true
    }
  ],
  "pagination": {
    "next_page_cursor": "text",
    "has_next_page": true,
    "next_page_url": "https://example.com"
  },
  "ok": true
}

Request

To filter the list of returned connected accounts by a specific set of custom metadata or a user identifier key, include custom_metadata_has or user_identifier_key in the request body. If you include custom_metadata_has, specify the desired metadata filters as a JSON object containing key:value pairs.

Request Body Parameters

Parameter	Type	Description
user_identifier_key	String Optional	The internal user ID (your own internal ID for a user) by which you want to filter connected accounts.
custom_metadata_has	JSON object Optional	Set of key:value custom metadata pairs by which you want to filter connected accounts. For more information, see Adding Custom Metadata to Connected Accounts.

Sample Request

Python

connected_accounts = seam.connected_accounts.list()

cURL (bash)

# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/connected_accounts/list' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{}'

Javascript

await seam.connectedAccounts.list();

Ruby

seam.connected_accounts.list()

PHP

$connected_accounts = $seam->connected_accounts->list();
echo json_encode($connected_accounts);

Response

Returns a connected_accounts array, in which each returned connected_account contains the following properties:

Property	Description
connected_account_id	ID of the connected account
created_at	Date and time at which the connected account was created
user_identifier	Unique identifier for the connected account, such as an email address or phone number
account_type	Type of manufacturer to which the connected account belongs, such as august, schlage, yale, salto, smartthings, and so on
account_type_display_name	Version of account_type that can be displayed in a user interface
custom_metadata	Set of custom_metadata set on the Connect Webview that connected the account. You can also modify or add to this custom_metadata.
automatically_manage_new_devices	Indicates whether Seam should import all new devices for the connected account to make these devices available for use and management by the Seam API. You initially specify the value for this property when creating the corresponding Connect Webview.

Sample Response

JSON

{
  "connected_accounts": [
    {
      "connected_account_id": "c993818b-bf3c-4836-bef4-9a76d89bf1d3",
      "created_at": "2024-01-05T07:20:07.692Z",
      "user_identifier": {
        "username": "jane"
      },
      "account_type": "visionline",
      "account_type_display_name": "Visionline",
      "errors": [],
      "warnings": [],
      "custom_metadata": {
          "internal_account_id": "user-1"
      },
      "automatically_manage_new_devices": true
    },
	...
  ],
  "ok": true
}