---
title: "POST /v1alpha1/vc/search"
method: POST
path: "/v1alpha1/vc/search"
tags: ["VcService"]
---

# POST /v1alpha1/vc/search

`POST /v1alpha1/vc/search`

Search for Verifiable Credentials based on the specified criteria

## Request body

- SearchRequest — Request to search for VCs based on the specified criteria
  - `id` string — ID is the identifier.
  - `schema` CredentialSchema — CredentialSchema represents the credentialSchema property of a Verifiable Credential. more information can be found [here] [here]: https://www.w3.org/TR/vc-data-model-2.0/#data-schemas
    - `type` string — Type specifies the type of the file
    - `id` string — The URL identifying the schema file
  - `content` string — The credential content representation in JSON-LD format

## Response `200`

OK

- SearchResponse — Returns the VCs that match the search criteria
  - `vcs` EnvelopedCredential[] — The list of VCs that match the search criteria
    - `envelopeType` 'CREDENTIAL_ENVELOPE_TYPE_UNSPECIFIED' | 'CREDENTIAL_ENVELOPE_TYPE_EMBEDDED_PROOF' | 'CREDENTIAL_ENVELOPE_TYPE_JOSE', enum — EnvelopeType specifies the type of the envelope used to store the credential.
    - `value` string — Value is the enveloped credential in the specified format.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/agntcy/apis/identity-node.md) · [All operations](https://skmtc.net/agntcy/apis/identity-node/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agntcy/identity-node/versions/bf6df0a975b1/schema)