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"
}
}
Trust Badge
Verify a badge token
Public endpoint to confirm a Trust Badge.
GET
/
v1
/
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
When the badge cannot be verified,
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"
}
}
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
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.