API Reference

Automate your credential issuance by integrating the MicroCreds REST API directly into your LMS or HR system.

Note: API access is only available for Enterprise plans. Please contact your account manager to generate an API Key.

Authentication

All API requests must include your API key in the `Authorization` header as a Bearer token.

Authorization: Bearer mc_live_xxxxxxxxxxxxxxxxx

Endpoints

1. Issue a Badge

Creates a new issued badge and automatically generates the cryptographic verification hash.

POST/api/v1/badges/issue

Request Body

{
  "earnerEmail": "student@university.edu",
  "templateId": "cuid_template_123",
  "issueDate": "2026-10-24T00:00:00Z"
}

Response (200 OK)

{
  "success": true,
  "data": {
    "id": "cuid_issued_123",
    "verificationHash": "8cd20c1a306abd4400b4751f...",
    "txHash": "0x4b3a...",
    "verificationUrl": "https://microcreds.com/badge/8cd20c1a306abd4400b4751f..."
  }
}