Skip to main content
POST
/
credential
/
vp
/
{vcId}
Issue VP
curl --request POST \
  --url https://api.example.com/credential/vp/{vcId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetVerifier": "did:web:organization.com"
}
'
{
  "presentation": {
    "@context": [
      "https://www.w3.org/ns/credentials/v2",
      "https://via.humanos.dev/ns/v1"
    ],
    "type": [
      "VerifiablePresentation"
    ],
    "holder": "did:via:humanos:user-550e8400-e29b-41d4-a716-446655440000",
    "verifiableCredential": [
      {
        "id": "urn:via:credential:550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "proof": {
      "type": "DataIntegrityProof",
      "cryptosuite": "eddsa-jcs-2022",
      "created": "2026-05-02T10:15:30.000Z",
      "verificationMethod": "did:web:humanos.tech:platform:550e8400-e29b-41d4-a716-446655440000#key-1",
      "proofPurpose": "authentication",
      "proofValue": "z2pcVdSdoMTrkYP9rVdz..."
    }
  },
  "receipt": {
    "id": "urn:via:receipt:c4bb2c9d-9b37-448b-8f1a-4ac5793945be",
    "timestamp": "2026-05-02T10:15:30.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://humanos.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
API-Version
string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-03"

Path Parameters

​
vcId
string
required

DID of the credential to present.

Example:

"did:web:humanos.tech:credential:550e8400-e29b-41d4-a716-446655440000"

Body

application/json
​
targetVerifier
string

DID of the intended verifier. When provided, the VP is bound to this audience via proof.domain and a challenge nonce.

Example:

"did:web:organization.com"

Response

Signed Verifiable Presentation and VP_CREATED receipt.

​
presentation
object
required

Signed W3C Verifiable Presentation. Includes @context, type, holder, verifiableCredential[], and proof. Pass this object as presentation to POST /credential/verify.

Example:
{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://via.humanos.dev/ns/v1"
  ],
  "type": ["VerifiablePresentation"],
  "holder": "did:via:humanos:user-550e8400-e29b-41d4-a716-446655440000",
  "verifiableCredential": [
    {
      "id": "urn:via:credential:550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "proof": {
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "created": "2026-05-02T10:15:30.000Z",
    "verificationMethod": "did:web:humanos.tech:platform:550e8400-e29b-41d4-a716-446655440000#key-1",
    "proofPurpose": "authentication",
    "proofValue": "z2pcVdSdoMTrkYP9rVdz..."
  }
}
​
receipt
object
required

VP_CREATED receipt issued for this presentation