Exploring API Endpoints & Structure

Base URL

All API requests start with the base URL:

https://versedb.com/api

General URL Patterns

Comic Content Endpoints

GET /api/publishers
GET /api/publishers/{id}

GET /api/series
GET /api/series/{id}

GET /api/issues/{id}

POST   /api/titles/{id}/follow
DELETE /api/titles/{id}/follow

Note: A “series” refers to a volume of a title. A “title” represents all volumes/runs of a comic.

Creators & Characters

GET /api/creators
GET /api/creators/{id}
GET /api/creators/search

GET /api/characters
GET /api/characters/{id}
GET /api/characters/search

User Profile & Public Data

GET /api/users/{id}/profile
GET /api/users/{id}/collections

Note: Only public collections are visible here.

Personal User Data (Authenticated)

GET /api/user
GET /api/user/collections
GET /api/user/wishlists
GET /api/user/pull-list
GET /api/user/follows
GET /api/user/read-status

Collections (Authenticated)

GET    /api/user/collections
POST   /api/collections
PUT    /api/collections/{id}
DELETE /api/collections/{id}
POST   /api/collections/{id}/items
DELETE /api/collections/{collection_id}/items/{item_id}

Wishlists (Authenticated)

GET    /api/user/wishlists
POST   /api/wishlists
PUT    /api/wishlists/{id}
DELETE /api/wishlists/{id}
POST   /api/wishlists/{id}/items
DELETE /api/wishlists/{wishlist_id}/items/{item_id}

Pull Lists (Authenticated)

GET    /api/user/pull-list
POST   /api/pull-list/items
DELETE /api/pull-list/items/{id}

Read Status (Authenticated)

GET    /api/user/read-status
POST   /api/issues/{id}/read-status
DELETE /api/issues/{id}/read-status

Web Slugs vs API IDs

• Web: SEO-friendly slugs like /series/123-batman
• API: Always uses numeric IDs like /api/series/123

Multiple IDs in URLs

Some endpoints use both collection and item IDs:

/api/collections/{collection_id}/items/{item_id}
/api/wishlists/{wishlist_id}/items/{item_id}