---
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[]

---

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