---
title: "GET /didcomm/connections"
method: GET
path: "/didcomm/connections"
tags: ["DIDComm Connections"]
---

# GET /didcomm/connections

`GET /didcomm/connections`

Find connection record by query

## Query parameters

- `outOfBandId` string
- `alias` string
- `state` 'start' | 'invitation-sent' | 'invitation-received' | 'request-sent' | 'request-received' | 'response-sent' | 'response-received' | 'abandoned' | 'completed' — Connection states as defined in RFC 0023.
- `did` string
- `theirDid` string
- `theirLabel` string

## Headers

- `x-tenant-id` string

## Response `200`

Ok

- DidCommConnectionRecord[]
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time
  - `type` string, required
  - `did` string
  - `theirDid` string
  - `theirLabel` string
  - `state` 'start' | 'invitation-sent' | 'invitation-received' | 'request-sent' | 'request-received' | 'response-sent' | 'response-received' | 'abandoned' | 'completed', required — Connection states as defined in RFC 0023.
  - `role` 'requester' | 'responder', required
  - `alias` string
  - `autoAcceptConnection` boolean
  - `threadId` string
  - `imageUrl` string
  - `mediatorId` string
  - `errorMessage` string
  - `protocol` 'https://didcomm.org/didexchange/1.x' | 'https://didcomm.org/connections/1.x' — Enum values should be sorted based on order of preference. Values will be included in this order when creating out of band invitations.
  - `outOfBandId` string
  - `invitationDid` string
  - `connectionTypes` union[]
    - union
      - 'mediator'
      - string
  - `previousDids` Did[]
  - `previousTheirDids` Did[]

## Changes

- **2026-07-17** `33596742b733` — 2 info
  - the endpoint scheme security `tenants` was removed from the API
  - added the new optional `header` request parameter `x-tenant-id`
- **2024-03-27** `a7641432a6c1` — 1 warning, 1 info
  - deleted the `header` request parameter `x-tenant-id`
  - the endpoint scheme security `tenants` was added to the API

[Change history](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api/changes/didcomm/connections/get.md)

---

[API](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api.md) · [All operations](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openwallet-foundation/credo-rest-api/revisions/33596742b733/schema)