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

# Retrieve available interaction protocols from the interaction originator.

`GET /interaction/{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.
    - `vcaml` 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.
    - `vcaml` 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.

## 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.
    - `vcaml` 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.
    - `vcaml` 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.

## Other responses

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

## Changes

- **2025-09-23** `a52f8ca5b671` — 1 breaking, 1 info
  - the `query` request parameter `iuv` was restricted to a list of enum values
  - added the new enum value `1` to the `query` request parameter `iuv`
- **2025-09-23** `44d0f8ffb8c6` — 6 breaking, 2 warning, 2 info
  - removed `#/components/schemas/inviteRequest, #/components/schemas/vcalm, #/components/schemas/otherFutureAPI` from the request body `anyOf` list
  - the `inviteRequest` request property type changed from no type to `string`
  - the `vcaml` request property type changed from no type to `string`
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - …6 more
- **2025-09-23** `474599254bb9` — 6 breaking, 5 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - removed the enum value `1` from the `query` request parameter `iuv`
  - the `inviteRequest` request property type changed from `string` to no type
  - the `vcaml` request property type changed from `string` to no type
  - …7 more

[Change history](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/changes/interaction/: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/a52f8ca5b671/schema)