> ## 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 credentials by status (paginated).

> Returns credentials filtered by consent status, 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/credentials
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/credentials:
    get:
      tags:
        - credentials
      summary: List credentials by status (paginated).
      description: >-
        Returns credentials filtered by consent status, 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
        - schema:
            type: string
            enum:
              - pending
              - accepted
              - rejected
            description: Filter credentials by consent status
          required: true
          description: Filter credentials by consent status
          name: status
          in: query
      responses:
        '200':
          description: List of credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CredentialV2ArrayApiResponse'
components:
  schemas:
    CredentialV2ArrayApiResponse:
      type: object
      properties:
        data:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier for the credential
                    example: 123e4567-e89b-12d3-a456-426614174000
                  claims:
                    type: object
                    additionalProperties:
                      nullable: true
                    description: Key-value pairs containing the credential claims
                    example:
                      firstName: John
                      lastName: Doe
                      age: 34
                      isVerified: true
                      dateOfBirth: '1990-06-15'
                      address:
                        street: 123 Main St
                        city: Cape Town
                        country: ZA
                      phoneNumbers:
                        - '+27821234567'
                        - '+27831234567'
                  iss:
                    type: string
                    minLength: 1
                    maxLength: 512
                    description: >-
                      Issuer identifier — DID for SD-JWT credentials, X.509 DN
                      for mdoc credentials
                    example: did:example:123456789abcdefghi
                  issuer:
                    $ref: '#/components/schemas/CredentialIssuerDto'
                  iat:
                    type: string
                    format: date-time
                    description: Timestamp when the credential was issued (ISO 8601 format)
                    example: '2024-03-15T10:30:00Z'
                  status:
                    type: string
                    enum:
                      - pending
                      - accepted
                      - rejected
                    description: Current consent status of the credential
                    example: accepted
                  trust:
                    $ref: '#/components/schemas/TrustSignalDto'
                  display:
                    $ref: '#/components/schemas/CredentialDisplayDto'
                  format:
                    type: string
                    enum:
                      - vc+sd-jwt
                    description: Credential format
                    example: vc+sd-jwt
                  vct:
                    type: string
                    minLength: 1
                    maxLength: 256
                    description: >-
                      Verifiable Credential Type identifying the schema of the
                      credential
                    example: VerifiableId
                required:
                  - id
                  - claims
                  - issuer
                  - iat
                  - status
                  - format
                  - vct
              - type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier for the credential
                    example: 123e4567-e89b-12d3-a456-426614174000
                  claims:
                    type: object
                    additionalProperties:
                      nullable: true
                    description: Key-value pairs containing the credential claims
                    example:
                      firstName: John
                      lastName: Doe
                      age: 34
                      isVerified: true
                      dateOfBirth: '1990-06-15'
                      address:
                        street: 123 Main St
                        city: Cape Town
                        country: ZA
                      phoneNumbers:
                        - '+27821234567'
                        - '+27831234567'
                  iss:
                    type: string
                    minLength: 1
                    maxLength: 512
                    description: >-
                      Issuer identifier — DID for SD-JWT credentials, X.509 DN
                      for mdoc credentials
                    example: did:example:123456789abcdefghi
                  issuer:
                    $ref: '#/components/schemas/CredentialIssuerDto'
                  iat:
                    type: string
                    format: date-time
                    description: Timestamp when the credential was issued (ISO 8601 format)
                    example: '2024-03-15T10:30:00Z'
                  status:
                    type: string
                    enum:
                      - pending
                      - accepted
                      - rejected
                    description: Current consent status of the credential
                    example: accepted
                  trust:
                    $ref: '#/components/schemas/TrustSignalDto'
                  display:
                    $ref: '#/components/schemas/CredentialDisplayDto'
                  format:
                    type: string
                    enum:
                      - mso_mdoc
                    description: Credential format
                    example: mso_mdoc
                  docType:
                    type: string
                    minLength: 1
                    maxLength: 256
                    description: mdoc document type (e.g. org.iso.18013.5.1.mDL)
                    example: org.test.name
                required:
                  - id
                  - claims
                  - issuer
                  - iat
                  - status
                  - format
                  - docType
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    CredentialIssuerDto:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - did
            did:
              type: string
          required:
            - type
            - did
        - type: object
          properties:
            type:
              type: string
              enum:
                - x509
            certificate:
              type: string
          required:
            - type
            - certificate
        - nullable: true
      description: >-
        Structured issuer identity — DID or X.509 certificate. Null when issuer
        cannot be determined.
      example:
        type: did
        did: did:example:123456789abcdefghi
    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.
    CredentialDisplayDto:
      type: object
      properties:
        name:
          type: string
          description: Display name of the credential
        description:
          type: string
          description: Description of the credential
        backgroundColor:
          type: string
          description: 'Card background color (CSS color, e.g. #0066CC)'
        textColor:
          type: string
          description: 'Card text color (CSS color, e.g. #FFFFFF)'
        backgroundImageUrl:
          type: string
          description: URL of the card background image
        issuer:
          type: object
          properties:
            name:
              type: string
              description: Display name of the issuer
            logoUrl:
              type: string
              description: URL of the issuer logo
      example:
        name: Membership Card
        description: Acme Corp membership credential
        backgroundColor: '#0066CC'
        textColor: '#FFFFFF'
        backgroundImageUrl: https://example.com/bg.png
        issuer:
          name: Acme Corp
          logoUrl: https://example.com/logo.png
      description: >-
        Issuer/credential display branding (logo, colors, background image).
        Absent when the issuer provides no display metadata.
    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

````