> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beltic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DID Document

> W3C DID document for the Beltic issuer. Verifiers following the
did:web resolution method fetch this to confirm the issuer identity and
retrieve verification methods. Each `verificationMethod` entry corresponds
to a current public signing key.

`Cache-Control: max-age=3600`.



## OpenAPI

````yaml GET /.well-known/did.json
openapi: 3.1.0
info:
  title: Beltic Credentials API
  version: 1.0.0
servers: []
security: []
paths:
  /.well-known/did.json:
    get:
      tags:
        - Well-known
      summary: DID document (did:web)
      description: >-
        W3C DID document for the Beltic issuer. Verifiers following the

        did:web resolution method fetch this to confirm the issuer identity and

        retrieve verification methods. Each `verificationMethod` entry
        corresponds

        to a current public signing key.


        `Cache-Control: max-age=3600`.
      responses:
        '200':
          description: DID document
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DidDocument'
        '400':
          description: Validation error or malformed request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '403':
          description: Forbidden — caller lacks required permission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '409':
          description: Conflict (e.g., credential already revoked, idempotency clash)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    DidDocument:
      type: object
      properties:
        '@context':
          type: array
          items:
            type: string
        id:
          type: string
        verificationMethod:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
                enum:
                  - JsonWebKey2020
              controller:
                type: string
              publicKeyJwk:
                type: object
                properties:
                  kty:
                    type: string
                    enum:
                      - EC
                  crv:
                    type: string
                    enum:
                      - P-256
                  x:
                    type: string
                  'y':
                    type: string
                  alg:
                    type: string
                    enum:
                      - ES256
                  kid:
                    type: string
                required:
                  - kty
                  - crv
                  - x
                  - 'y'
                  - alg
                  - kid
            required:
              - id
              - type
              - controller
              - publicKeyJwk
        assertionMethod:
          type: array
          items:
            type: string
        authentication:
          type: array
          items:
            type: string
      required:
        - '@context'
        - id
        - verificationMethod
        - assertionMethod
        - authentication
    ApiErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - error
    ApiError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/ApiErrorDetail'
        request_id:
          type: string
      required:
        - code
        - message
    ApiErrorDetail:
      type: object
      properties:
        field:
          type: string
        issue:
          type: string
        hint:
          type: string
      required:
        - issue

````