> ## 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.

# Get presentation preset by id (v1)



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-creds.json get /v1/presets/presentations/{id}
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/presets/presentations/{id}:
    get:
      tags:
        - presets
      summary: Get presentation preset by id.
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Presentation preset resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresentationPresetApiResponse'
components:
  schemas:
    PresentationPresetApiResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PresentationPresetResponse'
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    PresentationPresetResponse:
      type: object
      properties:
        id:
          type: string
        author:
          type: string
        templateName:
          type: string
        code:
          type: string
        templateDescription:
          type: string
        templateCredentials:
          type: array
          items:
            $ref: '#/components/schemas/PresetPresentationCredential'
        verifierConfig:
          $ref: '#/components/schemas/VerifierConfig'
        namespace:
          type: string
          enum:
            - public
            - private
        createdAt:
          type: string
        updatedAt:
          type: string
      required:
        - id
        - author
        - templateName
        - code
        - templateDescription
        - templateCredentials
        - verifierConfig
        - namespace
        - createdAt
        - updatedAt
      example:
        id: didx:basic-identity-request
        author: didx
        code: basic-identity-request
        templateName: Basic Identity Request
        templateDescription: Standard request for basic identity information
        templateCredentials:
          - format: sd-jwt-vc
            name: Basic Identity Credential
            description: A credential containing basic identity information
            type: https://didx.co.za/vct/didx/basic-identity
            attributes:
              firstName:
                type: string
              lastName:
                type: string
            trustedIssuers:
              - kind: did
                did: did:web:issuer.example.com
                name: Example Identity Issuer
          - format: mdoc
            name: Mobile Driving Licence
            description: ISO 18013-5 mDL credential
            type: org.iso.18013.5.1.mDL
            trustedIssuers: []
            attributes:
              org.iso.18013.5.1:
                properties:
                  given_name:
                    intentToRetain: false
                  family_name:
                    intentToRetain: false
        verifierConfig:
          signer: did:web
        namespace: public
        createdAt: '2025-02-20T11:27:37.051Z'
        updatedAt: '2025-02-20T11:27:37.051Z'
    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
    PresetPresentationCredential:
      oneOf:
        - $ref: '#/components/schemas/PresetSdJwtPresentationCredential'
        - $ref: '#/components/schemas/PresetMdocPresentationCredential'
      discriminator:
        propertyName: format
        mapping:
          sd-jwt-vc:
            $ref: '#/components/schemas/PresetSdJwtPresentationCredential'
          mdoc:
            $ref: '#/components/schemas/PresetMdocPresentationCredential'
    VerifierConfig:
      oneOf:
        - type: object
          properties:
            signer:
              type: string
              enum:
                - did:web
          required:
            - signer
        - type: object
          properties:
            signer:
              type: string
              enum:
                - certificate
            keyType:
              type: string
              enum:
                - P-256
                - Ed25519
          required:
            - signer
    PresetSdJwtPresentationCredential:
      type: object
      properties:
        format:
          type: string
          enum:
            - sd-jwt-vc
        type:
          type: string
          description: Verifiable Credential Type (VCT) URL
        attributes:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SdJwtPresentationAttribute'
        name:
          type: string
        description:
          type: string
        trustedIssuers:
          type: array
          items:
            $ref: '#/components/schemas/PresetTrustedIssuer'
      required:
        - format
        - type
        - attributes
    PresetMdocPresentationCredential:
      type: object
      properties:
        format:
          type: string
          enum:
            - mdoc
        type:
          type: string
          description: Mdoc document type
        attributes:
          $ref: '#/components/schemas/MdocPresentationNamespace'
        name:
          type: string
        description:
          type: string
        trustedIssuers:
          type: array
          items:
            $ref: '#/components/schemas/PresetTrustedIssuer'
      required:
        - format
        - type
        - attributes
    SdJwtPresentationAttribute:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - string
            value:
              type: string
          required:
            - type
        - type: object
          properties:
            type:
              type: string
              enum:
                - number
            value:
              type: number
            minimum:
              type: number
            maximum:
              type: number
          required:
            - type
        - type: object
          properties:
            type:
              type: string
              enum:
                - boolean
            value:
              type: boolean
          required:
            - type
        - type: object
          properties:
            type:
              type: string
              enum:
                - date
            value:
              type: string
          required:
            - type
        - type: object
          properties:
            type:
              type: string
              enum:
                - object
            properties:
              type: object
              additionalProperties:
                nullable: true
          required:
            - type
            - properties
        - type: object
          properties:
            type:
              type: string
              enum:
                - array
            items:
              nullable: true
          required:
            - type
        - type: object
          properties: {}
          additionalProperties: false
    PresetTrustedIssuer:
      oneOf:
        - $ref: '#/components/schemas/PresetTrustedIssuerDid'
        - $ref: '#/components/schemas/PresetTrustedIssuerX509'
      discriminator:
        propertyName: kind
        mapping:
          did:
            $ref: '#/components/schemas/PresetTrustedIssuerDid'
          x509:
            $ref: '#/components/schemas/PresetTrustedIssuerX509'
    MdocPresentationNamespace:
      type: object
      additionalProperties:
        type: object
        properties:
          properties:
            type: object
            additionalProperties:
              type: object
              properties:
                intentToRetain:
                  type: boolean
        required:
          - properties
    PresetTrustedIssuerDid:
      type: object
      properties:
        kind:
          type: string
          enum:
            - did
        did:
          type: string
          pattern: ^did:[a-z0-9]+:.+/i
        name:
          type: string
          minLength: 1
      required:
        - kind
        - did
        - name
    PresetTrustedIssuerX509:
      type: object
      properties:
        kind:
          type: string
          enum:
            - x509
        certificate:
          type: string
        name:
          type: string
          minLength: 1
      required:
        - kind
        - certificate
        - name
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````