Note
All endpoints require a Bearer token:
Authorization: Bearer YOUR_TOKEN
Comic Data (Free Tier)#
| Endpoint | Description |
|---|---|
GET /api/publishers |
List publishers |
GET /api/publishers/{id} |
Publisher details |
GET /api/titles |
List titles |
GET /api/titles/{id} |
Title details |
GET /api/series |
List series |
GET /api/series/{id} |
Series details |
GET /api/issues |
List issues |
GET /api/issues/{id} |
Issue details |
GET /api/characters |
List characters |
GET /api/characters/{id} |
Character details |
GET /api/creators |
List creators |
GET /api/creators/{id} |
Creator details |
GET /api/story-arcs |
List story arcs |
GET /api/story-arcs/{id} |
Story arc details |
GET /api/teams |
List teams |
GET /api/teams/{id} |
Team details |
GET /api/universes |
List universes |
GET /api/shops |
List comic shops |
GET /api/podcasts |
List podcasts |
PRO-Only Endpoints#
Note
These 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 |
User Data#
| Endpoint | Description |
|---|---|
GET /api/user |
Your profile |
GET /api/user/collections |
Your collections |
GET /api/user/lists |
Your lists |
GET /api/user/pull-list |
Your pull list |
GET /api/user/follows |
What you follow |
GET /api/user/read-status |
Your read issues |
Collections#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/collections |
Create collection |
| PUT | /api/collections/{id} |
Update collection |
| DELETE | /api/collections/{id} |
Delete collection |
| POST | /api/collections/{id}/items |
Add item |
| DELETE | /api/collections/{id}/items/{item} |
Remove item |
User Lists#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/lists |
Create list |
| PUT | /api/lists/{id} |
Update list |
| DELETE | /api/lists/{id} |
Delete list |
| POST | /api/lists/{id}/items |
Add item |
| DELETE | /api/lists/{id}/items/{item} |
Remove item |
Pull List#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/pull-list/items |
Add series |
| DELETE | /api/pull-list/items/{id} |
Remove series |
Read Status#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/issues/{id}/read-status |
Mark as read |
| DELETE | /api/issues/{id}/read-status |
Mark as unread |
Following#
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/follow |
Follow entity |
| DELETE | /api/follow/{type}/{id} |
Unfollow |
| GET | /api/follow/{type}/{id}/check |
Check status |
Query Parameters#
| Parameter | Description | Default |
|---|---|---|
page |
Page number | 1 |
limit |
Items per page | 20 (max 50) |
q |
Search query | - |
Not Available via API#
Warning
These features are not available through the API:
- User registration and password management
- Reviews and content submissions
- Reporting and admin features