Note
All API endpoints require a Bearer token in the Authorization header. See Authentication & API Tokens for setup.
Comic Data (Free Tier)#
| Endpoint | Description |
|---|---|
GET /api/publishers, /api/publishers/{id} |
Publishers |
GET /api/titles, /api/titles/{id} |
Titles |
GET /api/series, /api/series/{id} |
Series |
GET /api/issues, /api/issues/{id} |
Issues |
GET /api/characters, /api/characters/{id} |
Characters |
GET /api/creators, /api/creators/{id} |
Creators |
GET /api/story-arcs, /api/story-arcs/{id} |
Story arcs |
GET /api/teams, /api/teams/{id} |
Teams |
GET /api/universes |
Universes |
GET /api/shops |
Comic shops |
GET /api/podcasts |
Podcasts |
Related Resources (PRO)#
Note
PRO-only endpoints return HTTP 402 for free users. Upgrade at versedb.com/subscription.
| Endpoint | Description |
|---|---|
GET /api/series/{id}/issues |
Issues in a series |
GET /api/series/{id}/creators |
Creators on a series |
GET /api/series/{id}/characters |
Characters in a series |
GET /api/issues/{id}/variants |
Issue variants |
GET /api/issues/{id}/creators |
Creators on an issue |
GET /api/issues/{id}/characters |
Characters in an issue |
GET /api/issues/{id}/market/listings |
Market listings |
GET /api/issues/{id}/market/snapshots |
Price history |
GET /api/issues/{id}/market/overview |
Market overview |
GET /api/teams/{id}/characters |
Team members |
GET /api/teams/{id}/series |
Team's series |
Your Account#
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/user |
Your profile |
| GET | /api/user/collections |
Your collection |
| GET | /api/user/pull-list |
Your pull list |
| GET | /api/user/follows |
What you follow |
| GET | /api/user/read-status |
Issues you've read |
| GET | /api/user/activity |
Your activity feed |
| GET | /api/user/achievements |
Unlocked achievements |
Lists#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/lists |
Create a list |
| PUT | /api/lists/{id} |
Update a list |
| DELETE | /api/lists/{id} |
Delete a list |
| POST | /api/lists/{id}/items |
Add an item |
| DELETE | /api/lists/{id}/items/{item} |
Remove an item |
| PUT | /api/lists/{id}/items/reorder |
Reorder items |
| POST/DELETE | /api/lists/{id}/save |
Save/unsave a public list |
| POST/DELETE | /api/lists/{id}/like |
Like/unlike a public list |
Pull List, Reading, Follows#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/pull-list/items |
Add a series |
| DELETE | /api/pull-list/items/{item} |
Remove a series |
| POST | /api/issues/{id}/read-status |
Mark as read |
| DELETE | /api/issues/{id}/read-status |
Mark as unread |
| POST | /api/follow |
Follow a title/character/podcast |
| DELETE | /api/follow/{type}/{id} |
Unfollow |
| GET | /api/follow/{type}/{id}/check |
Check follow status |
| PUT | /api/follow/{type}/{id}/preferences |
Update follow notification prefs |
Query Parameters#
| Parameter | Description | Default |
|---|---|---|
page |
Page number | 1 |
limit |
Items per page (max 50) | 20 |
q |
Search query | — |
Not Available via API#
Warning
These aren't exposed through the API:
- User registration and password management
- Content edit submissions, reviews, and reports
- Admin and moderation features
- Collection mutations (add/remove/update collection items — these are only in the mobile app API)