DiligenceID Developers
GitHub

Initiate a credential issuance transaction from an authoritative source/CIAM system

GENERATED — DO NOT EDIT DIRECTLY. Produced from the canonical OpenAPI specification by developer-docs/tools/generate-reference.mjs. Edits are overwritten on the next run.

POST/v1.0/issuance-transactions

Resolves the caller's bound issuer (issuer-client callers) or the explicitly named issuer (staff/BFF callers), validates the supplied claims against the credential configuration's declared schema, and creates a standards-compliant OpenID4VCI credential offer. Supports Idempotency-Key. Scope: credentials.issue.
Operation ID IssuanceTransactions_Create
Plane Product
Versioning In the path
Authentication Authorization: ApiKey {key}
Required scope credentials.issue
Concurrency Not applicable

Request headers

Name Type Required Description
Idempotency-Key string No Replays the original result for a repeated call. The same key with a different payload is rejected with 409.
x-ms-client-request-id string No Optional caller-supplied correlation value, echoed back on the response and recorded in diagnostics. It never influences authentication, tenant or environment selection, resource lookup or idempotency.

Request body

Type: CreateIssuanceTransactionRequest

Field Type Required Description
callbackReference string, nullable No
claims object, nullable No
credentialConfiguration string Yes
delivery — No
externalSubjectReference string, nullable No
issuerId string, nullable No

Responses

Status Body Meaning
201 ApiEnvelopeOfIssuanceTransactionResponse Created.
400 ErrorEnvelope The request was not valid. See error model.
401 ErrorEnvelope Authentication failed — the API key is missing, malformed, revoked or expired.
403 ErrorEnvelope Authenticated, but the key does not carry the required scope.
404 ErrorEnvelope Not visible to this caller. A resource in another tenant or environment reports as not found.
409 ErrorEnvelope The request conflicts with the resource state, or an idempotency key was reused with a different payload.
429 ErrorEnvelope Throttled. See rate limits.

Response headers: x-ms-request-id

Example

curl -X POST "https://api.example.diligence.id/v1.0/issuance-transactions" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ }'

Edit this page on GitHub