Skip to content
VerseDB

Imprints

Endpoints for browsing comic book imprints (publisher sub-brands, e.g., Vertigo under DC, Icon under Marvel).

Get imprint details

GET/api/v1/imprints/{imprint_id}
Requires a token

Returns: id, name, slug, publisher, series_count, titles_count

Path parameters

imprint_idintegerrequired

The ID of the imprint.

Example: 1

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

data.namestring or nullrequired

Example: "Vertigo"

data.slugstring or nullrequired

Example: "vertigo"

data.publisherobject or nullrequired
data.publisher.idintegerrequired

Example: 2

data.publisher.namestring or nullrequired

Example: "DC Comics"

data.publisher.slugstring or nullrequired

Example: "dc-comics"

data.series_countintegerrequired

Example: 240

data.titles_countintegerrequired

Example: 180

data.created_atstring or nullrequired

Example: "2024-01-15T10:30:00.000000Z"

data.updated_atstring or nullrequired

Example: "2024-01-15T10:30:00.000000Z"

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 imprint is from, a BCP 47 tag.

Example: "en"

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/imprints/1' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 1,
    "name": "Vertigo",
    "slug": "vertigo",
    "publisher": {
      "id": 2,
      "name": "DC Comics",
      "slug": "dc-comics"
    },
    "series_count": 240,
    "titles_count": 180,
    "created_at": "2024-01-15T10:30:00.000000Z",
    "updated_at": "2024-01-15T10:30:00.000000Z",
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    },
    "aliases_i18n": {
      "en": [
        "Kodansha Comics"
      ]
    },
    "original_locale": "en"
  }
}

List imprints

GET/api/v1/imprints
Requires a token

Returns: id, name, slug, publisher

Query parameters

qstring

Search by imprint name, tolerating small typos.

Example: "vertigo"

publisher_idinteger

Filter by publisher ID.

Example: 2

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

data[].namestring or nullrequired

Example: "Vertigo"

data[].slugstring or nullrequired

Example: "vertigo"

data[].publisherobject or nullrequired
data[].publisher.idintegerrequired

Example: 2

data[].publisher.namestring or nullrequired

Example: "DC Comics"

data[].publisher.slugstring or nullrequired

Example: "dc-comics"

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 imprint is from, a BCP 47 tag.

Example: "en"

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/imprints' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": [
    {
      "id": 7,
      "name": "Vertigo",
      "slug": "vertigo",
      "publisher": {
        "id": 2,
        "name": "DC Comics",
        "slug": "dc-comics"
      },
      "name_i18n": {
        "ja": {
          "value": "講談社",
          "reading": "こうだんしゃ",
          "source": "madb"
        }
      },
      "aliases_i18n": {
        "en": [
          "Kodansha Comics"
        ]
      },
      "original_locale": "en"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 25,
    "per_page": 20,
    "to": 20,
    "total": 500
  }
}

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.