Skip to content
VerseDB

Events

Endpoints for browsing comic conventions and store events.

List events.

GET/api/v1/events
Requires a token

Returns comic conventions and store events, paginated. Filter by type, time, place and format, and order with sort.

Query parameters

qstring

Search by event name, city or venue, tolerating small typos for upcoming events. Results are ordered by relevance unless sort is set.

Example: "comic-con"

typestring

Filter by type (convention or store_event).

Example: "convention"

upcomingboolean

Only show upcoming events.

Example: true

pastboolean

Only show past events.

Example: true

is_onlineboolean

Filter online/in-person events.

Example: false

is_fcbdboolean

Filter Free Comic Book Day events.

Example: true

country_codestring

Filter by country code.

Example: "US"

regionstring

Filter by region, matched exactly against the stored value. Use the values from /events/regions.

Example: "California"

weekendboolean

Only events running this Friday to Sunday.

Example: true

monthstring

Only events starting in this month, as YYYY-MM.

Example: "2026-07"

sortstring

One of date_asc, date_desc, name_asc, name_desc. Defaults to date_desc with past, date_asc otherwise; a q search without sort keeps relevance order.

Example: "date_desc"

limitinteger

Number of results per page (max 50).

Example: 20

pageinteger

Page number; meta.last_page says where the list ends.

Example: 1

languagesstring

Keep only these languages in the _i18n maps (comma-separated BCP 47 tags). No other field changes.

Example: "ja,ko"

Responses

200

Success

Headers: X-RateLimit-Limit, X-RateLimit-Remaining

dataarray of objectsrequired
data[].idintegerrequired

Example: 42

data[].slugstring or nullrequired

Example: "san-diego-comic-con-2026"

data[].namestring or nullrequired

Example: "San Diego Comic-Con 2026"

data[].name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data[].aliases_i18nobjectrequired

Alternative names per language.

data[].original_localestring or nullrequired

The language the entity is from, a BCP 47 tag.

Example: "en"

data[].typestring or nullrequired

convention or store_event.

Example: "convention"

data[].start_datestring or nullrequired

Example: "2026-07-23"

data[].end_datestring or nullrequired

Example: "2026-07-26"

data[].start_timestring or nullrequired

Example: "10:00:00"

data[].end_timestring or nullrequired

Example: "18:00:00"

data[].timezonestring or nullrequired

Example: "America/Los_Angeles"

data[].is_onlinebooleanrequired
data[].is_fcbdbooleanrequired
data[].statusstringrequired

scheduled, cancelled, postponed or moved_online.

Example: "scheduled"

data[].venue_namestring or nullrequired

Example: "San Diego Convention Center"

data[].citystring or nullrequired

Example: "San Diego"

data[].regionstring or nullrequired

Example: "California"

data[].country_codestring or nullrequired

Example: "US"

data[].full_locationstringrequired

Online Event for an online event, Location TBA when nothing is known.

Example: "San Diego Convention Center, San Diego, California, United States"

data[].logo_urlstring or nullrequired

Example: "https://...-tile_sm.webp"

data[].imagesobject or nullrequired
data[].images.tile_smstring

Example: "https://...-tile_sm.webp"

data[].images.full_mdstring

Example: "https://...-full_md.webp"

data[].images.full_lgstring

Example: "https://...-full_lg.webp"

data[].ticket_pricestring or nullrequired

Example: "USD $45.00 – $150.00"

data[].follower_countintegerrequired

Example: 320

linksobjectrequired
links.firststringrequired
links.laststringrequired
links.prevstring or nullrequired
links.nextstring or nullrequired
metaobjectrequired
meta.current_pageintegerrequired

Example: 1

meta.frominteger or nullrequired

Example: 1

meta.last_pageintegerrequired

Example: 25

meta.linksarray of objectsrequired
meta.links[].urlstring or nullrequired
meta.links[].labelstringrequired
meta.links[].pageinteger or null
meta.links[].activebooleanrequired
meta.pathstringrequired
meta.per_pageintegerrequired

Example: 20

meta.tointeger or nullrequired

Example: 20

meta.totalintegerrequired

Example: 500

401

Unauthenticated. The bearer token is missing, invalid, or revoked.

messagestringrequired

Example: "Unauthenticated."

Example body, from the documented examples

{
  "message": "Unauthenticated."
}
403

The token lacks the read:public ability.

messagestringrequired

Example: "Insufficient token scope."

Example body, from the documented examples

{
  "message": "Insufficient token scope."
}
429

Rate limit exceeded. This endpoint allows 300/hour (free) or 1,000/hour (PRO). Wait for the number of seconds in the Retry-After header before retrying.

Headers: Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining

messagestringrequired

Example: "Too Many Attempts."

Example body, from the documented examples

{
  "message": "Too Many Attempts."
}

Example request

curl --request GET \
  'https://versedb.com/api/v1/events' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": [
    {
      "id": 42,
      "slug": "san-diego-comic-con-2026",
      "name": "San Diego Comic-Con 2026",
      "name_i18n": {
        "ja": {
          "value": "講談社",
          "reading": "こうだんしゃ",
          "source": "madb"
        }
      },
      "aliases_i18n": {
        "en": [
          "Kodansha Comics"
        ]
      },
      "original_locale": "en",
      "type": "convention",
      "start_date": "2026-07-23",
      "end_date": "2026-07-26",
      "start_time": "10:00:00",
      "end_time": "18:00:00",
      "timezone": "America/Los_Angeles",
      "status": "scheduled",
      "venue_name": "San Diego Convention Center",
      "city": "San Diego",
      "region": "California",
      "country_code": "US",
      "full_location": "San Diego Convention Center, San Diego, California, United States",
      "logo_url": "https://...-tile_sm.webp",
      "images": {
        "tile_sm": "https://...-tile_sm.webp",
        "full_md": "https://...-full_md.webp",
        "full_lg": "https://...-full_lg.webp"
      },
      "ticket_price": "USD $45.00 – $150.00",
      "follower_count": 320
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 25,
    "per_page": 20,
    "to": 20,
    "total": 500
  }
}

Get an event.

GET/api/v1/events/{event_id}
Requires a token

Returns full event details including links, map data, guests, exclusives and attendees.

Path parameters

event_idintegerrequired

The event ID.

Example: 42

Query parameters

languagesstring

Keep only these languages in the _i18n maps (comma-separated BCP 47 tags). No other field changes.

Example: "ja,ko"

Responses

200

Success

Headers: X-RateLimit-Limit, X-RateLimit-Remaining

dataobjectrequired
data.idintegerrequired

Example: 42

data.slugstring or nullrequired

Example: "san-diego-comic-con-2026"

data.namestring or nullrequired

Example: "San Diego Comic-Con 2026"

data.name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data.aliases_i18nobjectrequired

Alternative names per language.

data.original_localestring or nullrequired

The language the entity is from, a BCP 47 tag.

Example: "en"

data.typestring or nullrequired

convention or store_event.

Example: "convention"

data.start_datestring or nullrequired

Example: "2026-07-23"

data.end_datestring or nullrequired

Example: "2026-07-26"

data.start_timestring or nullrequired

Example: "10:00:00"

data.end_timestring or nullrequired

Example: "18:00:00"

data.timezonestring or nullrequired

Example: "America/Los_Angeles"

data.is_onlinebooleanrequired
data.is_fcbdbooleanrequired
data.statusstringrequired

scheduled, cancelled, postponed or moved_online.

Example: "scheduled"

data.venue_namestring or nullrequired

Example: "San Diego Convention Center"

data.street_addressstring or nullrequired

Example: "111 W Harbor Dr"

data.citystring or nullrequired

Example: "San Diego"

data.regionstring or nullrequired

Example: "California"

data.postal_codestring or nullrequired

Example: "92101"

data.country_codestring or nullrequired

Example: "US"

data.latitudestring or nullrequired

Example: "32.70650000"

data.longitudestring or nullrequired

Example: "-117.16150000"

data.full_locationstringrequired

Online Event for an online event, Location TBA when nothing is known.

Example: "San Diego Convention Center, San Diego, California, United States"

data.google_maps_urlstring or nullrequired

Example: "https://www.google.com/maps/search/?api=1&query=32.70650000,-117.16150000"

data.logo_urlstring or nullrequired

Example: "https://...-full_lg.webp"

data.imagesobject or nullrequired
data.images.tile_smstring

Example: "https://...-tile_sm.webp"

data.images.full_mdstring

Example: "https://...-full_md.webp"

data.images.full_lgstring

Example: "https://...-full_lg.webp"

data.static_map_urlstring or null

Left out for an online event.

Example: "https://maps.googleapis.com/maps/api/staticmap?center=..."

data.event_urlstring or nullrequired

Example: "https://www.comic-con.org"

data.ticket_price_mininteger or nullrequired

Example: 4500

data.ticket_price_maxinteger or nullrequired

Example: 15000

data.ticket_currencystring or nullrequired

Example: "USD"

data.ticket_pricestring or nullrequired

Example: "USD $45.00 – $150.00"

data.follower_countintegerrequired

Example: 320

data.event_franchise_idinteger or nullrequired

Example: 12

data.storeobject

The hosting shop, for a store event; null fields once the shop is gone.

data.store.idinteger or nullrequired

Example: 7

data.store.namestring or nullrequired

Example: "Mission Comics"

data.creatorsarray of objectsrequired
data.creators[].idintegerrequired

Example: 7

data.creators[].namestring or nullrequired

Example: "Stan Lee"

data.creators[].slugstring or nullrequired

Example: "stan-lee"

data.creators[].photo_urlstring or nullrequired

Example: "https://...-profile_md.webp"

data.creators[].imagesobject or nullrequired
data.creators[].images.tile_smstring

Example: "https://...-tile_sm.webp"

data.creators[].images.profile_mdstring

Example: "https://...-profile_md.webp"

data.creators[].images.full_lgstring

Example: "https://...-full_lg.webp"

data.creators[].countrystring or nullrequired

Example: "US"

data.creators[].appearance_typesarray of stringsrequired

Example: ["Guest","Signing"]

data.issuesarray of objectsrequired
data.issues[].idintegerrequired

Example: 5432

data.issues[].slugstring or nullrequired

Example: "amazing-spider-man-1"

data.issues[].series_idinteger or nullrequired

Example: 123

data.issues[].issue_numberstring or nullrequired

Example: "1"

data.issues[].namestring or nullrequired

Example: "The Chameleon Strikes!"

data.issues[].cover_datestring or nullrequired

Example: "2018-09-01"

data.issues[].release_datestring or nullrequired

Example: "2018-07-11"

data.issues[].foc_datestring or nullrequired

Example: "2018-06-18"

data.issues[].is_unreleasedbooleanrequired
data.issues[].cover_urlstring or nullrequired

Example: "https://...-cover_lg.webp"

data.issues[].imagesobject or nullrequired
data.issues[].images.thumbstring

Example: "https://...-thumb.webp"

data.issues[].images.cover_smstring

Example: "https://...-cover_sm.webp"

data.issues[].images.cover_mdstring

Example: "https://...-cover_md.webp"

data.issues[].images.cover_lgstring

Example: "https://...-cover_lg.webp"

data.issues[].is_reprintbooleanrequired
data.issues[].content_rating_labelstring or nullrequired

Example: "Teen"

data.issues[].min_ageinteger or nullrequired

Example: 13

data.issues[].is_nsfwbooleanrequired
data.issues[].average_ratingnumber or nullrequired

Example: 4.5

data.issues[].name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data.issues[].seriesobject or null
data.issues[].series.idintegerrequired

Example: 123

data.issues[].series.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.issues[].series.slugstring or nullrequired

Example: "the-amazing-spider-man-2018"

data.issues[].series.start_yearinteger or nullrequired

Example: 2018

data.issues[].series.end_yearinteger or nullrequired

Example: 2022

data.issues[].series.volume_numberinteger or nullrequired

Example: 5

data.issues[].series.publication_typestring or nullrequired

Example: "regular_series"

data.issues[].series.formatstring or nullrequired

Example: "Standard"

data.issues[].series.cached_issues_countinteger or nullrequired

Example: 93

data.issues[].series.cover_urlstring or nullrequired

Example: "https://...-cover_lg.webp"

data.issues[].series.imagesobject or nullrequired
data.issues[].series.images.cover_smstring

Example: "https://...-cover_sm.webp"

data.issues[].series.images.cover_mdstring

Example: "https://...-cover_md.webp"

data.issues[].series.images.cover_lgstring

Example: "https://...-cover_lg.webp"

data.issues[].series.publisher_namestring or nullrequired

Example: "Marvel"

data.issues[].pivot_issue_ordernull or nullrequired
data.issues[].pivot_is_prologuebooleanrequired
data.issues[].pivot_is_epiloguebooleanrequired
data.issues[].pivot_is_tie_inbooleanrequired
data.issue_variantsarray of objectsrequired
data.issue_variants[].idintegerrequired

Example: 901

data.issue_variants[].issue_idinteger or nullrequired

Example: 5432

data.issue_variants[].variant_namestring or nullrequired

Example: "Cover B"

data.issue_variants[].cover_urlstring or nullrequired

Example: "https://...-cover_lg.webp"

data.issue_variants[].imagesobject or nullrequired
data.issue_variants[].images.thumbstring

Example: "https://...-thumb.webp"

data.issue_variants[].images.cover_smstring

Example: "https://...-cover_sm.webp"

data.issue_variants[].images.cover_mdstring

Example: "https://...-cover_md.webp"

data.issue_variants[].images.cover_lgstring

Example: "https://...-cover_lg.webp"

data.issue_variants[].variant_typestring or nullrequired

Example: "standard"

data.issue_variants[].ratiostring or nullrequired

Example: "1:25"

data.issue_variants[].pricestring or nullrequired

Example: "4.99"

data.issue_variants[].currency_codestring or nullrequired

Example: "USD"

data.issue_variants[].formatted_pricestring or nullrequired

Example: "$4.99"

data.issue_variants[].eanstring or nullrequired

Example: "75960609999300111"

data.issue_variants[].is_nsfwboolean or nullrequired
data.issue_variants[].variant_name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data.attendees_previewobjectrequired
data.attendees_preview.totalintegerrequired

Example: 320

data.attendees_preview.usersarray of objectsrequired
data.attendees_preview.users[].idintegerrequired

Example: 1024

data.attendees_preview.users[].usernamestring or nullrequired

Example: "comic_fan_42"

data.attendees_preview.users[].namestring or nullrequired

Example: "comic_fan_42"

data.attendees_preview.users[].profile_image_urlstring or nullrequired

Example: "https://...-profile_md.webp"

data.attendees_preview.users[].is_privatebooleanrequired
data.related_eventsarray of objectsrequired
data.related_events[].idintegerrequired

Example: 42

data.related_events[].slugstring or nullrequired

Example: "san-diego-comic-con-2026"

data.related_events[].namestring or nullrequired

Example: "San Diego Comic-Con 2026"

data.related_events[].name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data.related_events[].aliases_i18nobjectrequired

Alternative names per language.

data.related_events[].original_localestring or nullrequired

The language the entity is from, a BCP 47 tag.

Example: "en"

data.related_events[].typestring or nullrequired

convention or store_event.

Example: "convention"

data.related_events[].start_datestring or nullrequired

Example: "2026-07-23"

data.related_events[].end_datestring or nullrequired

Example: "2026-07-26"

data.related_events[].start_timestring or nullrequired

Example: "10:00:00"

data.related_events[].end_timestring or nullrequired

Example: "18:00:00"

data.related_events[].timezonestring or nullrequired

Example: "America/Los_Angeles"

data.related_events[].is_onlinebooleanrequired
data.related_events[].is_fcbdbooleanrequired
data.related_events[].statusstringrequired

scheduled, cancelled, postponed or moved_online.

Example: "scheduled"

data.related_events[].venue_namestring or nullrequired

Example: "San Diego Convention Center"

data.related_events[].citystring or nullrequired

Example: "San Diego"

data.related_events[].regionstring or nullrequired

Example: "California"

data.related_events[].country_codestring or nullrequired

Example: "US"

data.related_events[].full_locationstringrequired

Online Event for an online event, Location TBA when nothing is known.

Example: "San Diego Convention Center, San Diego, California, United States"

data.related_events[].logo_urlstring or nullrequired

Example: "https://...-tile_sm.webp"

data.related_events[].imagesobject or nullrequired
data.related_events[].images.tile_smstring

Example: "https://...-tile_sm.webp"

data.related_events[].images.full_mdstring

Example: "https://...-full_md.webp"

data.related_events[].images.full_lgstring

Example: "https://...-full_lg.webp"

data.related_events[].ticket_pricestring or nullrequired

Example: "USD $45.00 – $150.00"

data.related_events[].follower_countintegerrequired

Example: 320

401

Unauthenticated. The bearer token is missing, invalid, or revoked.

messagestringrequired

Example: "Unauthenticated."

Example body, from the documented examples

{
  "message": "Unauthenticated."
}
403

The token lacks the read:public ability.

messagestringrequired

Example: "Insufficient token scope."

Example body, from the documented examples

{
  "message": "Insufficient token scope."
}
404

An archived event.

messagestringrequired

Example: ""

Example body, from the documented examples

{
  "message": ""
}
429

Rate limit exceeded. This endpoint allows 300/hour (free) or 1,000/hour (PRO). Wait for the number of seconds in the Retry-After header before retrying.

Headers: Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining

messagestringrequired

Example: "Too Many Attempts."

Example body, from the documented examples

{
  "message": "Too Many Attempts."
}

Example request

curl --request GET \
  'https://versedb.com/api/v1/events/42' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 42,
    "slug": "san-diego-comic-con-2026",
    "name": "San Diego Comic-Con 2026",
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    },
    "aliases_i18n": {
      "en": [
        "Kodansha Comics"
      ]
    },
    "original_locale": "en",
    "type": "convention",
    "start_date": "2026-07-23",
    "end_date": "2026-07-26",
    "start_time": "10:00:00",
    "end_time": "18:00:00",
    "timezone": "America/Los_Angeles",
    "status": "scheduled",
    "venue_name": "San Diego Convention Center",
    "street_address": "111 W Harbor Dr",
    "city": "San Diego",
    "region": "California",
    "postal_code": "92101",
    "country_code": "US",
    "latitude": "32.70650000",
    "longitude": "-117.16150000",
    "full_location": "San Diego Convention Center, San Diego, California, United States",
    "google_maps_url": "https://www.google.com/maps/search/?api=1&query=32.70650000,-117.16150000",
    "logo_url": "https://...-full_lg.webp",
    "images": {
      "tile_sm": "https://...-tile_sm.webp",
      "full_md": "https://...-full_md.webp",
      "full_lg": "https://...-full_lg.webp"
    },
    "static_map_url": "https://maps.googleapis.com/maps/api/staticmap?center=...",
    "event_url": "https://www.comic-con.org",
    "ticket_price_min": 4500,
    "ticket_price_max": 15000,
    "ticket_currency": "USD",
    "ticket_price": "USD $45.00 – $150.00",
    "follower_count": 320,
    "event_franchise_id": 12,
    "store": {
      "id": 7,
      "name": "Mission Comics"
    },
    "creators": [
      {
        "id": 7,
        "name": "Stan Lee",
        "slug": "stan-lee",
        "photo_url": "https://...-profile_md.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "country": "US",
        "appearance_types": [
          "Guest",
          "Signing"
        ]
      }
    ],
    "issues": [
      {
        "id": 5432,
        "slug": "amazing-spider-man-1",
        "series_id": 123,
        "issue_number": "1",
        "name": "The Chameleon Strikes!",
        "cover_date": "2018-09-01",
        "release_date": "2018-07-11",
        "foc_date": "2018-06-18",
        "cover_url": "https://...-cover_lg.webp",
        "images": {
          "thumb": "https://...-thumb.webp",
          "cover_sm": "https://...-cover_sm.webp",
          "cover_md": "https://...-cover_md.webp",
          "cover_lg": "https://...-cover_lg.webp"
        },
        "content_rating_label": "Teen",
        "min_age": 13,
        "average_rating": 4.5,
        "name_i18n": {
          "ja": {
            "value": "講談社",
            "reading": "こうだんしゃ",
            "source": "madb"
          }
        },
        "series": {
          "id": 123,
          "name": "The Amazing Spider-Man",
          "slug": "the-amazing-spider-man-2018",
          "start_year": 2018,
          "end_year": 2022,
          "volume_number": 5,
          "publication_type": "regular_series",
          "format": "Standard",
          "cached_issues_count": 93,
          "cover_url": "https://...-cover_lg.webp",
          "images": {
            "cover_sm": "https://...-cover_sm.webp",
            "cover_md": "https://...-cover_md.webp",
            "cover_lg": "https://...-cover_lg.webp"
          },
          "publisher_name": "Marvel"
        }
      }
    ],
    "issue_variants": [
      {
        "id": 901,
        "issue_id": 5432,
        "variant_name": "Cover B",
        "cover_url": "https://...-cover_lg.webp",
        "images": {
          "thumb": "https://...-thumb.webp",
          "cover_sm": "https://...-cover_sm.webp",
          "cover_md": "https://...-cover_md.webp",
          "cover_lg": "https://...-cover_lg.webp"
        },
        "variant_type": "standard",
        "ratio": "1:25",
        "price": "4.99",
        "currency_code": "USD",
        "formatted_price": "$4.99",
        "ean": "75960609999300111",
        "variant_name_i18n": {
          "ja": {
            "value": "講談社",
            "reading": "こうだんしゃ",
            "source": "madb"
          }
        }
      }
    ],
    "attendees_preview": {
      "total": 320,
      "users": [
        {
          "id": 1024,
          "username": "comic_fan_42",
          "name": "comic_fan_42",
          "profile_image_url": "https://...-profile_md.webp"
        }
      ]
    },
    "related_events": [
      {
        "id": 42,
        "slug": "san-diego-comic-con-2026",
        "name": "San Diego Comic-Con 2026",
        "name_i18n": {
          "ja": {
            "value": "講談社",
            "reading": "こうだんしゃ",
            "source": "madb"
          }
        },
        "aliases_i18n": {
          "en": [
            "Kodansha Comics"
          ]
        },
        "original_locale": "en",
        "type": "convention",
        "start_date": "2026-07-23",
        "end_date": "2026-07-26",
        "start_time": "10:00:00",
        "end_time": "18:00:00",
        "timezone": "America/Los_Angeles",
        "status": "scheduled",
        "venue_name": "San Diego Convention Center",
        "city": "San Diego",
        "region": "California",
        "country_code": "US",
        "full_location": "San Diego Convention Center, San Diego, California, United States",
        "logo_url": "https://...-tile_sm.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "full_md": "https://...-full_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "ticket_price": "USD $45.00 – $150.00",
        "follower_count": 320
      }
    ]
  }
}

Response headers

X-RateLimit-Limitinteger

Request quota per hour for your tier.

X-RateLimit-Remaininginteger

Requests remaining in the current window.

Retry-Afterinteger

Seconds to wait before retrying.