> ## 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 pending presentation (/presentations/v2)

> Matches credentials for the presentation request but does not auto-answer. User must explicitly approve or reject.



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-wallet.json post /presentations/v2
openapi: 3.0.0
info:
  version: 1.0.0
  title: Me Wallet API
  description: >2-

          
    OpenAPI documentation for Me Wallet API

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


    **v1 endpoints are deprecated.** See the [Migration Guide (v1 to
    v2)](migration-guide) for details.

          
     - [JSON - OpenAPI Specification](/me-wallet/api/openapi.json)
servers:
  - url: https://test.didxtech.com/me-wallet/api
security:
  - bearerAuth: []
tags:
  - name: users
    description: User info
  - name: tenants
    description: Tenant management
  - name: credentials
    description: User credential management
  - name: presentations
    description: Presentation management
  - name: org-credentials
    description: Organization endpoints — credential issuance
  - name: org-presentations
    description: Organization endpoints — presentation requests
paths:
  /presentations/v2:
    post:
      tags:
        - presentations
      summary: Create a pending presentation.
      description: >-
        Matches credentials for the presentation request but does not
        auto-answer. User must explicitly approve or reject.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                presentationRequest:
                  type: string
                  description: Incoming presentation request
              required:
                - presentationRequest
      responses:
        '201':
          description: Created presentation with credential selection.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier for the presentation
                    example: 123e4567-e89b-12d3-a456-426614174000
                  tenantId:
                    type: string
                    format: uuid
                    description: ID of the tenant that owns this presentation
                    example: 987fcdeb-51a2-43f8-b456-142789abcdef
                  selectedCredentials:
                    type: array
                    items:
                      type: object
                      properties:
                        credentialId:
                          type: string
                          format: uuid
                          description: >-
                            Resource credential ID selected for this
                            presentation
                        matchedAttributes:
                          type: array
                          items:
                            type: string
                          description: >-
                            Attribute paths matched from this credential. For
                            PEX: JSONPath expressions (e.g. "$.name"). For DCQL
                            mso_mdoc: dot-joined namespace and element
                            identifier (e.g.
                            "com.example.identity.core.v1.given_name"). Nested
                            attributes are represented with dot-notation (e.g.
                            "person.idNumber").
                      required:
                        - credentialId
                    description: >-
                      Credentials selected for this presentation, each with
                      their matched attribute paths
                  status:
                    type: string
                    enum:
                      - PENDING
                      - REJECTED
                      - ANSWERED
                    description: Current status of the presentation
                    example: PENDING
                  createdAt:
                    type: string
                    format: date-time
                    description: Timestamp when the presentation was created
                    example: '2024-03-15T10:30:00Z'
                  updatedAt:
                    type: string
                    format: date-time
                    description: Timestamp when the presentation was last updated
                    example: '2024-03-15T10:30:00Z'
                  verifierName:
                    type: string
                    description: Verifier display name from client_metadata.client_name
                    example: vijevohopu-me-creds
                  verifier:
                    $ref: '#/components/schemas/VerifierInfoDto'
                  trust:
                    $ref: '#/components/schemas/TrustSignalDto'
                required:
                  - id
                  - tenantId
                  - status
                  - createdAt
                  - updatedAt
                  - verifier
components:
  schemas:
    VerifierInfoDto:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - did
            did:
              type: string
          required:
            - type
            - did
        - type: object
          properties:
            type:
              type: string
              enum:
                - x509
            certificateChain:
              type: array
              items:
                type: string
          required:
            - type
            - certificateChain
        - nullable: true
      description: >-
        Structured verifier identity — DID or x509 certificate chain (leaf
        first). Null when the authorization request was unsigned.
      example:
        type: did
        did: did:web:test.didxtech.com:metadata:example-project
    TrustSignalDto:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - trusted
            sourceId:
              type: string
            category:
              type: string
            subject:
              type: string
            issuingCa:
              type: object
              properties:
                id:
                  type: string
                sha256ThumbprintBase64Url:
                  type: string
              required:
                - id
                - sha256ThumbprintBase64Url
            entity:
              type: object
              properties:
                entityId:
                  type: string
                legalName:
                  type: string
                sector:
                  type: string
              required:
                - entityId
                - legalName
                - sector
            service:
              type: object
              properties:
                serviceId:
                  type: string
                role:
                  type: string
                status:
                  type: string
              required:
                - serviceId
                - role
                - status
          required:
            - status
            - sourceId
            - category
            - subject
            - issuingCa
            - entity
            - service
        - type: object
          properties:
            status:
              type: string
              enum:
                - untrusted
            subject:
              type: string
            failedAt:
              type: string
              enum:
                - parse
                - expired
                - not-yet-valid
                - chain-incomplete
                - invalid-basic-constraints
                - invalid-key-usage
                - unknown-critical-extension
                - not-registered
            error:
              type: string
          required:
            - status
        - type: object
          properties:
            status:
              type: string
              enum:
                - check_failed
            error:
              type: string
          required:
            - status
            - error
      description: >-
        Trust signal captured at receive time when the issuer/verifier presented
        an x509 certificate. Absent for DID-based identities or pre-feature
        rows.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````