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



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-creds.json get /v1/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/presentations:
    get:
      tags:
        - presentations
      summary: Get presentations
      parameters:
        - schema:
            type: string
            description: Filter presentation requests by their unique identifier
            example: cmbhsgi6c00cls60120oyb8tl
          required: false
          description: Filter presentation requests by their unique identifier
          name: filter[id]
          in: query
        - schema:
            type: string
            description: >-
              Filter presentation requests by their current status (e.g.,
              "requested", "verified", "expired")
            example: verified
          required: false
          description: >-
            Filter presentation requests by their current status (e.g.,
            "requested", "verified", "expired")
          name: filter[status]
          in: query
        - schema:
            type: string
            description: Filter presentation requests by their template identifier
            example: cma2nw2vd00sos601irn14wt1
          required: false
          description: Filter presentation requests by their template identifier
          name: filter[presentationTemplateId]
          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: cmbhsgi6c00cls60120oyb8tl
          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: cmbhsgi6c00cls60120oyb8tl
          required: false
          description: Cursor for pagination - return items after this ID value
          name: page[after]
          in: query
      responses:
        '200':
          description: List of presentations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresentationRequestListApiResponse'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  details:
                    type: string
                required:
                  - error
components:
  schemas:
    PresentationRequestListApiResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PresentationRequestDto'
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    PresentationRequestDto:
      type: object
      properties:
        id:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
        status:
          type: string
        error:
          type: string
          nullable: true
        notice:
          type: string
          nullable: true
        presentationTemplateId:
          type: string
        credentials:
          type: array
          items:
            $ref: '#/components/schemas/CredentialDto'
        expiresAt:
          type: string
        authorizationRequestUri:
          type: string
          format: uri
        authorizationRequestQrUri:
          type: string
          format: uri
      required:
        - id
        - createdAt
        - updatedAt
        - status
        - error
        - notice
        - presentationTemplateId
        - credentials
        - expiresAt
        - authorizationRequestUri
        - authorizationRequestQrUri
      example:
        id: cmbhsgi6c00cls60120oyb8tl
        createdAt: '2025-06-04T10:12:20.101Z'
        updatedAt: '2025-06-04T10:12:20.101Z'
        status: requested
        error: null
        notice: null
        presentationTemplateId: cma2nw2vd00sos601irn14wt1
        credentials:
          - isValid: true
            format: sd-jwt-vc
            name: Identity
            type: https://test.didxtech.com/vct/acme-university/identity
            issuer:
              type: did
              did: >-
                did:web:test.didxtech.com:metadata:3c9d79ef-6aca-4f3e-b2ab-1f2933b7fe90
            attributes:
              name: Johny
              surname: Postman
            issues: []
            trustSignals: []
        expiresAt: '2025-07-04T10:12:20.088Z'
        authorizationRequestUri: >-
          https://creds-app.test.didxtech.com/invitation?request_uri=https%3A%2F%2Fcreds-app.test.didxtech.com%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&client_id=did%3Aweb%3Atest.didxtech.com%3Ametadata%3A3c9d79ef-6aca-4f3e-b2ab-1f2933b7fe90
        authorizationRequestQrUri: >-
          https://creds-app.test.didxtech.com/invitation?request_uri=https%3A%2F%2Fcreds-app.test.didxtech.com%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&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
    CredentialDto:
      type: object
      properties:
        isValid:
          type: boolean
        format:
          type: string
        name:
          type: string
        type:
          type: string
          nullable: true
        issuer:
          $ref: '#/components/schemas/CredentialIssuerDto'
        attributes:
          type: object
          additionalProperties:
            nullable: true
        issues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorDto'
        trustSignals:
          type: array
          items:
            $ref: '#/components/schemas/TrustSignalDto'
      required:
        - isValid
        - format
        - name
        - type
        - issuer
        - attributes
        - issues
        - trustSignals
      example:
        isValid: true
        format: sd-jwt-vc
        name: Identity
        type: https://test.didxtech.com/vct/acme-university/identity
        issuer:
          type: did
          did: >-
            did:web:test.didxtech.com:metadata:3c9d79ef-6aca-4f3e-b2ab-1f2933b7fe90
        attributes:
          name: Johny
          surname: Postman
        issues: []
        trustSignals: []
    CredentialIssuerDto:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - did
            did:
              type: string
          required:
            - type
            - did
        - type: object
          properties:
            type:
              type: string
              enum:
                - x509
            commonName:
              type: string
              nullable: true
            certificate:
              type: string
          required:
            - type
            - commonName
            - certificate
        - nullable: true
    ValidationErrorDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - EXPIRED
            - INVALID_CREDENTIAL
            - NOT_YET_VALID
            - REVOKED
            - UNKNOWN
        message:
          type: string
        details:
          type: object
          additionalProperties:
            nullable: true
      required:
        - type
        - message
      example:
        type: EXPIRED
        message: Credential has expired
        details:
          expirationTime: 1908230400
          currentTime: 1908230500
    TrustSignalDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - TRUSTED_ISSUER
        message:
          type: string
        details:
          type: object
          additionalProperties:
            nullable: true
      required:
        - type
        - message
      example:
        type: TRUSTED_ISSUER
        message: Credential was issued by a trusted issuer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````