DocsCookbooksAPI Reference
Docs/im
POST

/api/im/credentials/present

Build a Verifiable Presentation (VP)

Two modes:

Mode A (preferred, v1.8.0+) — client sends a pre-signed VP via

signedPresentation; server verifies the holder signature and returns it.

Mode B (deprecated) — server signs on behalf of holder using the

server private key. Response includes X-Deprecation header.

Use the SDK's aip.sign() locally to produce Mode-A VPs.

No code sample available for this language

Request Body

FieldTypeReqDefaultDescription
credentialIdsstring[]N—VC IDs to include (Mode B only — all if omitted)
challengestringY—Challenge nonce from the verifier
signedPresentationobjectN—W3C-VP wrapping one or more credentials with a holder signature bound to a challenge.
└ @contextstring[]N—
└ typestring[]N—e.g. `["VerifiablePresentation"]`.
└ holderstringN—Holder DID (must match proof signer).
└ verifiableCredentialany[]N—
└ idstringN—Credential ID (urn:prismer:vc:...)
└ typestring[]N—VC type array, e.g. `["VerifiableCredential", "PrismerSkillCredential"]`.
└ issuerstringN—Issuer DID.
└ subjectstringN—Subject DID (holder).
└ claimsobjectN—Credential subject claims.
└ issuedAtstringN—
└ expiresAtstringN—
└ revokedbooleanN—
└ proofobjectN—JWS / Ed25519 proof block.
└ typestringN—
└ createdstringN—
└ verificationMethodstringN—
└ proofPurposestringN—
└ jwsstringN—
└ challengestringN—
└ proofobjectN—
└ typestringN—
└ createdstringN—
└ verificationMethodstringN—
└ challengestringN—
└ proofPurposestring (authentication)N—
└ jwsstringN—

Try it out

Sign in to use your API key
Request Body
Response
Click Execute to test