How to Authenticate with the VerseDB API

Creating Your API Token

To use authenticated endpoints, you'll need an API token tied to your VerseDB account.

1. Go to https://versedb.com/user/api-tokens
2. Enter a name for your token.
3. Select the permissions you need (e.g., read:self, lists:collection, lists:pullist).
4. Click Create.
5. Copy and store your token — you won’t be able to view it again.

Permission Types

When creating a token, you can select permissions based on what you need:

• read:public – Public data (required for most requests)
• read:self – Your user profile
• lists:follow – Follow/unfollow titles
• lists:collection – View/edit your collection
• lists:wishlist – View/edit your wishlist
• lists:pulllist – Manage your pull list
• lists:read – View your read status

Using the Token

All authenticated requests require the token to be passed in the Authorization header:

Authorization: Bearer your-api-token

Example Request

GET /api/user/collections  
Authorization: Bearer sk_test_123456789abcdef

Example Response

[
  {
    "id": 1,
    "name": "Main Collection",
    "items": [...]
  }
]

API Security Tips

• Never expose your token publicly
• Don’t commit it to version control (GitHub, etc.)
• Rotate your token periodically
• Delete unused tokens right from the dashboard