> ## 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 credential by ID (v2)



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-wallet.json get /v2/credentials/{id}
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/{id}:
    get:
      tags:
        - credentials
      summary: Get credential by ID.
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Credential resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CredentialV2ApiResponse'
components:
  schemas:
    CredentialV2ApiResponse:
      type: object
      properties:
        data:
          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

````