Badges
GoValid uses a badge system to recognize user identity and achievements. Badges appear on verification pages, user profiles, and avatar overlays.
Badge Types
GoValid has two badge categories:
Identity Badges
Identity badges represent a user's verified role or status. They are assigned by GoValid staff and displayed as an overlay on the user's avatar.
| Badge | Description | How to Earn |
|---|---|---|
| Government | Official Government Institution account | Staff assigned |
| GoValid Staff | Official GoValid team member | Staff assigned |
| Provos | Community Trust & Safety team member | Staff assigned |
| Verified Business | Verified Business account | Staff assigned after institution verification |
| Verified User | Identity verified user | Staff assigned after personal verification |
Display: Identity badges appear as a small icon overlay on the bottom-right corner of the user's avatar on verification pages.
Priority: When a user has multiple identity badges, the highest priority badge is displayed. Users with multiple identity badges can select which one to show as primary.
| Badge | Priority |
|---|---|
| Government | 100 |
| GoValid Staff | 90 |
| Provos | 85 |
| Verified Business | 80 |
| Verified User | 70 |
Achievement Badges
Achievement badges are earned automatically through user activity and engagement on the platform. Users can feature their favorite achievement badges on their profile.
| Badge | Requirement |
|---|---|
| QR Novice | Generated your first QR code |
| QR Creator | Generated 10 QR codes |
| QR Master | Generated 500+ verified QR codes |
| First Scanner | Scanned your first QR code |
| Super Scanner | Scanned 100+ QR codes |
| Scanner Pro | Scanned 500+ QR codes |
| Verification Expert | Scanned 1000+ QR codes |
| Trust Builder | Received 50+ community endorsements (Trust Score 4.0+) |
| Community Leader | Top 10% trusted community member (Trust Score 4.8+) |
| Early Adopter | Active member for 365+ days |
| Viral Creator | Single QR code with 10,000+ scans |
| Earth Defender | 10+ trees adopted via Guardian Pledge |
| Forest Contributor | 10+ trees published for adoption |
| Animal Guardian | 10+ animals tracked |
| Herd Master | 50+ animals tracked |
| Vet Partner | 20+ third-party vet verifications completed |
Display: Achievement badges appear as small circular icons below the user's name on verification pages.
Featured Badge: Users can select one achievement badge to feature prominently on their profile.
How Badges Work
Badge Assignment
| Badge Type | Assignment Method |
|---|---|
| Identity | Assigned by staff only during verification |
| Achievement | Auto-assigned based on activity milestones |
Auto-Award Triggers
Achievement badges are checked and awarded automatically when:
- QR Generation: Creating QR codes triggers QR Novice, QR Creator, QR Master checks
- QR Scanning: Scanning QR codes triggers First Scanner, Super Scanner, Scanner Pro, Verification Expert checks
- Login: Logging in triggers Early Adopter check
- Tree Adoption: Adopting or publishing trees triggers Earth Defender, Forest Contributor checks
- Animal Tracking: Adding animals or completing vet verifications triggers Animal Guardian, Herd Master, Vet Partner checks
- Trust Votes: Receiving community trust votes triggers Trust Builder, Community Leader checks
Badge Display Priority
On verification pages and profiles, badges are displayed in this order:
- Primary Identity Badge - Shown on avatar overlay
- Featured Achievement Badge - User-selected, shown below name
- Other Achievement Badges - Additional earned badges
Managing Badges
Badges appear on your community profile and verification pages, showing identity status and earned achievements.
For Users
- View your earned badges in your community profile
- Select a primary identity badge (if you have multiple)
- Feature an achievement badge on your profile
- Track progress toward achievement badges in your dashboard
For Staff
- Assign identity badges via
/community/staff/user-badges/ - Manually assign achievement badges when needed
- Monitor badge distribution and user progress
Badge API
API Endpoints
Badges are available via the REST API at https://my.govalid.org/api/v1/docs/.
Get User Badges
curl https://my.govalid.org/api/v1/community/badges/ \
-H "Authorization: Bearer YOUR_API_KEY"
Response includes:
identity_badge: Badge shown on avatar overlayachievement_badges: Array of earned achievement badgesfeatured_badge: User-selected featured achievement badge
Related
- NexCommunity - Community features and trust system
- Verification Page - How badges appear on verification pages