Create Your Token#
- Go to Settings > API Tokens
- Click Create New Token
- Name it (e.g., "My App")
- Select the scopes you need
- Click Create
- Copy immediately - you won't see it again
Use It in Requests#
Add the token to your Authorization header:
Authorization: Bearer your-token-here
cURL Example#
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://versedb.com/api/user
JavaScript Example#
fetch('https://versedb.com/api/user', {
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
})
Available Scopes#
| Scope | What It Does |
|---|---|
read:public |
Read comic data (series, issues, characters) |
read:self |
Read your profile |
lists:collection |
Manage collections |
lists:user_lists |
Manage user lists and wishlist |
lists:pulllist |
Manage pull list |
lists:read |
Track reading progress |
lists:follow |
Follow titles, characters, podcasts |
Test Your Token#
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://versedb.com/api/user
A successful response returns your profile. An error 401 means your token is invalid.
Security Reminders#
Warning
- Store tokens in environment variables
- Never commit tokens to git
- Revoke tokens you no longer use
- Create separate tokens for different apps
For more details, see Authentication & API Tokens.