API Documentation

Integrate webMOBI certificates and badges into your applications

Authentication

All API requests require authentication using a Bearer token. You can obtain your API key from the Settings page.

curl -X GET https://certificates.webmobi.com/api/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Keep your API key secure. Never expose it in client-side code or public repositories.

Base URL

https://certificates.webmobi.com/api

API Endpoints

Certificates

GET/certificates

List all certificates for your tenant

POST/certificates/generate

Generate a new certificate

GET/certificates/verify

Verify a certificate by its ID

Digital Badges

GET/badge-classes

List all badge classes (templates)

POST/badges/issue

Issue a badge to a recipient

POST/badges/bulk-issue

Issue badges to multiple recipients

GET/my-badges

Get badges for the authenticated user

Batches

GET/batches

List all certificate batches

POST/batches

Create a new batch

GET/batches/:batchId

Get batch details

POST/batches/:batchId/items

Add recipients to a batch

Templates

GET/templates

List all certificate templates

GET/templates/:id

Get template details

Rate Limits

API requests are rate limited based on your subscription plan:

Plan	Requests/Minute
Free	60
Professional	300
Enterprise	1000

Example: Issue a Badge

curl -X POST https://certificates.webmobi.com/api/badges/issue \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "badge_class_id": "uuid-of-badge-class",
    "recipient_email": "recipient@example.com",
    "recipient_name": "John Doe",
    "evidence_url": "https://example.com/achievement",
    "expires_at": "2025-12-31T23:59:59Z"
  }'

Response

{
  "success": true,
  "data": {
    "id": "badge-assertion-uuid",
    "badge_class_id": "uuid-of-badge-class",
    "recipient_email": "recipient@example.com",
    "issued_at": "2024-01-15T10:30:00Z",
    "verification_url": "https://certificates.webmobi.com/verify/badge/..."
  }
}

Need API Support?

Our team can help you with API integration and custom solutions.

Contact API Support