Verify a badge token

curl "https://api.vouchmark.com/v1/trust-badge/verify?token=eyJhbGciOiJIUzI1NiIs..."

{
  "success": true,
  "data": {
    "valid": true,
    "vendorId": "cmp_...",
    "customerId": "usr_...",
    "score": 90,
    "status": "active",
    "issuedAt": "2026-05-12T00:00:00Z",
    "expiresAt": "2026-08-10T00:00:00Z"
  }
}

GET

trust-badge

verify

curl "https://api.vouchmark.com/v1/trust-badge/verify?token=eyJhbGciOiJIUzI1NiIs..."

{
  "success": true,
  "data": {
    "valid": true,
    "vendorId": "cmp_...",
    "customerId": "usr_...",
    "score": 90,
    "status": "active",
    "issuedAt": "2026-05-12T00:00:00Z",
    "expiresAt": "2026-08-10T00:00:00Z"
  }
}

Verifies a badge token. No authentication required — anyone can call it. The endpoint validates the JWT signature, confirms the badge is still active, and checks it hasn’t been superseded or expired. Always returns 200 OK. Inspect data.valid to tell whether the badge is genuine.

Query parameters

string

required

The badge JWT token.

curl "https://api.vouchmark.com/v1/trust-badge/verify?token=eyJhbGciOiJIUzI1NiIs..."

{
  "success": true,
  "data": {
    "valid": true,
    "vendorId": "cmp_...",
    "customerId": "usr_...",
    "score": 90,
    "status": "active",
    "issuedAt": "2026-05-12T00:00:00Z",
    "expiresAt": "2026-08-10T00:00:00Z"
  }
}

When the badge cannot be verified, valid is false with a reason, and most other fields are omitted:

{
  "success": true,
  "data": {
    "valid": false,
    "vendorId": "cmp_...",
    "status": "revoked",
    "reason": "Badge has been revoked."
  }
}

Response fields

boolean

object

Show data

boolean

Whether the badge is genuine and currently active.

string

Present when the token decoded to a known badge. Omitted on signature failure.

string

Present only when valid is true.

number

Trust score. Present only when valid is true.

string

Badge status. One of active, revoked, expired.

string

Present only when valid is true.

string

Present only when valid is true.

string

Human-readable explanation. Present only when valid is false. Example values: Invalid or expired badge token., No badge record found for this vendor., Badge has been revoked., Badge token has been superseded., Badge has expired.

Overview

Auth

Companies

Verifications

Onboarding (KYB)

Widget Embed (Runtime)

Trust Badge

Monitoring

Investigations

Disputes

Vouch AI

Compliance

Wallet & Billing

Developers

Verify a badge token

Query parameters

Response fields

​Query parameters

​Response fields

Query parameters

Response fields