Skip to content
Veriglob API

Introduction

The Veriglob API provides a comprehensive REST interface for building decentralized identity solutions using the Veriglob protocol. This documentation covers all aspects of the API, from authentication to advanced credential management.

Overview

Section titled “Overview”

Veriglob enables you to:

  • Create and manage DIDs: Generate did:key identifiers with Ed25519 keypairs
  • Issue Verifiable Credentials: Create PASETO v4 signed credentials with custom claims
  • Verify Credentials: Validate credential signatures and check revocation status
  • Create Presentations: Build holder-to-verifier presentations for secure credential sharing
  • Manage Wallets: Store credentials securely in encrypted wallets

Base URL

Section titled “Base URL”

All API requests should be made to:

https://api.veriglob.com

For local development: (still in beta)

https://staging.veriglob.com

Response Format

Section titled “Response Format”

Success Response

Section titled “Success Response”

All successful API responses follow this structure:

{
  "status": "success",
  "message": "Human readable message",
  "data": {
    // endpoint-specific response data
  }
}

Error Response

Section titled “Error Response”

Error responses follow this structure:

{
  "status": "error",
  "message": "Error category",
  "error": "Detailed error message"
}

API Versioning

Section titled “API Versioning”

The API is versioned using URL path versioning. The current version is v1:

/v1/did
/v1/credentials
/v1/presentations

Supported Protocols

Section titled “Supported Protocols”

The API supports both HTTP and HTTPS protocols. We strongly recommend using HTTPS in production environments.

Content Types

Section titled “Content Types”

All requests and responses use JSON format:

  • Request Content-Type: application/json
  • Response Content-Type: application/json

Next Steps

Section titled “Next Steps”