---
title: "List accounts for connection"
method: GET
path: "/api/v3/connections/{connection_id}/accounts"
tags: ["Accounts"]
---

# List accounts for connection

`GET /api/v3/connections/{connection_id}/accounts`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/connections/{connection_id}/accounts`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `dts_session_id`
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/connections/:connection_id/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

List accounts for connection.

When you configure a recipe through the v3.1 API, take the account `id` values from [List connection accounts (v3.1)](/api/accounts#list-connection-accounts-v3-1), not from this operation: for some agencies this operation returns different keys, and `PUT /api/v3.1/automated-recipes/{recipe_id}/` rejects them with `account_unavailable`.

## Path parameters

- `connection_id` integer, required

## Response `200`

Get a list of Accounts

- PaginatedAccountList[]
  - `count` integer: Number of accounts
  - `next` string: URL to the next page
  - `previous` string: URL to the previous page
  - `results` Account[]
    - `id` integer: Account ID
    - `account_id` string: Remote account ID
    - `title` string: Account title
    - `currency` string: Account currency
    - `connection_id` integer: Connection ID
    - `datasource_name` string: Data source name
    - `created_at` string: Account creation date
    - `updated_at` string: Account update date
    - `is_active` boolean: Is the account active
    - `enabled_for_embedded_extraction` boolean: Is the account enabled for embedded extraction
    - `item` object: Data source-specific account item information

## Other responses

- `400`: Bad Request
- `401`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)