Skip to content
VerseDB

Teams

Endpoints for browsing superhero teams and their members.

List all teams with optional search

GET/api/v1/teams
Requires a token

Returns a paginated list of teams. Use q to search by team name.

Query parameters

qstring

Search by team name.

Example: "avengers"

character_idsstring

Comma-separated character IDs. Returns a team every one of them has been a member of.

Example: "55,204"

statusstring

Filter by status: active (never disbanded) or disbanded.

Example: "active"

sortstring

Sort field (name, formation_date, cached_characters_count, cached_issues_count). Passing sort replaces the relevance ordering applied to q results.

Example: "cached_characters_count"

directionstring

Sort direction (asc, desc).

Example: "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: 12

data[].namestring or nullrequired

Example: "Avengers"

data[].slugstring or nullrequired

Example: "avengers"

data[].aliasesarray of stringsrequired

Example: ["Earth's Mightiest Heroes"]

data[].headquartersstring or nullrequired

Example: "Avengers Tower, New York City"

data[].members_countintegerrequired

Example: 42

data[].appearances_countinteger

Present when the team has an appearance count.

Example: 1250

data[].image_urlstring or nullrequired

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

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

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

data[].images.profile_mdstring

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

data[].images.full_lgstring

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

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"

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

Example response 200

{
  "data": [
    {
      "id": 12,
      "name": "Avengers",
      "slug": "avengers",
      "aliases": [
        "Earth's Mightiest Heroes"
      ],
      "headquarters": "Avengers Tower, New York City",
      "members_count": 42,
      "appearances_count": 1250,
      "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"
      },
      "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
  }
}

Get a specific team

GET/api/v1/teams/{team_id}
Requires a token

Returns team details without relationship data. Use the relationship endpoints for related data:

  • /teams/{id}/characters - Get team members
  • /teams/{id}/series - Get team's series appearances
  • /teams/{id}/issues - Get team's issue appearances

Path parameters

team_idintegerrequired

The ID of the team.

Example: 78

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

data.namestring or nullrequired

Example: "Avengers"

data.slugstring or nullrequired

Example: "avengers"

data.aliasesarray of stringsrequired

Example: ["Earth's Mightiest Heroes"]

data.formation_datestring or nullrequired

Example: "1963-09-01"

data.disbanded_datestring or nullrequired

Example: null

data.headquartersstring or nullrequired

Example: "Avengers Tower, New York"

data.members_countintegerrequired

Example: 312

data.series_countintegerrequired

Example: 48

data.appearances_countintegerrequired

Example: 5200

data.lists_countintegerrequired

Example: 86

data.image_urlstring or nullrequired

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

data.imagesobject or nullrequired
data.images.tile_smstring

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

data.images.profile_mdstring

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

data.images.full_lgstring

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

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"

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

Not Found

messagestringrequired

Example: "No query results for model [App\\Models\\Team] 78"

Example body, from the documented examples

{
  "message": "No query results for model [App\\Models\\Team] 78"
}
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/teams/78' \
  --header 'Authorization: Bearer {YOUR_AUTH_KEY}' \
  --header 'Accept: application/json'

Example response 200

{
  "data": {
    "id": 78,
    "name": "Avengers",
    "slug": "avengers",
    "aliases": [
      "Earth's Mightiest Heroes"
    ],
    "formation_date": "1963-09-01",
    "disbanded_date": null,
    "headquarters": "Avengers Tower, New York",
    "members_count": 312,
    "series_count": 48,
    "appearances_count": 5200,
    "lists_count": 86,
    "image_url": "https://...-full_lg.webp",
    "images": {
      "tile_sm": "https://...-tile_sm.webp",
      "profile_md": "https://...-profile_md.webp",
      "full_lg": "https://...-full_lg.webp"
    },
    "name_i18n": {
      "ja": {
        "value": "講談社",
        "reading": "こうだんしゃ",
        "source": "madb"
      }
    },
    "aliases_i18n": {
      "en": [
        "Kodansha Comics"
      ]
    },
    "original_locale": "en"
  }
}

Get characters for a specific team (members)

GET/api/v1/teams/{team_id}/characters
Requires a token

Returns the team's character roster, by name unless sort says otherwise.

Path parameters

team_idintegerrequired

The ID of the team.

Example: 78

Query parameters

qstring

Optional search within the team's members. Results come back in relevance order unless sort is passed.

Example: "uncanny"

sortstring

Sort field (name, cached_issues_count, joined_date). Defaults to name.

Example: "cached_issues_count"

directionstring

Sort direction (asc, desc).

Example: "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: 456

data[].namestring or nullrequired

Example: "Spider-Man (Peter Parker)"

data[].slugstring or nullrequired

Example: "spider-man-peter-parker"

data[].real_namestring or nullrequired

Example: "Peter Parker"

data[].aliasesarray of stringsrequired

Example: ["Spidey","Web-Head"]

data[].racestring or nullrequired

Example: "Human"

data[].image_urlstring or nullrequired

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

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

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

data[].images.profile_mdstring

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

data[].images.full_lgstring

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

data[].appearances_countintegerrequired

Example: 5400

data[].publisher_namestring or null

Present when the character has a publisher.

Example: "Marvel 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 entity is from, a BCP 47 tag.

Example: "en"

data[].real_name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

data[].pivot_rolestring

Present when the membership has a role.

Example: "Leader"

data[].pivot_joined_datestring

Present when the membership has a join date.

Example: "1963-09-01"

data[].pivot_left_datestring

Present when the membership has an end date.

Example: "1990-01-01"

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

Example response 200

{
  "data": [
    {
      "id": 456,
      "name": "Spider-Man (Peter Parker)",
      "slug": "spider-man-peter-parker",
      "real_name": "Peter Parker",
      "aliases": [
        "Spidey",
        "Web-Head"
      ],
      "race": "Human",
      "image_url": "https://...-full_lg.webp",
      "images": {
        "tile_sm": "https://...-tile_sm.webp",
        "profile_md": "https://...-profile_md.webp",
        "full_lg": "https://...-full_lg.webp"
      },
      "appearances_count": 5400,
      "publisher_name": "Marvel Comics",
      "name_i18n": {
        "ja": {
          "value": "講談社",
          "reading": "こうだんしゃ",
          "source": "madb"
        }
      },
      "aliases_i18n": {
        "en": [
          "Kodansha Comics"
        ]
      },
      "original_locale": "en",
      "real_name_i18n": {
        "ja": {
          "value": "講談社",
          "reading": "こうだんしゃ",
          "source": "madb"
        }
      },
      "pivot_role": "Leader",
      "pivot_joined_date": "1963-09-01",
      "pivot_left_date": "1990-01-01"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 25,
    "per_page": 20,
    "to": 20,
    "total": 500
  }
}

Get series for a specific team

GET/api/v1/teams/{team_id}/series
Requires a token

Returns the series the team appears in, newest start year first unless sort says otherwise.

Path parameters

team_idintegerrequired

The team ID.

Example: 10

Query parameters

qstring

Optional search within the team's series. Results come back in relevance order unless sort is passed.

Example: "uncanny"

sortstring

Sort field (start_year, name, cached_issues_count, average_rating, latest_release_date). Defaults to start_year.

Example: "start_year"

directionstring

Sort direction (asc, desc).

Example: "desc"

limitinteger

Number of results per page (max 50).

Example: 20

pageinteger

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

Example: 1

mediumstring

Comma-separated series mediums to filter by (comic, manga, manhwa, manhua, bande_dessinee, magazine).

Example: "comic,manga"

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

data[].title_idinteger or nullrequired

Example: 1

data[].namestring or nullrequired

Example: "The Amazing Spider-Man"

data[].display_namestringrequired

Example: "The Amazing Spider-Man (2018)"

data[].slugstring or nullrequired

Example: "amazing-spider-man-2018"

data[].numberinteger or nullrequired

Example: 6

data[].start_yearinteger or nullrequired

Example: 2018

data[].end_yearinteger or nullrequired

Example: 2022

data[].cover_urlstring or nullrequired

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

data[].imagesobject or nullrequired
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[].mediumstring or nullrequired

Example: "comic"

data[].publication_typestring or nullrequired

Example: "regular_series"

data[].formatstring or nullrequired

Example: "Standard"

data[].statusstring or nullrequired

Example: "Ongoing"

data[].original_namestring or nullrequired

Example: "The Amazing Spider-Man"

data[].original_languagestring or nullrequired

Example: "en"

data[].languagestring or nullrequired

Example: "en"

data[].cached_issues_countinteger or nullrequired

Example: 94

data[].average_ratingstring or nullrequired

Example: "4.25"

data[].total_reviewsinteger or nullrequired

Example: 12

data[].issues_average_ratingstring or nullrequired

Example: "4.10"

data[].issues_rated_countinteger or nullrequired

Example: 40

data[].content_rating_labelstring or nullrequired

Example: "Teen"

data[].min_ageinteger or nullrequired

Example: 13

data[].is_nsfwboolean or nullrequired
data[].publisher_namestring or nullrequired

Example: "Marvel"

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

Example: "ja"

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

Example response 200

{
  "data": [
    {
      "id": 123,
      "title_id": 1,
      "name": "The Amazing Spider-Man",
      "display_name": "The Amazing Spider-Man (2018)",
      "slug": "amazing-spider-man-2018",
      "number": 6,
      "start_year": 2018,
      "end_year": 2022,
      "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"
      },
      "medium": "comic",
      "publication_type": "regular_series",
      "format": "Standard",
      "status": "Ongoing",
      "original_name": "The Amazing Spider-Man",
      "original_language": "en",
      "language": "en",
      "cached_issues_count": 94,
      "average_rating": "4.25",
      "total_reviews": 12,
      "issues_average_rating": "4.10",
      "issues_rated_count": 40,
      "content_rating_label": "Teen",
      "min_age": 13,
      "publisher_name": "Marvel",
      "name_i18n": {
        "ja": {
          "value": "講談社",
          "reading": "こうだんしゃ",
          "source": "madb"
        }
      },
      "aliases_i18n": {
        "en": [
          "Kodansha Comics"
        ]
      },
      "original_locale": "ja"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 25,
    "per_page": 20,
    "to": 20,
    "total": 500
  }
}

Get issues for a specific team

GET/api/v1/teams/{team_id}/issues
Requires a token

Returns the issues the team appears in, newest release first unless sort says otherwise.

Path parameters

team_idintegerrequired

The team ID.

Example: 10

Query parameters

qstring

Optional search within the team's issues. Results come back in relevance order unless sort is passed.

Example: "uncanny"

sortstring

Sort field (release_date, cover_date, average_rating). Defaults to release_date.

Example: "release_date"

directionstring

Sort direction (asc, desc).

Example: "desc"

limitinteger

Number of results per page (max 50).

Example: 20

pageinteger

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

Example: 1

mediumstring

Comma-separated series mediums to filter by (comic, manga, manhwa, manhua, bande_dessinee, magazine).

Example: "comic,manga"

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: 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[].cover_datestring or nullrequired

Example: "2018-09-01"

data[].release_datestring or nullrequired

Example: "2018-07-11"

data[].foc_datestring or nullrequired

Example: "2018-06-18"

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_reprintbooleanrequired
data[].content_rating_labelstring or nullrequired

Example: "Teen"

data[].min_ageinteger or nullrequired

Example: 13

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

Example: 4.5

data[].name_i18nobjectrequired

One name per language, keyed by BCP 47 tag.

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.publication_typestring or nullrequired

Example: "regular_series"

data[].series.formatstring or nullrequired

Example: "Standard"

data[].series.cached_issues_countinteger or nullrequired

Example: 93

data[].series.cover_urlstring or nullrequired

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

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

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

data[].series.images.cover_mdstring

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

data[].series.images.cover_lgstring

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

data[].series.publisher_namestring or nullrequired

Example: "Marvel"

data[].pivot_issue_orderinteger or nullrequired

Example: null

data[].pivot_is_prologuebooleanrequired
data[].pivot_is_epiloguebooleanrequired
data[].pivot_is_tie_inbooleanrequired
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/teams/10/issues' \
  --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!",
      "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"
      },
      "pivot_issue_order": null
    }
  ],
  "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.