---
title: "Retrieve available interaction protocols from the interaction originator."
method: GET
path: "/interactions/{interactionId}"
tags: ["Interactions", "Credentials", "Exchanges"]
---

# Retrieve available interaction protocols from the interaction originator.

`GET /interactions/{interactionId}`

Retrieve available interaction protocols from the interaction originator.

## Path parameters

- `interactionId` union, required
  - string
  - integer

## Query parameters

- `iuv` '1', required

## Request body

- union — Object containing the available options for continuing the current interaction.
  - object
    - `inviteRequest` string, required — A URL that is intended to take the initiating user of the current interaction to a website to continue the interaction beyond this API.
    - `vcapi` string — A VC-API exchange URL that will allow the initiating user of the current interaction to continue with a VC-API credential exchange.
    - `otherFutureAPI` string — A URL that is intended to take the initiating user of the current interaction to some other, as yet to be defined, API to continue the interaction and credential exchange.
  - object
    - `inviteRequest` string — A URL that is intended to take the initiating user of the current interaction to a website to continue the interaction beyond this API.
    - `vcapi` string, required — A VC-API exchange URL that will allow the initiating user of the current interaction to continue with a VC-API credential exchange.
    - `otherFutureAPI` string — A URL that is intended to take the initiating user of the current interaction to some other, as yet to be defined, API to continue the interaction and credential exchange.

## Response `200`

The protocols object with the advertised interaction protocol options.

- union — Object containing the available options for continuing the current interaction.
  - object
    - `inviteRequest` string, required — A URL that is intended to take the initiating user of the current interaction to a website to continue the interaction beyond this API.
    - `vcapi` string — A VC-API exchange URL that will allow the initiating user of the current interaction to continue with a VC-API credential exchange.
    - `otherFutureAPI` string — A URL that is intended to take the initiating user of the current interaction to some other, as yet to be defined, API to continue the interaction and credential exchange.
  - object
    - `inviteRequest` string — A URL that is intended to take the initiating user of the current interaction to a website to continue the interaction beyond this API.
    - `vcapi` string, required — A VC-API exchange URL that will allow the initiating user of the current interaction to continue with a VC-API credential exchange.
    - `otherFutureAPI` string — A URL that is intended to take the initiating user of the current interaction to some other, as yet to be defined, API to continue the interaction and credential exchange.

## Other responses

- `400` — Invalid or malformed input
- `401` — Not Authorized
- `500` — Internal Error

## Changes

- **2026-02-17** `47fa1e7a1f9e` — 2 warning, 2 info
  - removed the request property `vcaml`
  - removed the optional property `vcaml` from the response with the `200` status
  - added the new optional request property `vcapi`
  - added the optional property `vcapi` to the response with the `200` status
- **2026-02-10** `9a5377c1edab` — 2 warning, 2 info
  - removed the request property `vcapi`
  - removed the optional property `vcapi` from the response with the `200` status
  - added the new optional request property `vcaml`
  - added the optional property `vcaml` to the response with the `200` status
- **2026-01-28** `9de603962d52` — 2 warning, 2 info
  - removed the request property `vcaml`
  - removed the optional property `vcaml` from the response with the `200` status
  - added the new optional request property `vcapi`
  - added the optional property `vcapi` to the response with the `200` status
- **2025-10-26** `887813709110` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/changes/interactions/:interactionId/get.md)

---

[API](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management.md) · [All operations](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/w3c/verifiable-credential-api-for-lifecycle-management/revisions/3ba233461759/schema)