---
title: "Get a connection"
method: GET
path: "/api/v3/destinations/{destination_name}/connections/{id}"
tags: ["Destination connections"]
---

# Get a connection

`GET /api/v3/destinations/{destination_name}/connections/{id}`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/destinations/{destination_name}/connections/{id}`
- 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/destinations/:destination_name/connections/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get detailed info about destination connection

## Path parameters

- `destination_name` string, required
- `id` integer, required

## Response `200`

Get a Connection

- Connection: Connection object
  - `id` integer: Connection ID
  - `uid` string: Connection UID
  - `title` string: Connection title
  - `datasource_name` string: Data source name
  - `status` string: Connection status
  - `created_at` string: Connection creation date
  - `updated_at` string: Connection update date
  - `accounts_number` integer: Total number of accounts available on this connection (excluding accounts disabled on the data source side).
  - `enabled_for_extraction_accounts_number` integer: Number of accounts on this connection that are selected for extraction. Use this to detect connections that have no accounts enabled and prompt the user to select at least one before setting up extractions or loads.
  - `accounts_status` string: Accounts status
  - `update_accounts_last_successed` string: Last successful accounts update date
  - `update_accounts_was_successfull` boolean: Was the last accounts update successful

## 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)