---
title: "Used by verifier applications to initiate OpenID presentation flow through VCS"
method: POST
path: "/verifier/profiles/{profileID}/{profileVersion}/interactions/initiate-oidc"
tags: ["verifier"]
---

# Used by verifier applications to initiate OpenID presentation flow through VCS

`POST /verifier/profiles/{profileID}/{profileVersion}/interactions/initiate-oidc`

## Request body

- InitiateOIDC4VPData
  - `presentationDefinitionId` string
  - `purpose` string
  - `scopes` string[] — List of custom scopes that defines additional claims requested from Holder to Verifier.
  - `presentationDefinitionFilters` PresentationDefinitionFilters
    - `fields` string[]
  - `dynamicPresentationFilters` PresentationDynamicFilters
    - `type` string — VC type.
    - `context` string[] — List of @contexts of the VC.
  - `customURLScheme` string

## Response `200`

OK

- InitiateOIDC4VPResponse
  - `authorizationRequest` string, required
  - `txID` string, required

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/trustbloc/apis/verifiable-credential-service-vcs.md) · [All operations](https://skmtc.net/trustbloc/apis/verifiable-credential-service-vcs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trustbloc/verifiable-credential-service-vcs/revisions/9e21ad997121/schema)