---
title: "Get credential endpoint"
method: POST
path: "/credentials"
tags: ["Wallet"]
---

# Get credential endpoint

`POST /credentials`

Request issuance of a credential

## Request body

- CredentialRequest — Request to issue a credential according to OID4VCI v1.0.15 specification. Exactly one of credential_identifier or credential_configuration_id MUST be present.
  - `credential_identifier` string — REQUIRED when authorization_details was returned from Token Response. Identifies a Credential Dataset for issuance. MUST NOT be present with credential_configuration_id.
  - `credential_configuration_id` string — REQUIRED if credential_identifier was not returned. String identifying a key in credential_configurations_supported. MUST NOT be present with credential_identifier.
  - `proof` ProofOfPossession — Proof of possession structure for credential requests
    - `proof_type` 'jwt', required — The type of proof provided
    - `jwt` string, required — A signed JWT containing the proof of possession
  - `proofs` ProofOfPossessionArray — Object containing arrays of proofs for batch credential issuance
    - `jwt` string[]
  - `credential_response_encryption` CredentialResponseEncryption — Encryption parameters for credential response
    - `jwk` object, required — JWK for encryption
    - `alg` string, required — JWE algorithm
    - `enc` string, required — Content encryption algorithm
  - `issuer_state` string — OPTIONAL. Issuer state for external AS integration without nonces

## Response `200`

Successful response with issued credential

- CredentialResponse — Response containing the issued credential
  - `credentials` object[] — Array of issued credentials. MUST NOT be present if transaction_id is present.
    - `credential` union — The issued credential
      - string
      - object
  - `transaction_id` string — Identifier for deferred issuance. MUST NOT be present if credentials is present.
  - `notification_id` string — Identifier for notification requests

## Changes

- **2025-09-30** `bc177bfc5928` — 3 breaking, 5 warning, 6 info
  - the request property `credential_response_encryption/alg` became required
  - the request property `credential_response_encryption/enc` became required
  - the request property `credential_response_encryption/jwk` became required
  - removed the request property `format`
  - …10 more
- **2025-09-25** `ccca87b4e0bf` — 1 breaking, 1 warning, 2 info
  - removed the enum value `vc+sd-jwt` of the request property `format`
  - added the new `dc+sd-jwt` enum value to the `format` response property for the response status `200`
  - added the new `dc+sd-jwt` enum value to the request property `format`
  - removed the `vc+sd-jwt` enum value from the `format` response property for the response status `200`

[Change history](https://skmtc.dev/sphereon-opensource/apis/sphereon-oid4vci-api/changes/credentials/post.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/sphereon-oid4vci-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/sphereon-oid4vci-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/sphereon-oid4vci-api/revisions/bc177bfc5928/schema)