Skip to content
VerseDB

Barcode Lookup

Endpoints for looking up comics by barcode (UPC or ISBN) or by a distributor's order code (Lunar or Universal). Used by the mobile app's barcode scanning feature and exposed to User API tokens via the lookup:barcode ability.

On the Mobile API the GET lookups sit on the App Clip mode of the first-party door: a signed-in session gets the full payload, and the App Clip, which has no account, gets the preview payload with its attested clip token (#3044). On the public User API they require the lookup:barcode token ability, and carry no market quote.

Lookup by UPC.

GET/api/v1/lookup/upc/{upc}
Requires a token

Find an issue by its UPC barcode (10 to 18 digits; anything else in the code is dropped). A variant's printed code finds its issue, and a bare 12-digit series code widens to every issue built on it. One issue returns 200 with its covers; a code several issues hold returns 409 with up to 25 candidates.

Path parameters

upcstringrequired

The UPC barcode.

Example: "75960608936700111"

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: 5432

data.slugstring or nullrequired

Example: "amazing-spider-man-1"

data.series_idinteger or nullrequired

Example: 123

data.issue_numberstring or nullrequired

Example: "1"

data.namestring or nullrequired

Example: "The Chameleon Strikes!"

data.solicitationstring or nullrequired

Example: "The publisher's solicitation text."

data.release_datestring or nullrequired

Example: "2018-07-11"

data.foc_datestring or nullrequired

Example: "2018-06-18"

data.cover_datestring or nullrequired

Example: "2018-09-01"

data.is_unreleasedbooleanrequired
data.cover_urlstring or nullrequired

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

data.imagesobject or nullrequired
data.images.thumbstring

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

data.images.cover_smstring

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

data.images.cover_mdstring

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

data.images.cover_lgstring

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

data.is_reprintboolean or nullrequired
data.content_rating_labelstring or nullrequired

Example: "Teen"

data.min_ageinteger or nullrequired

Example: 13

data.is_nsfwboolean or nullrequired
data.page_countinteger or nullrequired

Example: 32

data.pricestring or nullrequired

Example: "4.99"

data.currency_codestring or nullrequired

Example: "USD"

data.formatted_pricestring or nullrequired

Example: "USD $4.99"

data.isbnstring or nullrequired

Example: "9781302912345"

data.upcstring or nullrequired

Example: "75960608936700111"

data.lunar_codestring or nullrequired

Example: "0518MA0001"

data.universal_codestring or nullrequired

Example: "UC1"

data.diamond_codestring or nullrequired

Example: "MAY180001"

data.eanstring or nullrequired

Example: "9781302912345"

data.issnstring or nullrequired

Example: "1234-5678"

data.is_anthologyboolean or nullrequired
data.is_tie_inbooleanrequired
data.adapted_fromstring or nullrequired

Example: "anime"

data.print_runinteger or nullrequired

Example: 12000

data.locationsstring or nullrequired

Example: "Gotham"

data.skustring or nullrequired

Example: "SKU-1"

data.variant_countintegerrequired

Example: 4

data.reads_countintegerrequired

Example: 120

data.average_ratingnumber

Example: 4.5

data.review_countinteger

Example: 12

data.titleobject
data.title.idintegerrequired

Example: 1

data.title.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.title.slugstring or nullrequired

Example: "the-amazing-spider-man"

data.seriesobject or nullrequired
data.series.idintegerrequired

Example: 123

data.series.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.series.slugstring or nullrequired

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

data.series.start_yearinteger or nullrequired

Example: 2018

data.series.end_yearinteger or nullrequired

Example: 2022

data.series.volume_numberinteger or nullrequired

Example: 5

data.series.statusstring or nullrequired

Example: "Ongoing"

data.series.publication_typestring or nullrequired

Example: "regular_series"

data.series.cached_issues_countinteger or nullrequired

Example: 93

data.series.mediumstringrequired

Example: "comic"

data.series.formatstring or nullrequired

Example: "Standard"

data.series.content_rating_labelstring or nullrequired

Example: "Teen"

data.series.min_ageinteger or nullrequired

Example: 13

data.series.is_nsfwbooleanrequired
data.series.original_languagestring or nullrequired

Example: "en"

data.series.languagestring or nullrequired

Example: "en"

data.series.genresarray of objectsrequired
data.series.genres[].idintegerrequired

Example: 3

data.series.genres[].namestring or nullrequired

Example: "Superhero"

data.series.genres[].slugnull or nullrequired
data.series.aliasesarray of stringsrequired
data.series.imprintobject or nullrequired
data.series.imprint.idintegerrequired

Example: 7

data.series.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.series.foreign_edition_ofarray of objectsrequired
data.series.foreign_edition_of[].idintegerrequired

Example: 1

data.series.foreign_edition_of[].namestringrequired
data.series.foreign_edition_of[].slugstring or nullrequired

Example: "slug"

data.series.foreign_edition_of[].languagestring or nullrequired
data.series.foreign_editionsarray of objectsrequired
data.series.foreign_editions[].idintegerrequired

Example: 1

data.series.foreign_editions[].namestringrequired
data.series.foreign_editions[].slugstring or nullrequired

Example: "slug"

data.series.foreign_editions[].languagestring or nullrequired
data.publisherobject or null
data.publisher.idintegerrequired

Example: 1

data.publisher.namestring or nullrequired

Example: "Marvel"

data.publisher.slugstring or nullrequired

Example: "marvel"

data.imprintobject
data.imprint.idintegerrequired

Example: 7

data.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.awardsarray of objects
data.awards[].idintegerrequired

Example: 3

data.awards[].namestring or nullrequired

Example: "Eisner Award"

data.awards[].categorystring or nullrequired

Example: "Best Single Issue"

data.awards[].yearinteger or nullrequired

Example: 2019

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

Example: 81

data.creators[].namestring or nullrequired

Example: "Nick Spencer"

data.creators[].slugstring or nullrequired

Example: "nick-spencer"

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[].rolestringrequired

Example: "Writer"

data.creators[].sort_orderinteger or nullrequired

Example: 1

data.charactersarray of objects
data.characters[].idintegerrequired

Example: 1

data.characters[].namestring or nullrequired

Example: "Spider-Man"

data.characters[].slugstring or nullrequired

Example: "spider-man"

data.characters[].real_namestring or nullrequired

Example: "Peter Parker"

data.characters[].image_urlstring or nullrequired

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

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

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

data.characters[].images.profile_mdstring

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

data.characters[].images.full_lgstring

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

data.characters[].sort_orderinteger or nullrequired

Example: 1

data.teamsarray of objects
data.teams[].idintegerrequired

Example: 1

data.teams[].namestring or nullrequired

Example: "The Avengers"

data.teams[].slugstring or nullrequired

Example: "avengers"

data.teams[].headquartersstring or nullrequired

Example: "Avengers Tower"

data.teams[].image_urlstring or nullrequired

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

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

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

data.teams[].images.profile_mdstring

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

data.teams[].images.full_lgstring

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

data.teams[].sort_orderinteger or nullrequired

Example: 1

data.story_arcsarray of objects
data.story_arcs[].idintegerrequired

Example: 24

data.story_arcs[].namestring or nullrequired

Example: "Civil War"

data.story_arcs[].slugstring or nullrequired

Example: "civil-war"

data.story_arcs[].image_urlstring or nullrequired

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

data.story_arcs[].imagesobject or nullrequired
data.story_arcs[].images.cover_smstring

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

data.story_arcs[].images.cover_mdstring

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

data.story_arcs[].images.cover_lgstring

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

data.story_arcs[].sort_orderinteger or nullrequired

Example: 1

data.universesarray of objects
data.universes[].idintegerrequired

Example: 1

data.universes[].namestring or nullrequired

Example: "Earth-616"

data.comic_eventsarray of objects
data.comic_events[].idintegerrequired

Example: 1

data.comic_events[].namestring or nullrequired

Example: "San Diego Comic-Con"

data.comic_events[].slugstring or nullrequired

Example: "sdcc"

data.comic_events[].typestring or nullrequired

Example: "exclusive"

data.comic_events[].notesstring or nullrequired

Example: "Signed"

data.comic_events[].display_orderinteger or nullrequired

Example: 1

data.key_issue_reasonsarray of objects
data.key_issue_reasons[].idintegerrequired

Example: 1

data.key_issue_reasons[].namestring or nullrequired

Example: "1st Appearance"

data.key_issue_reasons[].categorystringrequired

Example: "appearance"

data.key_issue_reasons[].notesstring or nullrequired

Example: "Cameo"

data.availabilitiesarray of objectsrequired
data.availabilities[].idinteger or nullrequired

Example: 10

data.availabilities[].providerstringrequired

Example: "midtown_comics"

data.availabilities[].provider_labelstringrequired

Example: "Midtown Comics"

data.availabilities[].kindstringrequired

buy, read or watch.

Example: "buy"

data.availabilities[].store_namestring or nullrequired

Example: "Midtown Comics"

data.availabilities[].custom_namestring or nullrequired

Example: "Signed edition"

data.availabilities[].display_namestringrequired

Example: "Midtown Comics"

data.availabilities[].store_logostring or nullrequired

Example: "/images/brands/midtown.png"

data.availabilities[].urlstringrequired

Example: "https://www.midtowncomics.com/..."

data.availabilities[].external_idstring or nullrequired

Example: "12345"

data.availabilities[].pricenumber or nullrequired

Example: 19.99

data.availabilities[].formatted_pricestring or nullrequired

Example: "$19.99"

data.availabilities[].currencystring or nullrequired

Example: "USD"

data.availabilities[].is_digitalboolean or nullrequired
data.availabilities[].is_affiliatebooleanrequired
data.availabilities[].is_synthesizedbooleanrequired
data.availabilities[].verified_atstring or nullrequired

Example: "2026-01-01T00:00:00+00:00"

data.name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

suggested_variant_idinteger or nullrequired

Example: 789

variantsarray of objectsrequired
variants[].variant_idinteger or nullrequired

Example: 789

variants[].variant_namestringrequired

Example: "Cover B"

variants[].cover_urlstring or nullrequired

Example: "https://..."

variants[].upcstring or nullrequired

Example: "75960608936700121"

variants[].lunar_codestring or nullrequired

Example: "0518MA0102"

variants[].universal_codestring or nullrequired

Example: "DC10251017"

variants[].diamond_codestring or nullrequired

Example: "MAY180902"

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 lookup:barcode ability.

messagestringrequired

Example: "Insufficient token scope."

Example body, from the documented examples

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

Not Found

messagestringrequired

Example: "No issue found with UPC: 75960608936700111"

Example body, from the documented examples

{
  "message": "No issue found with UPC: 75960608936700111"
}
409

Multiple Matches

messagestringrequired

Example: "Multiple issues share UPC: 075960608936. Pick one below."

countintegerrequired

Example: 3

total_countintegerrequired

Example: 3

matchesarray of objectsrequired
matches[].issue_idintegerrequired

Example: 5432

matches[].series_namestring or nullrequired

Example: "Amazing Spider-Man"

matches[].series_idinteger or nullrequired

Example: 123

matches[].issue_numberstring or nullrequired

Example: "1"

matches[].cover_urlstring or nullrequired

Example: "https://..."

matches[].variant_namenull or nullrequired
matches[].suggested_variant_idinteger or nullrequired

Example: null

matches[].variantsarray of objectsrequired
matches[].variants[].variant_idinteger or nullrequired

Example: 789

matches[].variants[].variant_namestringrequired

Example: "Cover B"

matches[].variants[].cover_urlstring or nullrequired

Example: "https://..."

matches[].variants[].upcstring or nullrequired

Example: "75960608936700121"

matches[].variants[].lunar_codestring or nullrequired

Example: "0518MA0102"

matches[].variants[].universal_codestring or nullrequired

Example: "DC10251017"

matches[].variants[].diamond_codestring or nullrequired

Example: "MAY180902"

matches[].publisher_namestring or nullrequired

Example: "Marvel"

matches[].release_datestring or nullrequired

Example: "1990-04-01"

matches[].start_yearinteger or nullrequired

Example: 1963

Example body, from the documented examples

{
  "message": "Multiple issues share UPC: 075960608936. Pick one below.",
  "count": 3,
  "total_count": 3,
  "matches": [
    {
      "issue_id": 5432,
      "series_name": "Amazing Spider-Man",
      "series_id": 123,
      "issue_number": "1",
      "cover_url": "https://...",
      "suggested_variant_id": null,
      "variants": [
        {
          "variant_id": 789,
          "variant_name": "Cover B",
          "cover_url": "https://...",
          "upc": "75960608936700121",
          "lunar_code": "0518MA0102",
          "universal_code": "DC10251017",
          "diamond_code": "MAY180902"
        }
      ],
      "publisher_name": "Marvel",
      "release_date": "1990-04-01",
      "start_year": 1963
    }
  ]
}
422

Invalid UPC

messagestringrequired

Example: "Invalid UPC format. Expected 10-18 digits."

Example body, from the documented examples

{
  "message": "Invalid UPC format. Expected 10-18 digits."
}
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/lookup/upc/75960608936700111' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 5432,
    "slug": "amazing-spider-man-1",
    "series_id": 123,
    "issue_number": "1",
    "name": "The Chameleon Strikes!",
    "solicitation": "The publisher's solicitation text.",
    "release_date": "2018-07-11",
    "foc_date": "2018-06-18",
    "cover_date": "2018-09-01",
    "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,
    "page_count": 32,
    "price": "4.99",
    "currency_code": "USD",
    "formatted_price": "USD $4.99",
    "isbn": "9781302912345",
    "upc": "75960608936700111",
    "lunar_code": "0518MA0001",
    "universal_code": "UC1",
    "diamond_code": "MAY180001",
    "ean": "9781302912345",
    "issn": "1234-5678",
    "adapted_from": "anime",
    "print_run": 12000,
    "locations": "Gotham",
    "sku": "SKU-1",
    "variant_count": 4,
    "reads_count": 120,
    "average_rating": 4.5,
    "review_count": 12,
    "title": {
      "id": 1,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man"
    },
    "series": {
      "id": 123,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man-2018",
      "start_year": 2018,
      "end_year": 2022,
      "volume_number": 5,
      "status": "Ongoing",
      "publication_type": "regular_series",
      "cached_issues_count": 93,
      "medium": "comic",
      "format": "Standard",
      "content_rating_label": "Teen",
      "min_age": 13,
      "original_language": "en",
      "language": "en",
      "genres": [
        {
          "id": 3,
          "name": "Superhero"
        }
      ],
      "imprint": {
        "id": 7,
        "name": "Marvel Knights"
      },
      "foreign_edition_of": [
        {
          "id": 1,
          "slug": "slug"
        }
      ],
      "foreign_editions": [
        {
          "id": 1,
          "slug": "slug"
        }
      ]
    },
    "publisher": {
      "id": 1,
      "name": "Marvel",
      "slug": "marvel"
    },
    "imprint": {
      "id": 7,
      "name": "Marvel Knights"
    },
    "awards": [
      {
        "id": 3,
        "name": "Eisner Award",
        "category": "Best Single Issue",
        "year": 2019
      }
    ],
    "creators": [
      {
        "id": 81,
        "name": "Nick Spencer",
        "slug": "nick-spencer",
        "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"
        },
        "role": "Writer",
        "sort_order": 1
      }
    ],
    "characters": [
      {
        "id": 1,
        "name": "Spider-Man",
        "slug": "spider-man",
        "real_name": "Peter Parker",
        "image_url": "https://...-profile_md.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "teams": [
      {
        "id": 1,
        "name": "The Avengers",
        "slug": "avengers",
        "headquarters": "Avengers Tower",
        "image_url": "https://...-tile_sm.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "story_arcs": [
      {
        "id": 24,
        "name": "Civil War",
        "slug": "civil-war",
        "image_url": "https://...-cover_md.webp",
        "images": {
          "cover_sm": "https://...-cover_sm.webp",
          "cover_md": "https://...-cover_md.webp",
          "cover_lg": "https://...-cover_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "universes": [
      {
        "id": 1,
        "name": "Earth-616"
      }
    ],
    "comic_events": [
      {
        "id": 1,
        "name": "San Diego Comic-Con",
        "slug": "sdcc",
        "type": "exclusive",
        "notes": "Signed",
        "display_order": 1
      }
    ],
    "key_issue_reasons": [
      {
        "id": 1,
        "name": "1st Appearance",
        "category": "appearance",
        "notes": "Cameo"
      }
    ],
    "availabilities": [
      {
        "id": 10,
        "provider": "midtown_comics",
        "provider_label": "Midtown Comics",
        "kind": "buy",
        "store_name": "Midtown Comics",
        "custom_name": "Signed edition",
        "display_name": "Midtown Comics",
        "store_logo": "/images/brands/midtown.png",
        "url": "https://www.midtowncomics.com/...",
        "external_id": "12345",
        "price": 19.99,
        "formatted_price": "$19.99",
        "currency": "USD",
        "verified_at": "2026-01-01T00:00:00+00:00"
      }
    ],
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    }
  },
  "suggested_variant_id": 789,
  "variants": [
    {
      "variant_id": 789,
      "variant_name": "Cover B",
      "cover_url": "https://...",
      "upc": "75960608936700121",
      "lunar_code": "0518MA0102",
      "universal_code": "DC10251017",
      "diamond_code": "MAY180902"
    }
  ]
}

Lookup by ISBN.

GET/api/v1/lookup/isbn/{isbn}
Requires a token

Find an issue by its ISBN (10 or 13 digits, with or without dashes). Commonly used for trade paperbacks and hardcovers. Returns full issue details including series information.

Path parameters

isbnstringrequired

The ISBN (10 or 13 digits).

Example: "978-1302913847"

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: 5432

data.slugstring or nullrequired

Example: "amazing-spider-man-1"

data.series_idinteger or nullrequired

Example: 123

data.issue_numberstring or nullrequired

Example: "1"

data.namestring or nullrequired

Example: "The Chameleon Strikes!"

data.solicitationstring or nullrequired

Example: "The publisher's solicitation text."

data.release_datestring or nullrequired

Example: "2018-07-11"

data.foc_datestring or nullrequired

Example: "2018-06-18"

data.cover_datestring or nullrequired

Example: "2018-09-01"

data.is_unreleasedbooleanrequired
data.cover_urlstring or nullrequired

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

data.imagesobject or nullrequired
data.images.thumbstring

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

data.images.cover_smstring

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

data.images.cover_mdstring

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

data.images.cover_lgstring

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

data.is_reprintboolean or nullrequired
data.content_rating_labelstring or nullrequired

Example: "Teen"

data.min_ageinteger or nullrequired

Example: 13

data.is_nsfwboolean or nullrequired
data.page_countinteger or nullrequired

Example: 32

data.pricestring or nullrequired

Example: "4.99"

data.currency_codestring or nullrequired

Example: "USD"

data.formatted_pricestring or nullrequired

Example: "USD $4.99"

data.isbnstring or nullrequired

Example: "9781302912345"

data.upcstring or nullrequired

Example: "75960608936700111"

data.lunar_codestring or nullrequired

Example: "0518MA0001"

data.universal_codestring or nullrequired

Example: "UC1"

data.diamond_codestring or nullrequired

Example: "MAY180001"

data.eanstring or nullrequired

Example: "9781302912345"

data.issnstring or nullrequired

Example: "1234-5678"

data.is_anthologyboolean or nullrequired
data.is_tie_inbooleanrequired
data.adapted_fromstring or nullrequired

Example: "anime"

data.print_runinteger or nullrequired

Example: 12000

data.locationsstring or nullrequired

Example: "Gotham"

data.skustring or nullrequired

Example: "SKU-1"

data.variant_countintegerrequired

Example: 4

data.reads_countintegerrequired

Example: 120

data.average_ratingnumber

Example: 4.5

data.review_countinteger

Example: 12

data.titleobject
data.title.idintegerrequired

Example: 1

data.title.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.title.slugstring or nullrequired

Example: "the-amazing-spider-man"

data.seriesobject or nullrequired
data.series.idintegerrequired

Example: 123

data.series.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.series.slugstring or nullrequired

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

data.series.start_yearinteger or nullrequired

Example: 2018

data.series.end_yearinteger or nullrequired

Example: 2022

data.series.volume_numberinteger or nullrequired

Example: 5

data.series.statusstring or nullrequired

Example: "Ongoing"

data.series.publication_typestring or nullrequired

Example: "regular_series"

data.series.cached_issues_countinteger or nullrequired

Example: 93

data.series.mediumstringrequired

Example: "comic"

data.series.formatstring or nullrequired

Example: "Standard"

data.series.content_rating_labelstring or nullrequired

Example: "Teen"

data.series.min_ageinteger or nullrequired

Example: 13

data.series.is_nsfwbooleanrequired
data.series.original_languagestring or nullrequired

Example: "en"

data.series.languagestring or nullrequired

Example: "en"

data.series.genresarray of objectsrequired
data.series.genres[].idintegerrequired

Example: 3

data.series.genres[].namestring or nullrequired

Example: "Superhero"

data.series.genres[].slugnull or nullrequired
data.series.aliasesarray of stringsrequired
data.series.imprintobject or nullrequired
data.series.imprint.idintegerrequired

Example: 7

data.series.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.series.foreign_edition_ofarray of objectsrequired
data.series.foreign_edition_of[].idintegerrequired

Example: 1

data.series.foreign_edition_of[].namestringrequired
data.series.foreign_edition_of[].slugstring or nullrequired

Example: "slug"

data.series.foreign_edition_of[].languagestring or nullrequired
data.series.foreign_editionsarray of objectsrequired
data.series.foreign_editions[].idintegerrequired

Example: 1

data.series.foreign_editions[].namestringrequired
data.series.foreign_editions[].slugstring or nullrequired

Example: "slug"

data.series.foreign_editions[].languagestring or nullrequired
data.publisherobject or null
data.publisher.idintegerrequired

Example: 1

data.publisher.namestring or nullrequired

Example: "Marvel"

data.publisher.slugstring or nullrequired

Example: "marvel"

data.imprintobject
data.imprint.idintegerrequired

Example: 7

data.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.awardsarray of objects
data.awards[].idintegerrequired

Example: 3

data.awards[].namestring or nullrequired

Example: "Eisner Award"

data.awards[].categorystring or nullrequired

Example: "Best Single Issue"

data.awards[].yearinteger or nullrequired

Example: 2019

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

Example: 81

data.creators[].namestring or nullrequired

Example: "Nick Spencer"

data.creators[].slugstring or nullrequired

Example: "nick-spencer"

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[].rolestringrequired

Example: "Writer"

data.creators[].sort_orderinteger or nullrequired

Example: 1

data.charactersarray of objects
data.characters[].idintegerrequired

Example: 1

data.characters[].namestring or nullrequired

Example: "Spider-Man"

data.characters[].slugstring or nullrequired

Example: "spider-man"

data.characters[].real_namestring or nullrequired

Example: "Peter Parker"

data.characters[].image_urlstring or nullrequired

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

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

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

data.characters[].images.profile_mdstring

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

data.characters[].images.full_lgstring

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

data.characters[].sort_orderinteger or nullrequired

Example: 1

data.teamsarray of objects
data.teams[].idintegerrequired

Example: 1

data.teams[].namestring or nullrequired

Example: "The Avengers"

data.teams[].slugstring or nullrequired

Example: "avengers"

data.teams[].headquartersstring or nullrequired

Example: "Avengers Tower"

data.teams[].image_urlstring or nullrequired

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

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

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

data.teams[].images.profile_mdstring

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

data.teams[].images.full_lgstring

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

data.teams[].sort_orderinteger or nullrequired

Example: 1

data.story_arcsarray of objects
data.story_arcs[].idintegerrequired

Example: 24

data.story_arcs[].namestring or nullrequired

Example: "Civil War"

data.story_arcs[].slugstring or nullrequired

Example: "civil-war"

data.story_arcs[].image_urlstring or nullrequired

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

data.story_arcs[].imagesobject or nullrequired
data.story_arcs[].images.cover_smstring

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

data.story_arcs[].images.cover_mdstring

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

data.story_arcs[].images.cover_lgstring

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

data.story_arcs[].sort_orderinteger or nullrequired

Example: 1

data.universesarray of objects
data.universes[].idintegerrequired

Example: 1

data.universes[].namestring or nullrequired

Example: "Earth-616"

data.comic_eventsarray of objects
data.comic_events[].idintegerrequired

Example: 1

data.comic_events[].namestring or nullrequired

Example: "San Diego Comic-Con"

data.comic_events[].slugstring or nullrequired

Example: "sdcc"

data.comic_events[].typestring or nullrequired

Example: "exclusive"

data.comic_events[].notesstring or nullrequired

Example: "Signed"

data.comic_events[].display_orderinteger or nullrequired

Example: 1

data.key_issue_reasonsarray of objects
data.key_issue_reasons[].idintegerrequired

Example: 1

data.key_issue_reasons[].namestring or nullrequired

Example: "1st Appearance"

data.key_issue_reasons[].categorystringrequired

Example: "appearance"

data.key_issue_reasons[].notesstring or nullrequired

Example: "Cameo"

data.availabilitiesarray of objectsrequired
data.availabilities[].idinteger or nullrequired

Example: 10

data.availabilities[].providerstringrequired

Example: "midtown_comics"

data.availabilities[].provider_labelstringrequired

Example: "Midtown Comics"

data.availabilities[].kindstringrequired

buy, read or watch.

Example: "buy"

data.availabilities[].store_namestring or nullrequired

Example: "Midtown Comics"

data.availabilities[].custom_namestring or nullrequired

Example: "Signed edition"

data.availabilities[].display_namestringrequired

Example: "Midtown Comics"

data.availabilities[].store_logostring or nullrequired

Example: "/images/brands/midtown.png"

data.availabilities[].urlstringrequired

Example: "https://www.midtowncomics.com/..."

data.availabilities[].external_idstring or nullrequired

Example: "12345"

data.availabilities[].pricenumber or nullrequired

Example: 19.99

data.availabilities[].formatted_pricestring or nullrequired

Example: "$19.99"

data.availabilities[].currencystring or nullrequired

Example: "USD"

data.availabilities[].is_digitalboolean or nullrequired
data.availabilities[].is_affiliatebooleanrequired
data.availabilities[].is_synthesizedbooleanrequired
data.availabilities[].verified_atstring or nullrequired

Example: "2026-01-01T00:00:00+00:00"

data.name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

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 lookup:barcode ability.

messagestringrequired

Example: "Insufficient token scope."

Example body, from the documented examples

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

Not Found

messagestringrequired

Example: "No issue found with ISBN: 978-1302913847"

Example body, from the documented examples

{
  "message": "No issue found with ISBN: 978-1302913847"
}
422

Invalid ISBN

messagestringrequired

Example: "Invalid ISBN format. Expected 10 or 13 digits."

Example body, from the documented examples

{
  "message": "Invalid ISBN format. Expected 10 or 13 digits."
}
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/lookup/isbn/978-1302913847' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 5432,
    "slug": "amazing-spider-man-1",
    "series_id": 123,
    "issue_number": "1",
    "name": "The Chameleon Strikes!",
    "solicitation": "The publisher's solicitation text.",
    "release_date": "2018-07-11",
    "foc_date": "2018-06-18",
    "cover_date": "2018-09-01",
    "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,
    "page_count": 32,
    "price": "4.99",
    "currency_code": "USD",
    "formatted_price": "USD $4.99",
    "isbn": "9781302912345",
    "upc": "75960608936700111",
    "lunar_code": "0518MA0001",
    "universal_code": "UC1",
    "diamond_code": "MAY180001",
    "ean": "9781302912345",
    "issn": "1234-5678",
    "adapted_from": "anime",
    "print_run": 12000,
    "locations": "Gotham",
    "sku": "SKU-1",
    "variant_count": 4,
    "reads_count": 120,
    "average_rating": 4.5,
    "review_count": 12,
    "title": {
      "id": 1,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man"
    },
    "series": {
      "id": 123,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man-2018",
      "start_year": 2018,
      "end_year": 2022,
      "volume_number": 5,
      "status": "Ongoing",
      "publication_type": "regular_series",
      "cached_issues_count": 93,
      "medium": "comic",
      "format": "Standard",
      "content_rating_label": "Teen",
      "min_age": 13,
      "original_language": "en",
      "language": "en",
      "genres": [
        {
          "id": 3,
          "name": "Superhero"
        }
      ],
      "imprint": {
        "id": 7,
        "name": "Marvel Knights"
      },
      "foreign_edition_of": [
        {
          "id": 1,
          "slug": "slug"
        }
      ],
      "foreign_editions": [
        {
          "id": 1,
          "slug": "slug"
        }
      ]
    },
    "publisher": {
      "id": 1,
      "name": "Marvel",
      "slug": "marvel"
    },
    "imprint": {
      "id": 7,
      "name": "Marvel Knights"
    },
    "awards": [
      {
        "id": 3,
        "name": "Eisner Award",
        "category": "Best Single Issue",
        "year": 2019
      }
    ],
    "creators": [
      {
        "id": 81,
        "name": "Nick Spencer",
        "slug": "nick-spencer",
        "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"
        },
        "role": "Writer",
        "sort_order": 1
      }
    ],
    "characters": [
      {
        "id": 1,
        "name": "Spider-Man",
        "slug": "spider-man",
        "real_name": "Peter Parker",
        "image_url": "https://...-profile_md.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "teams": [
      {
        "id": 1,
        "name": "The Avengers",
        "slug": "avengers",
        "headquarters": "Avengers Tower",
        "image_url": "https://...-tile_sm.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "story_arcs": [
      {
        "id": 24,
        "name": "Civil War",
        "slug": "civil-war",
        "image_url": "https://...-cover_md.webp",
        "images": {
          "cover_sm": "https://...-cover_sm.webp",
          "cover_md": "https://...-cover_md.webp",
          "cover_lg": "https://...-cover_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "universes": [
      {
        "id": 1,
        "name": "Earth-616"
      }
    ],
    "comic_events": [
      {
        "id": 1,
        "name": "San Diego Comic-Con",
        "slug": "sdcc",
        "type": "exclusive",
        "notes": "Signed",
        "display_order": 1
      }
    ],
    "key_issue_reasons": [
      {
        "id": 1,
        "name": "1st Appearance",
        "category": "appearance",
        "notes": "Cameo"
      }
    ],
    "availabilities": [
      {
        "id": 10,
        "provider": "midtown_comics",
        "provider_label": "Midtown Comics",
        "kind": "buy",
        "store_name": "Midtown Comics",
        "custom_name": "Signed edition",
        "display_name": "Midtown Comics",
        "store_logo": "/images/brands/midtown.png",
        "url": "https://www.midtowncomics.com/...",
        "external_id": "12345",
        "price": 19.99,
        "formatted_price": "$19.99",
        "currency": "USD",
        "verified_at": "2026-01-01T00:00:00+00:00"
      }
    ],
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    }
  }
}

Lookup by distributor code.

GET/api/v1/lookup/code/{code}
Requires a token

Find an issue by its distributor order code: a Lunar code (like 0126IM0451) or a Universal code (like DC10251016), in any case. A variant's own code finds its issue, and suggested_variant_id then names that variant. The payload matches the UPC lookup: one issue returns 200, a code held by several issues returns 409 with the candidates.

Path parameters

codestringrequired

A Lunar or Universal code.

Example: "1125DC0151"

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: 5432

data.slugstring or nullrequired

Example: "amazing-spider-man-1"

data.series_idinteger or nullrequired

Example: 123

data.issue_numberstring or nullrequired

Example: "1"

data.namestring or nullrequired

Example: "The Chameleon Strikes!"

data.solicitationstring or nullrequired

Example: "The publisher's solicitation text."

data.release_datestring or nullrequired

Example: "2018-07-11"

data.foc_datestring or nullrequired

Example: "2018-06-18"

data.cover_datestring or nullrequired

Example: "2018-09-01"

data.is_unreleasedbooleanrequired
data.cover_urlstring or nullrequired

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

data.imagesobject or nullrequired
data.images.thumbstring

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

data.images.cover_smstring

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

data.images.cover_mdstring

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

data.images.cover_lgstring

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

data.is_reprintboolean or nullrequired
data.content_rating_labelstring or nullrequired

Example: "Teen"

data.min_ageinteger or nullrequired

Example: 13

data.is_nsfwboolean or nullrequired
data.page_countinteger or nullrequired

Example: 32

data.pricestring or nullrequired

Example: "4.99"

data.currency_codestring or nullrequired

Example: "USD"

data.formatted_pricestring or nullrequired

Example: "USD $4.99"

data.isbnstring or nullrequired

Example: "9781302912345"

data.upcstring or nullrequired

Example: "75960608936700111"

data.lunar_codestring or nullrequired

Example: "0518MA0001"

data.universal_codestring or nullrequired

Example: "UC1"

data.diamond_codestring or nullrequired

Example: "MAY180001"

data.eanstring or nullrequired

Example: "9781302912345"

data.issnstring or nullrequired

Example: "1234-5678"

data.is_anthologyboolean or nullrequired
data.is_tie_inbooleanrequired
data.adapted_fromstring or nullrequired

Example: "anime"

data.print_runinteger or nullrequired

Example: 12000

data.locationsstring or nullrequired

Example: "Gotham"

data.skustring or nullrequired

Example: "SKU-1"

data.variant_countintegerrequired

Example: 4

data.reads_countintegerrequired

Example: 120

data.average_ratingnumber

Example: 4.5

data.review_countinteger

Example: 12

data.titleobject
data.title.idintegerrequired

Example: 1

data.title.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.title.slugstring or nullrequired

Example: "the-amazing-spider-man"

data.seriesobject or nullrequired
data.series.idintegerrequired

Example: 123

data.series.namestring or nullrequired

Example: "The Amazing Spider-Man"

data.series.slugstring or nullrequired

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

data.series.start_yearinteger or nullrequired

Example: 2018

data.series.end_yearinteger or nullrequired

Example: 2022

data.series.volume_numberinteger or nullrequired

Example: 5

data.series.statusstring or nullrequired

Example: "Ongoing"

data.series.publication_typestring or nullrequired

Example: "regular_series"

data.series.cached_issues_countinteger or nullrequired

Example: 93

data.series.mediumstringrequired

Example: "comic"

data.series.formatstring or nullrequired

Example: "Standard"

data.series.content_rating_labelstring or nullrequired

Example: "Teen"

data.series.min_ageinteger or nullrequired

Example: 13

data.series.is_nsfwbooleanrequired
data.series.original_languagestring or nullrequired

Example: "en"

data.series.languagestring or nullrequired

Example: "en"

data.series.genresarray of objectsrequired
data.series.genres[].idintegerrequired

Example: 3

data.series.genres[].namestring or nullrequired

Example: "Superhero"

data.series.genres[].slugnull or nullrequired
data.series.aliasesarray of stringsrequired
data.series.imprintobject or nullrequired
data.series.imprint.idintegerrequired

Example: 7

data.series.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.series.foreign_edition_ofarray of objectsrequired
data.series.foreign_edition_of[].idintegerrequired

Example: 1

data.series.foreign_edition_of[].namestringrequired
data.series.foreign_edition_of[].slugstring or nullrequired

Example: "slug"

data.series.foreign_edition_of[].languagestring or nullrequired
data.series.foreign_editionsarray of objectsrequired
data.series.foreign_editions[].idintegerrequired

Example: 1

data.series.foreign_editions[].namestringrequired
data.series.foreign_editions[].slugstring or nullrequired

Example: "slug"

data.series.foreign_editions[].languagestring or nullrequired
data.publisherobject or null
data.publisher.idintegerrequired

Example: 1

data.publisher.namestring or nullrequired

Example: "Marvel"

data.publisher.slugstring or nullrequired

Example: "marvel"

data.imprintobject
data.imprint.idintegerrequired

Example: 7

data.imprint.namestring or nullrequired

Example: "Marvel Knights"

data.awardsarray of objects
data.awards[].idintegerrequired

Example: 3

data.awards[].namestring or nullrequired

Example: "Eisner Award"

data.awards[].categorystring or nullrequired

Example: "Best Single Issue"

data.awards[].yearinteger or nullrequired

Example: 2019

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

Example: 81

data.creators[].namestring or nullrequired

Example: "Nick Spencer"

data.creators[].slugstring or nullrequired

Example: "nick-spencer"

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[].rolestringrequired

Example: "Writer"

data.creators[].sort_orderinteger or nullrequired

Example: 1

data.charactersarray of objects
data.characters[].idintegerrequired

Example: 1

data.characters[].namestring or nullrequired

Example: "Spider-Man"

data.characters[].slugstring or nullrequired

Example: "spider-man"

data.characters[].real_namestring or nullrequired

Example: "Peter Parker"

data.characters[].image_urlstring or nullrequired

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

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

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

data.characters[].images.profile_mdstring

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

data.characters[].images.full_lgstring

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

data.characters[].sort_orderinteger or nullrequired

Example: 1

data.teamsarray of objects
data.teams[].idintegerrequired

Example: 1

data.teams[].namestring or nullrequired

Example: "The Avengers"

data.teams[].slugstring or nullrequired

Example: "avengers"

data.teams[].headquartersstring or nullrequired

Example: "Avengers Tower"

data.teams[].image_urlstring or nullrequired

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

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

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

data.teams[].images.profile_mdstring

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

data.teams[].images.full_lgstring

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

data.teams[].sort_orderinteger or nullrequired

Example: 1

data.story_arcsarray of objects
data.story_arcs[].idintegerrequired

Example: 24

data.story_arcs[].namestring or nullrequired

Example: "Civil War"

data.story_arcs[].slugstring or nullrequired

Example: "civil-war"

data.story_arcs[].image_urlstring or nullrequired

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

data.story_arcs[].imagesobject or nullrequired
data.story_arcs[].images.cover_smstring

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

data.story_arcs[].images.cover_mdstring

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

data.story_arcs[].images.cover_lgstring

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

data.story_arcs[].sort_orderinteger or nullrequired

Example: 1

data.universesarray of objects
data.universes[].idintegerrequired

Example: 1

data.universes[].namestring or nullrequired

Example: "Earth-616"

data.comic_eventsarray of objects
data.comic_events[].idintegerrequired

Example: 1

data.comic_events[].namestring or nullrequired

Example: "San Diego Comic-Con"

data.comic_events[].slugstring or nullrequired

Example: "sdcc"

data.comic_events[].typestring or nullrequired

Example: "exclusive"

data.comic_events[].notesstring or nullrequired

Example: "Signed"

data.comic_events[].display_orderinteger or nullrequired

Example: 1

data.key_issue_reasonsarray of objects
data.key_issue_reasons[].idintegerrequired

Example: 1

data.key_issue_reasons[].namestring or nullrequired

Example: "1st Appearance"

data.key_issue_reasons[].categorystringrequired

Example: "appearance"

data.key_issue_reasons[].notesstring or nullrequired

Example: "Cameo"

data.availabilitiesarray of objectsrequired
data.availabilities[].idinteger or nullrequired

Example: 10

data.availabilities[].providerstringrequired

Example: "midtown_comics"

data.availabilities[].provider_labelstringrequired

Example: "Midtown Comics"

data.availabilities[].kindstringrequired

buy, read or watch.

Example: "buy"

data.availabilities[].store_namestring or nullrequired

Example: "Midtown Comics"

data.availabilities[].custom_namestring or nullrequired

Example: "Signed edition"

data.availabilities[].display_namestringrequired

Example: "Midtown Comics"

data.availabilities[].store_logostring or nullrequired

Example: "/images/brands/midtown.png"

data.availabilities[].urlstringrequired

Example: "https://www.midtowncomics.com/..."

data.availabilities[].external_idstring or nullrequired

Example: "12345"

data.availabilities[].pricenumber or nullrequired

Example: 19.99

data.availabilities[].formatted_pricestring or nullrequired

Example: "$19.99"

data.availabilities[].currencystring or nullrequired

Example: "USD"

data.availabilities[].is_digitalboolean or nullrequired
data.availabilities[].is_affiliatebooleanrequired
data.availabilities[].is_synthesizedbooleanrequired
data.availabilities[].verified_atstring or nullrequired

Example: "2026-01-01T00:00:00+00:00"

data.name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

suggested_variant_idinteger or nullrequired

Example: 789

variantsarray of objectsrequired
variants[].variant_idinteger or nullrequired

Example: 789

variants[].variant_namestringrequired

Example: "Cover B"

variants[].cover_urlstring or nullrequired

Example: "https://..."

variants[].upcstring or nullrequired

Example: "75960608936700121"

variants[].lunar_codestring or nullrequired

Example: "0518MA0102"

variants[].universal_codestring or nullrequired

Example: "DC10251017"

variants[].diamond_codestring or nullrequired

Example: "MAY180902"

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 lookup:barcode ability.

messagestringrequired

Example: "Insufficient token scope."

Example body, from the documented examples

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

Not Found

messagestringrequired

Example: "No issue found with Lunar code: 1125DC0151"

Example body, from the documented examples

{
  "message": "No issue found with Lunar code: 1125DC0151"
}
409

Multiple Matches

messagestringrequired

Example: "Multiple issues share Lunar code: 1125DC0151. Pick one below."

countintegerrequired

Example: 3

total_countintegerrequired

Example: 3

matchesarray of objectsrequired
matches[].issue_idintegerrequired

Example: 5432

matches[].series_namestring or nullrequired

Example: "Amazing Spider-Man"

matches[].series_idinteger or nullrequired

Example: 123

matches[].issue_numberstring or nullrequired

Example: "1"

matches[].cover_urlstring or nullrequired

Example: "https://..."

matches[].variant_namenull or nullrequired
matches[].suggested_variant_idinteger or nullrequired

Example: null

matches[].variantsarray of objectsrequired
matches[].variants[].variant_idinteger or nullrequired

Example: 789

matches[].variants[].variant_namestringrequired

Example: "Cover B"

matches[].variants[].cover_urlstring or nullrequired

Example: "https://..."

matches[].variants[].upcstring or nullrequired

Example: "75960608936700121"

matches[].variants[].lunar_codestring or nullrequired

Example: "0518MA0102"

matches[].variants[].universal_codestring or nullrequired

Example: "DC10251017"

matches[].variants[].diamond_codestring or nullrequired

Example: "MAY180902"

matches[].publisher_namestring or nullrequired

Example: "Marvel"

matches[].release_datestring or nullrequired

Example: "1990-04-01"

matches[].start_yearinteger or nullrequired

Example: 1963

Example body, from the documented examples

{
  "message": "Multiple issues share Lunar code: 1125DC0151. Pick one below.",
  "count": 3,
  "total_count": 3,
  "matches": [
    {
      "issue_id": 5432,
      "series_name": "Amazing Spider-Man",
      "series_id": 123,
      "issue_number": "1",
      "cover_url": "https://...",
      "suggested_variant_id": null,
      "variants": [
        {
          "variant_id": 789,
          "variant_name": "Cover B",
          "cover_url": "https://...",
          "upc": "75960608936700121",
          "lunar_code": "0518MA0102",
          "universal_code": "DC10251017",
          "diamond_code": "MAY180902"
        }
      ],
      "publisher_name": "Marvel",
      "release_date": "1990-04-01",
      "start_year": 1963
    }
  ]
}
422

Not a Lunar or Universal Code

messagestringrequired

Example: "Invalid code. Expected a Lunar code like 0126IM0451 or a Universal code like DC10251016."

Example body, from the documented examples

{
  "message": "Invalid code. Expected a Lunar code like 0126IM0451 or a Universal code like DC10251016."
}
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/lookup/code/1125DC0151' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 5432,
    "slug": "amazing-spider-man-1",
    "series_id": 123,
    "issue_number": "1",
    "name": "The Chameleon Strikes!",
    "solicitation": "The publisher's solicitation text.",
    "release_date": "2018-07-11",
    "foc_date": "2018-06-18",
    "cover_date": "2018-09-01",
    "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,
    "page_count": 32,
    "price": "4.99",
    "currency_code": "USD",
    "formatted_price": "USD $4.99",
    "isbn": "9781302912345",
    "upc": "75960608936700111",
    "lunar_code": "0518MA0001",
    "universal_code": "UC1",
    "diamond_code": "MAY180001",
    "ean": "9781302912345",
    "issn": "1234-5678",
    "adapted_from": "anime",
    "print_run": 12000,
    "locations": "Gotham",
    "sku": "SKU-1",
    "variant_count": 4,
    "reads_count": 120,
    "average_rating": 4.5,
    "review_count": 12,
    "title": {
      "id": 1,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man"
    },
    "series": {
      "id": 123,
      "name": "The Amazing Spider-Man",
      "slug": "the-amazing-spider-man-2018",
      "start_year": 2018,
      "end_year": 2022,
      "volume_number": 5,
      "status": "Ongoing",
      "publication_type": "regular_series",
      "cached_issues_count": 93,
      "medium": "comic",
      "format": "Standard",
      "content_rating_label": "Teen",
      "min_age": 13,
      "original_language": "en",
      "language": "en",
      "genres": [
        {
          "id": 3,
          "name": "Superhero"
        }
      ],
      "imprint": {
        "id": 7,
        "name": "Marvel Knights"
      },
      "foreign_edition_of": [
        {
          "id": 1,
          "slug": "slug"
        }
      ],
      "foreign_editions": [
        {
          "id": 1,
          "slug": "slug"
        }
      ]
    },
    "publisher": {
      "id": 1,
      "name": "Marvel",
      "slug": "marvel"
    },
    "imprint": {
      "id": 7,
      "name": "Marvel Knights"
    },
    "awards": [
      {
        "id": 3,
        "name": "Eisner Award",
        "category": "Best Single Issue",
        "year": 2019
      }
    ],
    "creators": [
      {
        "id": 81,
        "name": "Nick Spencer",
        "slug": "nick-spencer",
        "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"
        },
        "role": "Writer",
        "sort_order": 1
      }
    ],
    "characters": [
      {
        "id": 1,
        "name": "Spider-Man",
        "slug": "spider-man",
        "real_name": "Peter Parker",
        "image_url": "https://...-profile_md.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "teams": [
      {
        "id": 1,
        "name": "The Avengers",
        "slug": "avengers",
        "headquarters": "Avengers Tower",
        "image_url": "https://...-tile_sm.webp",
        "images": {
          "tile_sm": "https://...-tile_sm.webp",
          "profile_md": "https://...-profile_md.webp",
          "full_lg": "https://...-full_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "story_arcs": [
      {
        "id": 24,
        "name": "Civil War",
        "slug": "civil-war",
        "image_url": "https://...-cover_md.webp",
        "images": {
          "cover_sm": "https://...-cover_sm.webp",
          "cover_md": "https://...-cover_md.webp",
          "cover_lg": "https://...-cover_lg.webp"
        },
        "sort_order": 1
      }
    ],
    "universes": [
      {
        "id": 1,
        "name": "Earth-616"
      }
    ],
    "comic_events": [
      {
        "id": 1,
        "name": "San Diego Comic-Con",
        "slug": "sdcc",
        "type": "exclusive",
        "notes": "Signed",
        "display_order": 1
      }
    ],
    "key_issue_reasons": [
      {
        "id": 1,
        "name": "1st Appearance",
        "category": "appearance",
        "notes": "Cameo"
      }
    ],
    "availabilities": [
      {
        "id": 10,
        "provider": "midtown_comics",
        "provider_label": "Midtown Comics",
        "kind": "buy",
        "store_name": "Midtown Comics",
        "custom_name": "Signed edition",
        "display_name": "Midtown Comics",
        "store_logo": "/images/brands/midtown.png",
        "url": "https://www.midtowncomics.com/...",
        "external_id": "12345",
        "price": 19.99,
        "formatted_price": "$19.99",
        "currency": "USD",
        "verified_at": "2026-01-01T00:00:00+00:00"
      }
    ],
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    }
  },
  "suggested_variant_id": 789,
  "variants": [
    {
      "variant_id": 789,
      "variant_name": "Cover B",
      "cover_url": "https://...",
      "upc": "75960608936700121",
      "lunar_code": "0518MA0102",
      "universal_code": "DC10251017",
      "diamond_code": "MAY180902"
    }
  ]
}

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.