> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get my badge

> Read the Trust Badge for a vendor you own.

Returns the Trust Badge record for one of your vendors.

## Query parameters

<ParamField query="vendorId" type="string" required>
  The vendor (company) ID you own.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/trust-badge/my-badge?vendorId=cmp_..." \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "vendorId": "cmp_...",
      "customerId": "usr_...",
      "status": "active",
      "score": 90,
      "badgeToken": "eyJ...",
      "issuedAt": "2026-05-12T00:00:00Z",
      "revokedAt": null,
      "expiresAt": "2026-08-10T00:00:00Z"
    }
  }
  ```
</ResponseExample>

When no badge exists for the vendor, the endpoint returns `404`:

```json theme={null}
{
  "success": false,
  "message": "No trust badge found for this vendor."
}
```

## Response fields

<ResponseField name="success" type="boolean" />

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="vendorId" type="string" />

    <ResponseField name="customerId" type="string" />

    <ResponseField name="status" type="string">
      One of `active`, `revoked`, `expired`.
    </ResponseField>

    <ResponseField name="score" type="number" />

    <ResponseField name="badgeToken" type="string | null">
      The badge JWT. `null` unless `status` is `active`.
    </ResponseField>

    <ResponseField name="issuedAt" type="string" />

    <ResponseField name="revokedAt" type="string | null">
      Timestamp the badge was revoked, or `null`.
    </ResponseField>

    <ResponseField name="expiresAt" type="string" />
  </Expandable>
</ResponseField>