---
title: "Get connection"
method: GET
path: "/v1/connections/{connection_id}"
tags: ["Connections"]
---

# Get connection

`GET /v1/connections/{connection_id}`

## Request

- Base URL: `https://api.markifact.com`
- URL: `https://api.markifact.com/v1/connections/{connection_id}`
- Auth: HTTP bearer

Find connections by Markifact connection ID or your external ID.

## Path parameters

- `connection_id` string, required

## Query parameters

- `lookup_by` 'id' | 'external_id'

## Response `200`

Matching connections returned.

- Connection[]
  - `id` string, nullable, required: Public Markifact connection ID.
  - `type` string, required: Connection type.
  - `display_name` string, nullable
  - `external_id` string, nullable
  - `is_private` boolean, required
  - `created_at` integer, nullable
  - `updated_at` integer, nullable

## Other responses

- `404`: Connection not found.

---

[API](https://skmtc.dev/markifact/apis/markifact-api.md) · [All operations](https://skmtc.dev/markifact/apis/markifact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/markifact/apis/markifact-api/revisions/24033d2ceea4?raw)
