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

# Get verification badge

> Returns a binary image for the requested Bluprynt verification badge. Responses are aggressively cached via `Cache-Control: public, max-age=31536000, immutable`.



## OpenAPI

````yaml /openapi/public.json get /api/v1/badges/{credential_type}
openapi: 3.0.0
info:
  title: Bluprynt Public API
  description: Read KYI-verified assets and embed verification badges.
  version: 1.0.0
  contact: {}
servers:
  - url: https://integrations.bluprynt.com
security: []
tags:
  - name: Assets
    description: Assets
  - name: Badges
    description: Verification badge assets
paths:
  /api/v1/badges/{credential_type}:
    get:
      tags:
        - Badges
      summary: Get verification badge
      description: >-
        Returns a binary image for the requested Bluprynt verification badge.
        Responses are aggressively cached via `Cache-Control: public,
        max-age=31536000, immutable`.
      operationId: badges.getBadge
      parameters:
        - name: credential_type
          required: true
          in: path
          description: Credential type to display a badge for
          schema:
            enum:
              - kyi_verified
              - proof_of_collateral
            type: string
        - name: size
          required: false
          in: query
          description: >-
            Badge size in pixels (ignored when variant=full). Note: 64 falls
            back to 32px as no 64px icon asset exists.
          schema:
            enum:
              - '16'
              - '24'
              - '32'
              - '64'
            type: string
        - name: format
          required: false
          in: query
          description: Image format
          schema:
            enum:
              - svg
              - png
              - webp
            type: string
        - name: theme
          required: false
          in: query
          description: Badge colour theme
          schema:
            enum:
              - dark
              - light
            type: string
        - name: variant
          required: false
          in: query
          description: icon = square icon; full = pill badge with text (size ignored)
          schema:
            enum:
              - icon
              - full
            type: string
      responses:
        '200':
          description: Badge image
          content:
            image/svg+xml:
              schema:
                type: string
                format: binary
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Invalid credential_type or query parameter value
        '415':
          description: Unsupported Media Type — WebP is not yet available

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.