---
title: "Initiates an exchange of information."
method: POST
path: "/exchanges/{exchange-id}"
tags: ["Exchanges"]
---

# Initiates an exchange of information.

`POST /exchanges/{exchange-id}`

A client can use this endpoint to initiate an exchange of a particular type. The client can include HTTP POST information related to the details of exchange it would like to initiate. If the server understands the request, it returns a Verifiable Presentation Request. A request that the server cannot understand results in an error.

## Parameters

- `./components/parameters/path/ExchangeId.yml` — unresolved $ref

## Request body

- union
  - object — Data necessary to initiate the exchange.
  - NotifyPresentationAvailableRequest
    - `query` object — See https://w3c-ccg.github.io/vp-request-spec/#format
      - `type` string — The type of query the server should reply with.
      - `credentialQuery` object — Details of the client's available presentation

## Response `200`

Proceed with exchange.

- VerifiablePresentationRequestBody
  - `verifiablePresentationRequest` VerifiablePresentationRequest — unresolved $ref

## Other responses

- `400` — Request is malformed.

---

[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.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/revisions/a4517a532fce?raw)