> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didx.co.za/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new issuance offer



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-creds.json post /v1/issuances
openapi: 3.0.0
info:
  version: 1.0.0
  title: Me Creds API
  description: >2-

          
    OpenAPI documentation for Me Creds API

          
    Following JSON:API spec https://jsonapi.org/format/ approach to response
    payload format.


    **Unversioned endpoints are deprecated.**

          
     - [JSON - OpenAPI Specification](/me-creds/api/openapi.json)
servers:
  - url: https://test.didxtech.com/me-creds/api
security:
  - bearerAuth: []
tags:
  - name: issuances
    description: >-
      Create and track credential issuance offers. Each issuance represents an
      OID4VCI offer/exchange session. Replaces the legacy `POST
      /credentials/issuance`, `GET /credentials`, and `GET /credentials/{id}`
      endpoints with resources keyed by issuance session ID.
  - name: credentials
    description: >-
      Query and revoke issued credentials. Each credential is a flat issued
      artifact identified by its own credential ID (not the issuance session
      ID). Replaces the legacy `POST /credentials/{id}/revoke` and `POST
      /credentials/revoke` endpoints.
  - name: legacy credentials
    description: >-
      **Deprecated.** These endpoints conflate issuance sessions and issued
      credentials under a single `/credentials` path with inconsistent ID
      semantics. Use the `issuances` and `credentials` groups instead.
  - name: presentations
    description: >-
      Create and query presentation requests. The `/v1/` paths are identical
      mirrors of the deprecated unversioned endpoints — no behavior change.
  - name: templates
    description: >-
      Manage credential and presentation templates. The `/v1/` paths are
      identical mirrors of the deprecated unversioned endpoints — no behavior
      change.
  - name: presets
    description: >-
      Manage credential and presentation presets. The `/v1/` paths are identical
      mirrors of the deprecated unversioned endpoints — no behavior change.
  - name: endpoints
    description: >-
      Manage webhook endpoint destinations. The `/v1/` paths are identical
      mirrors of the deprecated unversioned endpoints — no behavior change.
  - name: trusted-entities
    description: >-
      Manage trusted entities for credential verification. The `/v1/` paths are
      identical mirrors of the deprecated unversioned endpoints — no behavior
      change.
  - name: certificate-signing-requests
    description: >-
      Manage certificate signing requests (CSRs). The `/v1/` paths are identical
      mirrors of the deprecated unversioned endpoints — no behavior change.
  - name: certificates
    description: >-
      Manage root certificates and their lifecycle. The `/v1/` paths are
      identical mirrors of the deprecated unversioned endpoints — no behavior
      change.
  - name: ecosystem-subscriptions
    description: >-
      Manage trust ecosystem subscriptions. The `/v1/` paths are identical
      mirrors of the deprecated unversioned endpoints — no behavior change.
paths:
  /v1/issuances:
    post:
      tags:
        - issuances
      summary: Create a new issuance offer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateIssuanceDto'
      responses:
        '201':
          description: Issuance created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssuanceApiResponse'
components:
  schemas:
    CreateIssuanceDto:
      type: object
      properties:
        credentials:
          type: array
          items:
            type: object
            properties:
              credentialTemplateId:
                type: string
              presetId:
                type: string
              attributes:
                type: object
                additionalProperties:
                  nullable: true
            required:
              - attributes
          minItems: 1
      required:
        - credentials
      example:
        credentials:
          - credentialTemplateId: cm2ytsdid009u4ke3t30aiuvc
            attributes:
              firstName: John
              lastName: Doe
          - credentialTemplateId: cm3abc123mdoc456template
            attributes:
              org.iso.18013.5.1:
                given_name: John
                family_name: Doe
          - presetId: didx:basic-identity
            attributes:
              first_name: John
              last_name: Doe
    IssuanceApiResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/IssuanceDto'
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    IssuanceDto:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        error:
          type: string
          nullable: true
        credentials:
          type: array
          items:
            $ref: '#/components/schemas/IssuanceCredentialDto'
        createdAt:
          type: string
        updatedAt:
          type: string
        offerUri:
          type: string
          format: uri
        offerQrUri:
          type: string
          format: uri
      required:
        - id
        - status
        - error
        - credentials
        - createdAt
        - updatedAt
        - offerUri
        - offerQrUri
      example:
        id: cm7d9cq5600pwk3zq3kmpg8uc
        status: offered
        error: null
        credentials:
          - id: cm7d9cq5600pzk3zq9wzxxtc3
            status: offered
            credentialTemplateId: cm2ytsdid009u4ke3t30aiuvc
            exchange: openid4vc
            format: sd-jwt-vc
            revocable: false
        createdAt: '2025-02-20T11:27:37.051Z'
        updatedAt: '2025-02-20T11:27:37.051Z'
        offerUri: >-
          https://creds-app.test.didxtech.com/invitation?credential_offer_uri=https%3A%2F%2Fexample.com
        offerQrUri: >-
          https://creds-app.test.didxtech.com/invitation?credential_offer_uri=https%3A%2F%2Fexample.com&qr=true
    ApiLinks:
      type: object
      properties:
        self:
          type: string
          format: uri
        first:
          type: string
          format: uri
        last:
          type: string
          format: uri
        prev:
          type: string
          format: uri
        next:
          type: string
          format: uri
        related:
          type: string
          format: uri
    ApiMeta:
      type: object
      additionalProperties:
        nullable: true
    ApiError:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        code:
          type: string
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          properties:
            pointer:
              type: string
            parameter:
              type: string
        meta:
          type: object
          additionalProperties:
            nullable: true
      required:
        - detail
    IssuanceCredentialDto:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        credentialTemplateId:
          type: string
        exchange:
          type: string
        format:
          type: string
        revocable:
          type: boolean
      required:
        - id
        - status
        - credentialTemplateId
        - exchange
        - format
        - revocable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````