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

# List presentations (paginated) (v2)

> Returns presentations for the authenticated user, sorted by createdAt descending (newest first). Default page size is 50. Follow links.next for paging (prefer not to derive cursors from data).



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-wallet.json get /v2/presentations
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:
  /v2/presentations:
    get:
      tags:
        - presentations
      summary: List presentations (paginated).
      description: >-
        Returns presentations for the authenticated user, sorted by createdAt
        descending (newest first). Default page size is 50. Follow links.next
        for paging (prefer not to derive cursors from data).
      parameters:
        - schema:
            type: number
            minimum: 1
            maximum: 100
            description: Number of items per page (1-100). Defaults to 50 when omitted.
          required: false
          description: Number of items per page (1-100). Defaults to 50 when omitted.
          name: page[size]
          in: query
        - schema:
            type: string
            description: >-
              Cursor for pagination — return items after this resource id (older
              items). Prefer the value from links.next rather than the last
              visible data item.
          required: false
          description: >-
            Cursor for pagination — return items after this resource id (older
            items). Prefer the value from links.next rather than the last
            visible data item.
          name: page[after]
          in: query
        - schema:
            type: string
            description: >-
              Cursor for pagination — return items before this resource id
              (newer items). Prefer the value from links.prev rather than the
              first visible data item.
          required: false
          description: >-
            Cursor for pagination — return items before this resource id (newer
            items). Prefer the value from links.prev rather than the first
            visible data item.
          name: page[before]
          in: query
      responses:
        '200':
          description: List of presentations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresentationV2ArrayApiResponse'
components:
  schemas:
    PresentationV2ArrayApiResponse:
      type: object
      properties:
        data:
          type: array
          items:
            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
                  - approved
                  - rejected
                description: Current status of the presentation
                example: pending
              createdAt:
                type: string
                format: date-time
                description: Timestamp when the presentation was created
              updatedAt:
                type: string
                format: date-time
                description: Timestamp when the presentation was last updated
              verifierName:
                type: string
                description: Verifier display name from client_metadata.client_name
                example: exampleOrg-me-creds
              verifier:
                $ref: '#/components/schemas/VerifierInfoDto'
              trust:
                $ref: '#/components/schemas/TrustSignalDto'
            required:
              - id
              - tenantId
              - status
              - createdAt
              - updatedAt
              - verifier
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    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.
    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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````