Note
**Authentication Required**
All endpoints require a Bearer token:
Authorization: Bearer YOUR_TOKEN
```</div>
</div>
---
## Comic Data (Free Tier)
<div class="field-list">
| 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 |
</div>
---
## PRO-Only Endpoints
<div class="callout callout-tip">
<div class="callout-header">
<svg class="callout-icon" viewBox="0 0 20 20" fill="currentColor"><path d="M11 3a1 1 0 10-2 0v1a1 1 0 102 0V3zM15.657 5.757a1 1 0 00-1.414-1.414l-.707.707a1 1 0 001.414 1.414l.707-.707zM18 10a1 1 0 01-1 1h-1a1 1 0 110-2h1a1 1 0 011 1zM5.05 6.464A1 1 0 106.464 5.05l-.707-.707a1 1 0 00-1.414 1.414l.707.707zM5 10a1 1 0 01-1 1H3a1 1 0 110-2h1a1 1 0 011 1zM8 16v-1h4v1a2 2 0 11-4 0zM12 14c.015-.34.208-.646.477-.859a4 4 0 10-4.954 0c.27.213.462.519.476.859h4.002z"/></svg>
<span class="callout-title">Tip</span>
</div>
<div class="callout-body">**PRO Subscription Required**
These endpoints return HTTP 402 for free users. Upgrade at versedb.com/subscription.</div>
</div>
<div class="field-list">
| 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 |
</div>
---
## User Data
<div class="field-list">
| 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 |
</div>
---
## Collections
<div class="field-list">
| 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 |
</div>
---
## User Lists
<div class="field-list">
| 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 |
</div>
---
## Pull List
<div class="field-list">
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/api/pull-list/items` | Add series |
| DELETE | `/api/pull-list/items/{id}` | Remove series |
</div>
---
## Read Status
<div class="field-list">
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/api/issues/{id}/read-status` | Mark as read |
| DELETE | `/api/issues/{id}/read-status` | Mark as unread |
</div>
---
## Following
<div class="field-list">
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/api/follow` | Follow entity |
| DELETE | `/api/follow/{type}/{id}` | Unfollow |
| GET | `/api/follow/{type}/{id}/check` | Check status |
</div>
---
## Query Parameters
<div class="field-list">
| Parameter | Description | Default |
|-----------|-------------|--------|
| `page` | Page number | 1 |
| `limit` | Items per page | 20 (max 50) |
| `q` | Search query | - |
</div>
---
## Not Available via API
<div class="callout callout-warning">
<div class="callout-header">
<svg class="callout-icon" viewBox="0 0 20 20" fill="currentColor"><path fill-rule="evenodd" d="M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/></svg>
<span class="callout-title">Warning</span>
</div>
<div class="callout-body">**Web-Only Features**
These features are not available through the API:
- User registration and password management
- Reviews and content submissions
- Reporting and admin features</div>
</div>
Articles