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

# POST /v1alpha1/vc/verify

`POST /v1alpha1/vc/verify`

Verify an existing Verifiable Credential

## Request body

- VerifyRequest — Request to verify an existing Verifiable Credential
  - `vc` EnvelopedCredential — EnvelopedCredential represents a Credential enveloped in a specific format.
    - `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.

## Response `200`

OK

- VerificationResult — The result returned from the verification process defined [here] [here]: https://www.w3.org/TR/vc-data-model-2.0/#verification
  - `status` boolean — A boolean status
  - `document` VerifiableCredential — DataModel represents the W3C Verifiable Credential Data Model defined [here] [here]: https://www.w3.org/TR/vc-data-model/
    - `context` string[] — https://www.w3.org/TR/vc-data-model/#contexts
    - `type` string[] — https://www.w3.org/TR/vc-data-model/#dfn-type
    - `issuer` string — https://www.w3.org/TR/vc-data-model/#issuer
    - `content` object — https://www.w3.org/TR/vc-data-model/#credential-subject
    - `id` string — https://www.w3.org/TR/vc-data-model/#identifiers
    - `issuanceDate` string — https://www.w3.org/TR/vc-data-model/#issuance-date
    - `expirationDate` string — https://www.w3.org/TR/vc-data-model/#expiration
    - `credentialSchema` CredentialSchema[] — 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
    - `credentialStatus` CredentialStatus[] — https://www.w3.org/TR/vc-data-model-2.0/#status
      - `id` string — The URL identifying the schema file
      - `type` string — Type specifies the type of the file
      - `createdAt` Time
      - `purpose` 'CREDENTIAL_STATUS_PURPOSE_UNSPECIFIED' | 'CREDENTIAL_STATUS_PURPOSE_REVOCATION', enum — The value of the purpose for the status entry
    - `proof` Proof — A data integrity proof provides information about the proof mechanism, parameters required to verify that proof, and the proof value itself.
      - `type` string — The type of the proof
      - `proofPurpose` string — The proof purpose
      - `proofValue` string — The proof value
  - `mediaType` string — The media type of the Verifiable Credential (ex: application/vc)
  - `controller` string — The controller of the verification method associated with the securing mechanism, usually it represents the issuer.
  - `controlledIdentifierDocument` string — A controlled identifier document that is associated with the verification method used to verify the securing mechanism (i,e the DID)
  - `warnings` ErrorInfo[] — A list represents zero or more warnings generated by the verification process
    - `reason` 'ERROR_REASON_UNSPECIFIED' | 'ERROR_REASON_INTERNAL' | 'ERROR_REASON_INVALID_CREDENTIAL_ENVELOPE_TYPE' | 'ERROR_REASON_INVALID_CREDENTIAL_ENVELOPE_VALUE_FORMAT' | 'ERROR_REASON_INVALID_ISSUER' | 'ERROR_REASON_ISSUER_NOT_REGISTERED' | 'ERROR_REASON_INVALID_VERIFIABLE_CREDENTIAL' | 'ERROR_REASON_IDP_REQUIRED' | 'ERROR_REASON_INVALID_PROOF' | 'ERROR_REASON_UNSUPPORTED_PROOF' | 'ERROR_REASON_RESOLVER_METADATA_NOT_FOUND' | 'ERROR_REASON_UNKNOWN_IDP' | 'ERROR_REASON_ID_ALREADY_REGISTERED' | 'ERROR_REASON_VERIFIABLE_CREDENTIAL_REVOKED', enum — The reason of the error, as defined by the ErrorReason enum. This is a constant unique value that helps identify the cause of the error.
    - `message` string — The message describing the error in a human-readable way. This field gives additional details about the error.
  - `errors` ErrorInfo[] — A list represents zero or more errors generated by the verification process
    - `reason` 'ERROR_REASON_UNSPECIFIED' | 'ERROR_REASON_INTERNAL' | 'ERROR_REASON_INVALID_CREDENTIAL_ENVELOPE_TYPE' | 'ERROR_REASON_INVALID_CREDENTIAL_ENVELOPE_VALUE_FORMAT' | 'ERROR_REASON_INVALID_ISSUER' | 'ERROR_REASON_ISSUER_NOT_REGISTERED' | 'ERROR_REASON_INVALID_VERIFIABLE_CREDENTIAL' | 'ERROR_REASON_IDP_REQUIRED' | 'ERROR_REASON_INVALID_PROOF' | 'ERROR_REASON_UNSUPPORTED_PROOF' | 'ERROR_REASON_RESOLVER_METADATA_NOT_FOUND' | 'ERROR_REASON_UNKNOWN_IDP' | 'ERROR_REASON_ID_ALREADY_REGISTERED' | 'ERROR_REASON_VERIFIABLE_CREDENTIAL_REVOKED', enum — The reason of the error, as defined by the ErrorReason enum. This is a constant unique value that helps identify the cause of the error.
    - `message` string — The message describing the error in a human-readable way. This field gives additional details about the error.

## 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)