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.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vouchmark","description":"Verify Nigerian businesses, monitor counterparty risk, and prove trust on the web.","colors":{"primary":"#6466AE","light":"#8B8DC4","dark":"#45478B"},"logo":{"light":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c","dark":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c","href":"https://vouchmark.com"},"favicon":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/favicon.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=8ce46c42758c5a8875f8efd3bb924904","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"mailto:support@vouchmark.com","label":"Support"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://vouchmark.com"}},"footer":{"socials":{"x":"https://x.com/vouchmark","linkedin":"https://www.linkedin.com/company/vouchmark"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://vouchmark.com"},{"anchor":"Status","icon":"signal-bars","href":"https://status.vouchmark.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@vouchmark.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vouchmark","hasAudioNarration":false,"actualSubdomain":"vouchmark","customDomains":["docs.vouchmark.com"],"gitSource":{"type":"github","owner":"vouchmark-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae43def63718976c0ca212b","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Documentation","count":21},{"language":"default","tag":"Verifications","count":15},{"language":"default","tag":"Onboarding (KYB)","count":13},{"language":"default","tag":"Monitoring","count":9},{"language":"default","tag":"Vouch AI","count":9},{"language":"default","tag":"Core concepts","count":9},{"language":"default","tag":"Compliance","count":7},{"language":"default","tag":"Wallet \u0026 Billing","count":7},{"language":"default","tag":"Developers","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/trust-badge/verify","slug":"/api-reference/trust-badge/verify","pageMetadata":{"title":"Verify a badge token","api":"GET /v1/trust-badge/verify","description":"Public endpoint to confirm a Trust Badge.","href":"/api-reference/trust-badge/verify"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Public endpoint to confirm a Trust Badge.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Verifies a badge token. `,_jsx(_components.strong,{children:`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.`]}),`\n`,_jsxs(_components.p,{children:[`Always returns `,_jsx(_components.code,{children:`200 OK`}),`. Inspect `,_jsx(_components.code,{children:`data.valid`}),` to tell whether the badge is genuine.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`token`,type:`string`,required:true,id:`param-token`,children:_jsx(_components.p,{children:`The badge JWT token.`})}),`\n`,`\n`,`\n`,_jsxs(_components.p,{children:[`When the badge cannot be verified, `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`false`}),` with a `,_jsx(_components.code,{children:`reason`}),`, and most other fields are omitted:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"valid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vendorId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cmp_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"revoked\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Badge has been revoked.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`data`,children:[_jsx(ResponseField,{name:`valid`,type:`boolean`,id:`param-valid`,children:_jsx(_components.p,{children:`Whether the badge is genuine and currently active.`})}),_jsx(ResponseField,{name:`vendorId`,type:`string`,id:`param-vendor-id`,children:_jsx(_components.p,{children:`Present when the token decoded to a known badge. Omitted on signature failure.`})}),_jsx(ResponseField,{name:`customerId`,type:`string`,id:`param-customer-id`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`score`,type:`number`,id:`param-score`,children:_jsxs(_components.p,{children:[`Trust score. Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Badge status. One of `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`revoked`}),`, `,_jsx(_components.code,{children:`expired`}),`.`]})}),_jsx(ResponseField,{name:`issuedAt`,type:`string`,id:`param-issued-at`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`expiresAt`,type:`string`,id:`param-expires-at`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`reason`,type:`string`,id:`param-reason`,children:_jsxs(_components.p,{children:[`Human-readable explanation. Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`false`}),`. Example values: `,_jsx(_components.code,{children:`Invalid or expired badge token.`}),`, `,_jsx(_components.code,{children:`No badge record found for this vendor.`}),`, `,_jsx(_components.code,{children:`Badge has been revoked.`}),`, `,_jsx(_components.code,{children:`Badge token has been superseded.`}),`, `,_jsx(_components.code,{children:`Badge has expired.`})]})})]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Verify a badge token","api":"GET /v1/trust-badge/verify","description":"Public endpoint to confirm a Trust Badge.","href":"/api-reference/trust-badge/verify"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Verifies a badge token. `,_jsx(_components.strong,{children:`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.`]}),`\n`,_jsxs(_components.p,{children:[`Always returns `,_jsx(_components.code,{children:`200 OK`}),`. Inspect `,_jsx(_components.code,{children:`data.valid`}),` to tell whether the badge is genuine.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`token`,type:`string`,required:true,id:`param-token`,children:_jsx(_components.p,{children:`The badge JWT token.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vouchmark.com/v1/trust-badge/verify?token=eyJhbGciOiJIUzI1NiIs...\"`})]}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"valid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vendorId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cmp_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customerId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"usr_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`90`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"issuedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-12T00:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-10T00:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsxs(_components.p,{children:[`When the badge cannot be verified, `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`false`}),` with a `,_jsx(_components.code,{children:`reason`}),`, and most other fields are omitted:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"valid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vendorId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cmp_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"revoked\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Badge has been revoked.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`data`,children:[_jsx(ResponseField,{name:`valid`,type:`boolean`,id:`param-valid`,children:_jsx(_components.p,{children:`Whether the badge is genuine and currently active.`})}),_jsx(ResponseField,{name:`vendorId`,type:`string`,id:`param-vendor-id`,children:_jsx(_components.p,{children:`Present when the token decoded to a known badge. Omitted on signature failure.`})}),_jsx(ResponseField,{name:`customerId`,type:`string`,id:`param-customer-id`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`score`,type:`number`,id:`param-score`,children:_jsxs(_components.p,{children:[`Trust score. Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Badge status. One of `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`revoked`}),`, `,_jsx(_components.code,{children:`expired`}),`.`]})}),_jsx(ResponseField,{name:`issuedAt`,type:`string`,id:`param-issued-at`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`expiresAt`,type:`string`,id:`param-expires-at`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})}),_jsx(ResponseField,{name:`reason`,type:`string`,id:`param-reason`,children:_jsxs(_components.p,{children:[`Human-readable explanation. Present only when `,_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`false`}),`. Example values: `,_jsx(_components.code,{children:`Invalid or expired badge token.`}),`, `,_jsx(_components.code,{children:`No badge record found for this vendor.`}),`, `,_jsx(_components.code,{children:`Badge has been revoked.`}),`, `,_jsx(_components.code,{children:`Badge token has been superseded.`}),`, `,_jsx(_components.code,{children:`Badge has expired.`})]})})]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Verify a badge token","api":"GET /v1/trust-badge/verify","description":"Public endpoint to confirm a Trust Badge.","href":"/api-reference/trust-badge/verify"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Query parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response fields","slug":"response-fields","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"1\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.vouchmark.com/v1/trust-badge/verify?token=eyJhbGciOiJIUzI1NiIs...\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"valid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vendorId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"cmp_...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"customerId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"usr_...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"score\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">90\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"active\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"issuedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-05-12T00:00:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expiresAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-10T00:00:00Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Verify a badge token","path":"/v1/trust-badge/verify","method":"get","request":{"security":[],"parameters":{"query":{"token":{"schema":[{"type":"string","description":"The badge JWT token.","required":true}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"success":[{"type":"boolean"}],"data":[{"type":"object","properties":{"valid":[{"type":"boolean","description":"Whether the badge is genuine and currently active."}],"vendorId":[{"type":"string","description":"Present when the token decoded to a known badge. Omitted on signature failure."}],"customerId":[{"type":"string","description":"Present only when `valid` is `true` ."}],"score":[{"type":"number","description":"Trust score. Present only when `valid` is `true` ."}],"status":[{"type":"string","description":"Badge status. One of `active` , `revoked` , `expired` ."}],"issuedAt":[{"type":"string","description":"Present only when `valid` is `true` ."}],"expiresAt":[{"type":"string","description":"Present only when `valid` is `true` ."}],"reason":[{"type":"string","description":"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.`"}]}}]}}],"examples":{"example":{"value":{"success":true,"data":{"valid":true,"vendorId":"\u003cstring>","customerId":"\u003cstring>","score":123,"status":"\u003cstring>","issuedAt":"\u003cstring>","expiresAt":"\u003cstring>","reason":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"vouchmark","siteName":"Vouchmark","title":"Verify a badge token - Vouchmark","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-27T22:42:33.903Z","originalFileLocation":"api-reference/trust-badge/verify.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Public endpoint to confirm a Trust Badge.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vouchmark\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Verify a badge token - Vouchmark\">\u003cmeta data-mint-head property=\"og:description\" content=\"Public endpoint to confirm a Trust Badge.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vouchmark\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vouchmark.com/api-reference/trust-badge/verify\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vouchmark.mintlify.site/_mintlify/api/og/v2?division=Trust+Badge\u0026amp;title=Verify+a+badge+token\u0026amp;description=Public+endpoint+to+confirm+a+Trust+Badge.\u0026amp;theme=537dc3d63a6ec063e2d1a23f\u0026amp;signature=5816dafcf51fd30c24c8783c30feda30c6dd055bfef95def6f3605f4a17955fd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Verify a badge token - Vouchmark\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Public endpoint to confirm a Trust Badge.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vouchmark.mintlify.site/_mintlify/api/og/v2?division=Trust+Badge\u0026amp;title=Verify+a+badge+token\u0026amp;description=Public+endpoint+to+confirm+a+Trust+Badge.\u0026amp;theme=537dc3d63a6ec063e2d1a23f\u0026amp;signature=5816dafcf51fd30c24c8783c30feda30c6dd055bfef95def6f3605f4a17955fd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vouchmark\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6466AE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vouchmark.com/api-reference/trust-badge/verify\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/trust-badge/verify.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vouchmark.com/#organization\",\"name\":\"Vouchmark\",\"url\":\"https://docs.vouchmark.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vouchmark.com#website\",\"name\":\"Vouchmark\",\"url\":\"https://docs.vouchmark.com\",\"publisher\":{\"@id\":\"https://docs.vouchmark.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify#webpage\",\"url\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify\",\"name\":\"Verify a badge token\",\"description\":\"Public endpoint to confirm a Trust Badge.\",\"dateModified\":\"2026-06-27T22:42:33.903Z\",\"isPartOf\":{\"@id\":\"https://docs.vouchmark.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vouchmark\",\"item\":\"https://docs.vouchmark.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Verify a badge token\",\"item\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify#apireference\",\"headline\":\"Verify a badge token\",\"name\":\"Verify a badge token\",\"description\":\"Public endpoint to confirm a Trust Badge.\",\"url\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vouchmark.com/api-reference/trust-badge/verify#webpage\"},\"dateModified\":\"2026-06-27T22:42:33.903Z\",\"publisher\":{\"@id\":\"https://docs.vouchmark.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vouchmark.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vouchmark\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vouchmark\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/trust-badge/verify.md","siteName":"Vouchmark","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://vouchmark.com"},{"anchor":"Status","icon":"signal-bars","href":"https://status.vouchmark.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@vouchmark.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/api-reference/introduction"}]},{"group":"Auth","pages":[{"title":"Sign up","api":"POST /v1/signup","href":"/api-reference/auth/signup"},{"title":"Log in","api":"POST /v1/login","href":"/api-reference/auth/login"},{"title":"Refresh token","api":"POST /v1/refresh-token","href":"/api-reference/auth/refresh-token"},{"title":"Log out","api":"POST /v1/logout","href":"/api-reference/auth/logout"}]},{"group":"Companies","pages":[{"title":"List my companies","api":"GET /v1/dashboard/my-companies","href":"/api-reference/companies/list"},{"title":"Get a company","api":"GET /v1/dashboard/company-details?companyId={companyId}","href":"/api-reference/companies/get"},{"title":"Edit a company","api":"POST /v1/edit-company/{companyId}","href":"/api-reference/companies/edit"},{"title":"Resolve FIRS TIN","api":"POST /v1/check-firstin","href":"/api-reference/companies/check-firs-tin"}]},{"group":"Verifications","pages":[{"title":"Verify TIN (upload TCC)","api":"POST /v1/verifyTin","href":"/api-reference/verifications/verify-tin"},{"title":"Verify JTB TIN","api":"POST /v1/verifyJtbTin","href":"/api-reference/verifications/verify-jtb-tin"},{"title":"Verify utility bill","api":"POST /v1/verifyBill","href":"/api-reference/verifications/verify-bill"},{"title":"Verify utility bill (image)","api":"POST /v1/verify-utility-bill/image","href":"/api-reference/verifications/verify-bill-image"},{"title":"Verify utility bill (manual)","api":"POST /v1/verify-utility-bill/manual","href":"/api-reference/verifications/verify-bill-manual"},{"title":"Verify CAC documents","api":"POST /v1/verifyCacAndReport","href":"/api-reference/verifications/verify-cac"},{"title":"Verify one CAC document","api":"POST /v1/verifyCacDocument","href":"/api-reference/verifications/verify-cac-document"},{"title":"Get CAC verification status","api":"GET /v1/cacVerificationStatus/{companyId}","href":"/api-reference/verifications/cac-status"},{"title":"Check verification progress","api":"POST /v1/checkVerificationProgress","href":"/api-reference/verifications/check-progress"},{"title":"Physical address verification","api":"POST /v1/physicalAddress","href":"/api-reference/verifications/physical-address"}]},{"group":"Onboarding (KYB)","pages":[{"title":"Module catalog","api":"GET /v1/kyb/modules","href":"/api-reference/onboarding/module-catalog"},{"title":"List widgets","api":"GET /v1/kyb/widgets","href":"/api-reference/onboarding/list-widgets"},{"title":"Create widget","api":"POST /v1/kyb/widgets","href":"/api-reference/onboarding/create-widget"},{"title":"Get widget","api":"GET /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/get-widget"},{"title":"Update widget","api":"PATCH /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/update-widget"},{"title":"Set widget status","api":"PATCH /v1/kyb/widgets/{id}/status","href":"/api-reference/onboarding/set-widget-status"},{"title":"Delete widget","api":"DELETE /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/delete-widget"},{"title":"Widget cost estimate","api":"GET /v1/kyb/widgets/{id}/estimate","href":"/api-reference/onboarding/cost-estimate"},{"title":"List applicants","api":"GET /v1/kyb/applicants","href":"/api-reference/onboarding/list-applicants"},{"title":"Get applicant","api":"GET /v1/kyb/applicants/{applicantId}","href":"/api-reference/onboarding/get-applicant"},{"title":"Create applicant","api":"POST /v1/kyb/widgets/{id}/applicants","href":"/api-reference/onboarding/create-applicant"},{"title":"Run module","api":"POST /v1/kyb/applicants/{applicantId}/modules/{moduleId}/run","href":"/api-reference/onboarding/run-module"},{"title":"Submit applicant","api":"POST /v1/kyb/applicants/{applicantId}/submit","href":"/api-reference/onboarding/submit-applicant"}]},{"group":"Widget Embed (Runtime)","pages":[{"title":"Get embed config","api":"GET /v1/widget/embed/config","href":"/api-reference/onboarding/embed-config"},{"title":"Create embed session","api":"POST /v1/widget/embed/sessions","href":"/api-reference/onboarding/create-session"},{"title":"Resume embed session","api":"GET /v1/widget/embed/sessions/{sessionId}","href":"/api-reference/onboarding/resume-session"},{"title":"Save session answers","api":"PATCH /v1/widget/embed/sessions/{sessionId}/answers","href":"/api-reference/onboarding/save-answers"},{"title":"Upload session attachment","api":"POST /v1/widget/embed/sessions/{sessionId}/uploads","href":"/api-reference/onboarding/upload-attachment"},{"title":"Submit embed session","api":"POST /v1/widget/embed/sessions/{sessionId}/submit","description":"Submit a completed widget session for processing.","href":"/api-reference/onboarding/submit-session"}]},{"group":"Trust Badge","pages":[{"title":"Verify a badge token","api":"GET /v1/trust-badge/verify","href":"/api-reference/trust-badge/verify"},{"title":"Get my badge","api":"GET /v1/trust-badge/my-badge","description":"Read the Trust Badge for a vendor you own.","href":"/api-reference/trust-badge/my-badge"}]},{"group":"Monitoring","pages":[{"title":"List monitored vendors","api":"GET /v1/monitoring/vendors","href":"/api-reference/monitoring/list-vendors"},{"title":"Get vendor profile","api":"GET /v1/monitoring/vendors/{vendorId}","href":"/api-reference/monitoring/vendor-profile"},{"title":"List vendor events","api":"GET /v1/monitoring/vendors/{vendorId}/events","href":"/api-reference/monitoring/vendor-events"},{"title":"Vendor score history","api":"GET /v1/monitoring/vendors/{vendorId}/score-history","href":"/api-reference/monitoring/score-history"},{"title":"Media mentions","api":"GET /v1/monitoring/media-mentions","href":"/api-reference/monitoring/media-mentions"},{"title":"List alerts","api":"GET /v1/monitoring/alerts","href":"/api-reference/monitoring/alerts"},{"title":"Add to watchlist","api":"POST /v1/monitoring/vendors/watchlist","href":"/api-reference/monitoring/add-to-watchlist"},{"title":"Remove from watchlist","api":"DELETE /v1/monitoring/vendors/watchlist/{vendorId}","href":"/api-reference/monitoring/remove-from-watchlist"},{"title":"Get watchlist capacity","api":"GET /v1/monitoring/watchlist/capacity","href":"/api-reference/monitoring/watchlist-limits"}]},{"group":"Investigations","pages":[{"title":"List investigation reports","api":"GET /v1/investigation/reports","href":"/api-reference/investigations/list-reports"},{"title":"Get investigation report","api":"GET /v1/investigation/reports/{reportId}","href":"/api-reference/investigations/get-report"}]},{"group":"Disputes","pages":[{"title":"List disputes","api":"GET /v1/disputes","href":"/api-reference/disputes/list-disputes"},{"title":"Submit dispute","api":"POST /v1/disputes","href":"/api-reference/disputes/submit-dispute"},{"title":"Get dispute","api":"GET /v1/disputes/{disputeId}","href":"/api-reference/disputes/get-dispute"}]},{"group":"Vouch AI","pages":[{"title":"Start new chat","api":"POST /v1/chat/new","href":"/api-reference/vouch-ai/new-chat"},{"title":"Send message","api":"POST /v1/chat/{chatId}/message","href":"/api-reference/vouch-ai/send-message"},{"title":"Stream message","api":"POST /v1/chat/{chatId}/stream","href":"/api-reference/vouch-ai/stream-message"},{"title":"Chat history","api":"GET /v1/chat/history","href":"/api-reference/vouch-ai/chat-history"},{"title":"Get chat","api":"GET /v1/chat/{chatId}","href":"/api-reference/vouch-ai/get-chat"},{"title":"Rename chat","api":"PATCH /v1/chat/{chatId}/title","href":"/api-reference/vouch-ai/rename-chat"},{"title":"Delete chat","api":"DELETE /v1/chat/{chatId}","href":"/api-reference/vouch-ai/delete-chat"},{"title":"Quick chat","api":"POST /v1/chat/quick","href":"/api-reference/vouch-ai/quick-chat"},{"title":"AI company overview","api":"POST /v1/company/ai-overview","href":"/api-reference/vouch-ai/ai-overview"}]},{"group":"Compliance","pages":[{"title":"List obligations","api":"GET /v1/compliance/obligations","href":"/api-reference/compliance/list-obligations"},{"title":"Upcoming obligations","api":"GET /v1/compliance/obligations/upcoming","href":"/api-reference/compliance/upcoming"},{"title":"Create obligation","api":"POST /v1/compliance/obligations","href":"/api-reference/compliance/create-obligation"},{"title":"Update obligation","api":"PATCH /v1/compliance/obligations/{obligationId}","href":"/api-reference/compliance/update-obligation"},{"title":"Complete obligation","api":"POST /v1/compliance/obligations/{obligationId}/complete","href":"/api-reference/compliance/complete-obligation"},{"title":"Delete obligation","api":"DELETE /v1/compliance/obligations/{obligationId}","href":"/api-reference/compliance/delete-obligation"},{"title":"Seed obligations","api":"POST /v1/compliance/seed","href":"/api-reference/compliance/seed"}]},{"group":"Wallet \u0026 Billing","pages":[{"title":"Get wallet","api":"GET /v1/wallet","href":"/api-reference/wallet/get-wallet"},{"title":"List transactions","api":"GET /v1/wallet/transactions","href":"/api-reference/wallet/transactions"},{"title":"Top up wallet","api":"POST /v1/wallet/topup","href":"/api-reference/wallet/topup"},{"title":"Verify top-up","api":"GET /v1/wallet/topup/verify","href":"/api-reference/wallet/verify-topup"},{"title":"Update auto top-up","api":"PATCH /v1/wallet/auto-top-up","href":"/api-reference/wallet/auto-topup"},{"title":"Update threshold","api":"PATCH /v1/wallet/threshold","href":"/api-reference/wallet/threshold"},{"title":"Pricing rates","api":"GET /v1/wallet/pricing-rates","href":"/api-reference/wallet/pricing-rates"}]},{"group":"Developers","pages":[{"title":"List API keys","api":"GET /v1/developers/api-keys","href":"/api-reference/developers/list-api-keys"},{"title":"Rotate API key","api":"POST /v1/developers/api-keys/rotate","href":"/api-reference/developers/rotate-api-key"},{"title":"List webhooks","api":"GET /v1/developers/webhooks","href":"/api-reference/developers/list-webhooks"},{"title":"Create webhook","api":"POST /v1/developers/webhooks","href":"/api-reference/developers/create-webhook"},{"title":"Rotate webhook secret","api":"POST /v1/developers/webhooks/{id}/rotate-secret","href":"/api-reference/developers/rotate-webhook-secret"},{"title":"Delete webhook","api":"DELETE /v1/developers/webhooks/{id}","href":"/api-reference/developers/delete-webhook"}]}]}]},"basePath":"","title":"Verify a badge token - Vouchmark","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}