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

# Create credential resource



## OpenAPI

````yaml products/didx-me/api-reference/v1/me-wallet.json post /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:
  /credentials:
    post:
      tags:
        - credentials
      summary: Create credential resource.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                credentialOffer:
                  type: string
                  description: cred offer
              required:
                - credentialOffer
      responses:
        '201':
          description: List of credentials.
          content:
            application/json:
              schema:
                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
      deprecated: true
components:
  schemas:
    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.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````