> ## 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 templates (v1)



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-creds.json get /v1/templates/presentations
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/templates/presentations:
    get:
      tags:
        - templates
      summary: Get presentation templates.
      parameters:
        - schema:
            type: string
            description: Filter presentation templates by their unique identifier
            example: 6421a8905c17830c188e2e2f
          required: false
          description: Filter presentation templates by their unique identifier
          name: filter[id]
          in: query
        - schema:
            type: string
            description: Search presentation templates by name (partial match)
            example: presentation
          required: false
          description: Search presentation templates by name (partial match)
          name: search[name]
          in: query
        - schema:
            type: string
            enum:
              - id
              - '-id'
              - createdAt
              - '-createdAt'
              - updatedAt
              - '-updatedAt'
            description: Sort order for the results. Prefix with "-" for descending order
            example: '-createdAt'
          required: false
          description: Sort order for the results. Prefix with "-" for descending order
          name: sort
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 100
            description: Number of items to return per page (1-100)
            example: 10
          required: false
          description: Number of items to return per page (1-100)
          name: page[size]
          in: query
        - schema:
            type: string
            description: Cursor for pagination - return items before this ID value
            example: 6421a8905c17830c188e2e2f
          required: false
          description: Cursor for pagination - return items before this ID value
          name: page[before]
          in: query
        - schema:
            type: string
            description: Cursor for pagination - return items after this ID value
            example: 6421a8905c17830c188e2e30
          required: false
          description: Cursor for pagination - return items after this ID value
          name: page[after]
          in: query
      responses:
        '200':
          description: List of presentation templates.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresentationTemplateListApiResponse'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  details:
                    type: string
                required:
                  - error
components:
  schemas:
    PresentationTemplateListApiResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PresentationTemplateDto'
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    PresentationTemplateDto:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
        id:
          type: string
        credentials:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/SdJwtPresentationCredentialResponse'
              - $ref: '#/components/schemas/MdocPresentationCredentialResponse'
            discriminator:
              propertyName: format
              mapping:
                sd-jwt-vc:
                  $ref: '#/components/schemas/SdJwtPresentationCredentialResponse'
                mdoc:
                  $ref: '#/components/schemas/MdocPresentationCredentialResponse'
        verifier:
          anyOf:
            - type: string
            - type: object
              properties:
                signer:
                  type: string
                  enum:
                    - certificate
                keyType:
                  type: string
                  enum:
                    - P-256
                    - Ed25519
              required:
                - signer
      required:
        - name
        - description
        - createdAt
        - updatedAt
        - id
        - credentials
      example:
        name: My presentation template
        description: This is a description
        createdAt: '2025-02-20T11:27:37.051Z'
        updatedAt: '2025-02-20T11:27:37.051Z'
        id: 6421a8905c17830c188e2e2f
        credentials:
          - format: sd-jwt-vc
            name: My SD-JWT credential
            description: A verifiable credential
            type: https://test.didxtech.com/vct/acme-university/UniversityCard
            attributes:
              myAttribute:
                type: string
          - format: mdoc
            name: My mDL credential
            description: A mobile driving licence
            type: org.iso.18013.5.1.mDL
            attributes:
              org.iso.18013.5.1:
                properties:
                  family_name:
                    intentToRetain: false
    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
    SdJwtPresentationCredentialResponse:
      type: object
      properties:
        format:
          type: string
          enum:
            - sd-jwt-vc
        type:
          type: string
        attributes:
          type: object
          additionalProperties:
            nullable: true
        name:
          type: string
        description:
          type: string
        trustedIssuers:
          type: array
          items:
            $ref: '#/components/schemas/TrustedEntityDto'
      required:
        - format
        - type
        - attributes
    MdocPresentationCredentialResponse:
      type: object
      properties:
        format:
          type: string
          enum:
            - mdoc
        type:
          type: string
        attributes:
          $ref: '#/components/schemas/MdocPresentationNamespace'
        name:
          type: string
        description:
          type: string
        trustedIssuers:
          type: array
          items:
            $ref: '#/components/schemas/TrustedEntityDto'
      required:
        - format
        - type
        - attributes
    TrustedEntityDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
        dids:
          type: array
          items:
            type: object
            properties:
              did:
                type: string
              name:
                type: string
            required:
              - did
        certificates:
          type: array
          items:
            type: object
            properties:
              certificate:
                type: string
              name:
                type: string
            required:
              - certificate
      required:
        - id
        - name
        - createdAt
        - updatedAt
        - dids
        - certificates
      example:
        id: cm7d9cq5600pwk3zq3kmpg8uc
        name: Trusted Government Issuer
        createdAt: '2025-02-20T11:27:37.051Z'
        updatedAt: '2025-02-20T11:27:37.051Z'
        dids:
          - did: did:web:example.com
            name: Main DID
        certificates: []
    MdocPresentationNamespace:
      type: object
      additionalProperties:
        type: object
        properties:
          properties:
            type: object
            additionalProperties:
              type: object
              properties:
                intentToRetain:
                  type: boolean
        required:
          - properties
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````