Marvel Public API v1

Operations
GET /characters
GET /characters/{characterId}
GET /characters/{characterId}/comics
GET /characters/{characterId}/events
GET /characters/{characterId}/series
GET /characters/{characterId}/stories
GET /comics
GET /comics/{comicId}
GET /comics/{comicId}/characters
GET /comics/{comicId}/creators
GET /comics/{comicId}/events
GET /comics/{comicId}/stories
GET /creators
GET /creators/{creatorId}
GET /creators/{creatorId}/comics
GET /creators/{creatorId}/events
GET /creators/{creatorId}/series
GET /creators/{creatorId}/stories
GET /events
GET /events/{eventId}
GET /events/{eventId}/characters
GET /events/{eventId}/comics
GET /events/{eventId}/creators
GET /events/{eventId}/series
GET /events/{eventId}/stories
GET /series
GET /series/{seriesId}
GET /series/{seriesId}/characters
GET /series/{seriesId}/comics
GET /series/{seriesId}/creators
GET /series/{seriesId}/events
GET /series/{seriesId}/stories
GET /stories
GET /stories/{storyId}
GET /stories/{storyId}/characters
GET /stories/{storyId}/comics
GET /stories/{storyId}/creators
GET /stories/{storyId}/events
GET /stories/{storyId}/series
List characters
GET /characters

Fetches lists of characters.

Request parameters

name
string optional

Return only characters matching the specified full character name (e.g. Spider-Man).

nameStartsWith
string optional

Return characters with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only characters which have been modified since the specified date.

comics
number optional

Return only characters which appear in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only characters which appear the specified series (accepts a comma-separated list of ids).

events
number optional

Return only characters which appear in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only characters which appear the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Body
Object
code
number

The HTTP status code of the returned result

Example:
200
status
string

A string description of the call status

Example:
Ok
etag
string

A digest value of the content

Example:
f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3
data
Object

The results returned by the call

offset
number

The requested offset (skipped results) of the call

Example:
0
limit
number

The requested result limit

Example:
20
total
number

The total number of results available

Example:
30920
count
number

The total number of results returned by this call

Example:
20
results
Object data_container

The list of entities returned by the call

copyright
string

The copyright notice for the returned result

attributionText
string

The attribution notice for this result

attributionHTML
string

An HTML representation of the attribution notice for this result

Character by Id
GET /characters/{characterId}

Fetches a single character by id.

Path variables

characterId
string required

A single character id.

Responses

200 200

OK

Character comics
GET /characters/{characterId}/comics

Fetches lists of comics filtered by a character id.

Path variables

characterId
string required

The character id.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variant comics from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

creators
number optional

Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).

series
number optional

Return only comics which are part of the specified series (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only comics which contain the specified stories (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Character events
GET /characters/{characterId}/events

Fetches lists of events filtered by a character id.

Path variables

characterId
string required

The character ID.

Request parameters

name
string optional

Filter the event list by name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

creators
number optional

Return only events which feature work by the specified creators (accepts a comma-separated list of ids).

series
number optional

Return only events which are part of the specified series (accepts a comma-separated list of ids).

comics
number optional

Return only events which take place in the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only events which contain the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Character series
GET /characters/{characterId}/series

Fetches lists of series filtered by a character id.

Path variables

characterId
string required

The character ID

Request parameters

title
string optional

Filter by series title.

titleStartsWith
string optional

Return series with titles that begin with the specified string (e.g. Sp).

startYear
number optional

Return only series matching the specified start year.

modifiedSince
string optional

Return only series which have been modified since the specified date.

comics
number optional

Return only series which contain the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only series which contain the specified stories (accepts a comma-separated list of ids).

events
number optional

Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only series which feature work by the specified creators (accepts a comma-separated list of ids).

seriesType
string optional

Filter the series by publication frequency type.

contains
string optional

Return only series containing one or more comics with the specified format.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Character stories
GET /characters/{characterId}/stories

Fetches lists of stories filtered by a character id.

Path variables

characterId
string required

The character ID.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

comics
number optional

Return only stories contained in the specified (accepts a comma-separated list of ids).

series
number optional

Return only stories contained the specified series (accepts a comma-separated list of ids).

events
number optional

Return only stories which take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

List comics
GET /comics

Fetches lists of comics.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variants (alternate covers, secondary printings, director’s cuts, etc.) from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

creators
number optional

Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only comics which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only comics which are part of the specified series (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only comics which contain the specified stories (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear). Accepts a comma-separated list of ids.

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work). Accepts a comma-separated list of ids.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Comic by Id
GET /comics/{comicId}

Fetches a single comic by id.

Path variables

comicId
string required

A single comic.

Responses

200 200

OK

Comic characters
GET /comics/{comicId}/characters

Fetches lists of characters filtered by a comic id.

Path variables

comicId
string required

The comic id.

Request parameters

name
string optional

Return only characters matching the specified full character name (e.g. Spider-Man).

nameStartsWith
string optional

Return characters with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only characters which have been modified since the specified date.

series
number optional

Return only characters which appear the specified series (accepts a comma-separated list of ids).

events
number optional

Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only characters which appear the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Comic creators
GET /comics/{comicId}/creators

Fetches lists of creators filtered by a comic id.

Path variables

comicId
string required

The comic id.

Request parameters

firstName
string optional

Filter by creator first name (e.g. brian).

middleName
string optional

Filter by creator middle name (e.g. Michael).

lastName
string optional

Filter by creator last name (e.g. Bendis).

suffix
string optional

Filter by suffix or honorific (e.g. Jr., Sr.).

nameStartsWith
string optional

Filter by creator names that match critera (e.g. B, St L).

firstNameStartsWith
string optional

Filter by creator first names that match critera (e.g. B, St L).

middleNameStartsWith
string optional

Filter by creator middle names that match critera (e.g. Mi).

lastNameStartsWith
string optional

Filter by creator last names that match critera (e.g. Ben).

modifiedSince
string optional

Return only creators which have been modified since the specified date.

comics
number optional

Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only creators who worked on the specified series (accepts a comma-separated list of ids).

stories
number optional

Return only creators who worked on the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Comic events
GET /comics/{comicId}/events

Fetches lists of events filtered by a comic id.

Path variables

comicId
string required

The comic ID.

Request parameters

name
string optional

Filter the event list by name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

creators
number optional

Return only events which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only events which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only events which are part of the specified series (accepts a comma-separated list of ids).

stories
number optional

Return only events which contain the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Comic stories
GET /comics/{comicId}/stories

Fetches lists of stories filtered by a comic id.

Path variables

comicId
string required

The comic ID.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

series
number optional

Return only stories contained the specified series (accepts a comma-separated list of ids).

events
number optional

Return only stories which take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only stories which feature the specified characters (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources.

Responses

200 200

OK

List creators
GET /creators

Fetches lists of creators.

Request parameters

firstName
string optional

Filter by creator first name (e.g. Brian).

middleName
string optional

Filter by creator middle name (e.g. Michael).

lastName
string optional

Filter by creator last name (e.g. Bendis).

suffix
string optional

Filter by suffix or honorific (e.g. Jr., Sr.).

nameStartsWith
string optional

Filter by creator names that match critera (e.g. B, St L).

firstNameStartsWith
string optional

Filter by creator first names that match critera (e.g. B, St L).

middleNameStartsWith
string optional

Filter by creator middle names that match critera (e.g. Mi).

lastNameStartsWith
string optional

Filter by creator last names that match critera (e.g. Ben).

modifiedSince
string optional

Return only creators which have been modified since the specified date.

comics
number optional

Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only creators who worked on the specified series (accepts a comma-separated list of ids).

events
number optional

Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only creators who worked on the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Creator by Id
GET /creators/{creatorId}

Fetches a single creator by id.

Path variables

creatorId
string required

A single creator id.

Responses

200 200

OK

Creator comics
GET /creators/{creatorId}/comics

Fetches lists of comics filtered by a creator id.

Path variables

creatorId
string required

The creator ID.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variant comics from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

characters
number optional

Return only comics which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only comics which are part of the specified series (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only comics which contain the specified stories (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Creator events
GET /creators/{creatorId}/events

Fetches lists of events filtered by a creator id.

Path variables

creatorId
string required

The creator ID.

Request parameters

name
string optional

Filter the event list by name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

characters
number optional

Return only events which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only events which are part of the specified series (accepts a comma-separated list of ids).

comics
number optional

Return only events which take place in the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only events which contain the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Creator series
GET /creators/{creatorId}/series

Fetches lists of series filtered by a creator id.

Path variables

creatorId
string required

The creator ID.

Request parameters

title
string optional

Filter by series title.

titleStartsWith
string optional

Return series with titles that begin with the specified string (e.g. Sp).

startYear
number optional

Return only series matching the specified start year.

modifiedSince
string optional

Return only series which have been modified since the specified date.

comics
number optional

Return only series which contain the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only series which contain the specified stories (accepts a comma-separated list of ids).

events
number optional

Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).

characters
number optional

Return only series which feature the specified characters (accepts a comma-separated list of ids).

seriesType
string optional

Filter the series by publication frequency type.

contains
string optional

Return only series containing one or more comics with the specified format.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Creator stories
GET /creators/{creatorId}/stories

Fetches lists of stories filtered by a creator id.

Path variables

creatorId
string required

The ID of the creator.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

comics
number optional

Return only stories contained in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only stories contained the specified series (accepts a comma-separated list of ids).

events
number optional

Return only stories which take place during the specified events (accepts a comma-separated list of ids).

characters
number optional

Return only stories which feature the specified characters (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

List events
GET /events

Fetches lists of events.

Request parameters

name
string optional

Return only events which match the specified name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

creators
number optional

Return only events which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only events which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only events which are part of the specified series (accepts a comma-separated list of ids).

comics
number optional

Return only events which take place in the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only events which take place in the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Event by Id
GET /events/{eventId}

Fetches a single event by id.

Path variables

eventId
string required

A single event.

Responses

200 200

OK

Event characters
GET /events/{eventId}/characters

Fetches lists of characters filtered by an event id.

Path variables

eventId
string required

The event ID

Request parameters

name
string optional

Return only characters matching the specified full character name (e.g. Spider-Man).

nameStartsWith
string optional

Return characters with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only characters which have been modified since the specified date.

comics
number optional

Return only characters which appear in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only characters which appear the specified series (accepts a comma-separated list of ids).

stories
number optional

Return only characters which appear the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Event comics
GET /events/{eventId}/comics

Fetches lists of comics filtered by an event id.

Path variables

eventId
string required

The event id.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variant comics from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

creators
number optional

Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only comics which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only comics which are part of the specified series (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only comics which contain the specified stories (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Event creators
GET /events/{eventId}/creators

Fetches lists of creators filtered by an event id.

Path variables

eventId
string required

The event ID.

Request parameters

firstName
string optional

Filter by creator first name (e.g. brian).

middleName
string optional

Filter by creator middle name (e.g. Michael).

lastName
string optional

Filter by creator last name (e.g. Bendis).

suffix
string optional

Filter by suffix or honorific (e.g. Jr., Sr.).

nameStartsWith
string optional

Filter by creator names that match critera (e.g. B, St L).

firstNameStartsWith
string optional

Filter by creator first names that match critera (e.g. B, St L).

middleNameStartsWith
string optional

Filter by creator middle names that match critera (e.g. Mi).

lastNameStartsWith
string optional

Filter by creator last names that match critera (e.g. Ben).

modifiedSince
string optional

Return only creators which have been modified since the specified date.

comics
number optional

Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only creators who worked on the specified series (accepts a comma-separated list of ids).

stories
number optional

Return only creators who worked on the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Event series
GET /events/{eventId}/series

Fetches lists of series filtered by an event id.

Path variables

eventId
string required

The event ID.

Request parameters

title
string optional

Filter by series title.

titleStartsWith
string optional

Return series with titles that begin with the specified string (e.g. Sp).

startYear
number optional

Return only series matching the specified start year.

modifiedSince
string optional

Return only series which have been modified since the specified date.

comics
number optional

Return only series which contain the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only series which contain the specified stories (accepts a comma-separated list of ids).

creators
number optional

Return only series which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only series which feature the specified characters (accepts a comma-separated list of ids).

seriesType
string optional

Filter the series by publication frequency type.

contains
string optional

Return only series containing one or more comics with the specified format.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Event stories
GET /events/{eventId}/stories

Fetches lists of stories filtered by an event id.

Path variables

eventId
string required

The ID of the event.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

comics
number optional

Return only stories contained in the specified (accepts a comma-separated list of ids).

series
number optional

Return only stories contained the specified series (accepts a comma-separated list of ids).

creators
number optional

Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only stories which feature the specified characters (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

List series
GET /series

Fetches lists of series.

Request parameters

title
string optional

Return only series matching the specified title.

titleStartsWith
string optional

Return series with titles that begin with the specified string (e.g. Sp).

startYear
number optional

Return only series matching the specified start year.

modifiedSince
string optional

Return only series which have been modified since the specified date.

comics
number optional

Return only series which contain the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only series which contain the specified stories (accepts a comma-separated list of ids).

events
number optional

Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only series which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only series which feature the specified characters (accepts a comma-separated list of ids).

seriesType
string optional

Filter the series by publication frequency type.

contains
string optional

Return only series containing one or more comics with the specified format.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Series by id
GET /series/{seriesId}

Fetches a single comic series by id.

Path variables

seriesId
string required

Filter by series title.

Responses

200 200

OK

Series characters
GET /series/{seriesId}/characters

Fetches lists of characters filtered by a series id.

Path variables

seriesId
string required

The series id.

Request parameters

name
string optional

Return only characters matching the specified full character name (e.g. Spider-Man).

nameStartsWith
string optional

Return characters with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only characters which have been modified since the specified date.

comics
number optional

Return only characters which appear in the specified comics (accepts a comma-separated list of ids).

events
number optional

Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only characters which appear the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Series comics
GET /series/{seriesId}/comics

Fetches lists of comics filtered by a series id.

Path variables

seriesId
string required

The series ID.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variant comics from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

creators
number optional

Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only comics which feature the specified characters (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only comics which contain the specified stories (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Series creators
GET /series/{seriesId}/creators

Fetches lists of creators filtered by a series id.

Path variables

seriesId
string required

The series ID.

Request parameters

firstName
string optional

Filter by creator first name (e.g. brian).

middleName
string optional

Filter by creator middle name (e.g. Michael).

lastName
string optional

Filter by creator last name (e.g. Bendis).

suffix
string optional

Filter by suffix or honorific (e.g. Jr., Sr.).

nameStartsWith
string optional

Filter by creator names that match critera (e.g. B, St L).

firstNameStartsWith
string optional

Filter by creator first names that match critera (e.g. B, St L).

middleNameStartsWith
string optional

Filter by creator middle names that match critera (e.g. Mi).

lastNameStartsWith
string optional

Filter by creator last names that match critera (e.g. Ben).

modifiedSince
string optional

Return only creators which have been modified since the specified date.

comics
number optional

Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).

events
number optional

Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).

stories
number optional

Return only creators who worked on the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Series events
GET /series/{seriesId}/events

Fetches lists of events filtered by a series id.

Path variables

seriesId
string required

The series ID.

Request parameters

name
string optional

Filter the event list by name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

creators
number optional

Return only events which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only events which feature the specified characters (accepts a comma-separated list of ids).

comics
number optional

Return only events which take place in the specified comics (accepts a comma-separated list of ids).

stories
number optional

Return only events which contain the specified stories (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Series stories
GET /series/{seriesId}/stories

Fetches lists of stories filtered by a series id.

Path variables

seriesId
string required

The series ID.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

comics
number optional

Return only stories contained in the specified (accepts a comma-separated list of ids).

events
number optional

Return only stories which take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only stories which feature the specified characters (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

List stories
GET /stories

Fetches lists of stories.

Request parameters

modifiedSince
string optional

Return only stories which have been modified since the specified date.

comics
number optional

Return only stories contained in the specified (accepts a comma-separated list of ids).

series
number optional

Return only stories contained the specified series (accepts a comma-separated list of ids).

events
number optional

Return only stories which take place during the specified events (accepts a comma-separated list of ids).

creators
number optional

Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only stories which feature the specified characters (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Story by Id
GET /stories/{storyId}

Fetches a single comic story by id.

Path variables

storyId
string required

Filter by story id.

Responses

200 200

OK

Story characters
GET /stories/{storyId}/characters

Fetches lists of characters filtered by a story id.

Path variables

storyId
string required

The story ID.

Request parameters

name
string optional

Return only characters matching the specified full character name (e.g. Spider-Man).

nameStartsWith
string optional

Return characters with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only characters which have been modified since the specified date.

comics
number optional

Return only characters which appear in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only characters which appear the specified series (accepts a comma-separated list of ids).

events
number optional

Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Story comics
GET /stories/{storyId}/comics

Fetches lists of comics filtered by a story id.

Path variables

storyId
string required

The story ID.

Request parameters

format
string optional

Filter by the issue format (e.g. comic, digital comic, hardcover).

formatType
string optional

Filter by the issue format type (comic or collection).

noVariants
boolean optional

Exclude variant comics from the result set.

dateDescriptor
string optional

Return comics within a predefined date range.

dateRange
number optional

Return comics within a predefined date range. Dates must be specified as date1,date2 (e.g. 2013-01-01,2013-01-02). Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.

diamondCode
string optional

Filter by diamond code.

digitalId
number optional

Filter by digital comic id.

upc
string optional

Filter by UPC.

isbn
string optional

Filter by ISBN.

ean
string optional

Filter by EAN.

issn
string optional

Filter by ISSN.

hasDigitalIssue
boolean optional

Include only results which are available digitally.

modifiedSince
string optional

Return only comics which have been modified since the specified date.

creators
number optional

Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only comics which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only comics which are part of the specified series (accepts a comma-separated list of ids).

events
number optional

Return only comics which take place in the specified events (accepts a comma-separated list of ids).

sharedAppearances
number optional

Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).

collaborators
number optional

Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Story creators
GET /stories/{storyId}/creators

Fetches lists of creators filtered by a story id.

Path variables

storyId
string required

The story ID.

Request parameters

firstName
string optional

Filter by creator first name (e.g. brian).

middleName
string optional

Filter by creator middle name (e.g. Michael).

lastName
string optional

Filter by creator last name (e.g. Bendis).

suffix
string optional

Filter by suffix or honorific (e.g. Jr., Sr.).

nameStartsWith
string optional

Filter by creator names that match critera (e.g. B, St L).

firstNameStartsWith
string optional

Filter by creator first names that match critera (e.g. B, St L).

middleNameStartsWith
string optional

Filter by creator middle names that match critera (e.g. Mi).

lastNameStartsWith
string optional

Filter by creator last names that match critera (e.g. Ben).

modifiedSince
string optional

Return only creators which have been modified since the specified date.

comics
number optional

Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).

series
number optional

Return only creators who worked on the specified series (accepts a comma-separated list of ids).

events
number optional

Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Story events
GET /stories/{storyId}/events

Fetches lists of events filtered by a story id.

Path variables

storyId
string required

The story ID.

Request parameters

name
string optional

Filter the event list by name.

nameStartsWith
string optional

Return events with names that begin with the specified string (e.g. Sp).

modifiedSince
string optional

Return only events which have been modified since the specified date.

creators
number optional

Return only events which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only events which feature the specified characters (accepts a comma-separated list of ids).

series
number optional

Return only events which are part of the specified series (accepts a comma-separated list of ids).

comics
number optional

Return only events which take place in the specified comics (accepts a comma-separated list of ids).

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Story series
GET /stories/{storyId}/series

Fetches lists of series filtered by a story id.

Path variables

storyId
string required

The story ID.

Request parameters

events
number optional

Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).

title
string optional

Filter by series title.

titleStartsWith
string optional

Return series with titles that begin with the specified string (e.g. Sp).

startYear
number optional

Return only series matching the specified start year.

modifiedSince
string optional

Return only series which have been modified since the specified date.

comics
number optional

Return only series which contain the specified comics (accepts a comma-separated list of ids).

creators
number optional

Return only series which feature work by the specified creators (accepts a comma-separated list of ids).

characters
number optional

Return only series which feature the specified characters (accepts a comma-separated list of ids).

seriesType
string optional

Filter the series by publication frequency type.

contains
string optional

Return only series containing one or more comics with the specified format.

orderBy
string optional

Order the result set by a field or fields. Add a “-” to the value sort in descending order. Multiple values are given priority in the order in which they are passed.

limit
number optional

Limit the result set to the specified number of resources.

offset
number optional

Skip the specified number of resources in the result set.

Responses

200 200

OK

Type Definitions
ComicList
Object
available
number

The number of total available issues in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of issues returned in this collection (up to 20).

collectionURI
string

The path to the full list of issues in this collection.

items
Array of ComicSummary

The list of returned issues in this collection.

EventList
Object
available
number

The number of total available events in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of events returned in this collection (up to 20).

collectionURI
string

The path to the full list of events in this collection.

items
Array of EventSummary

The list of returned events in this collection.

CreatorList
Object
available
number

The number of total available creators in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of creators returned in this collection (up to 20).

collectionURI
string

The path to the full list of creators in this collection.

items
Array of CreatorSummary

The list of returned creators in this collection.

CharacterList
Object
available
number

The number of total available characters in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of characters returned in this collection (up to 20).

collectionURI
string

The path to the full list of characters in this collection.

items

The list of returned characters in this collection.

SeriesList
Object
available
number

The number of total available series in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of series returned in this collection (up to 20).

collectionURI
string

The path to the full list of series in this collection.

items
Array of SeriesSummary

The list of returned series in this collection.

StoryList
Object
available
number

The number of total available stories in this list. Will always be greater than or equal to the “returned” value.

returned
number

The number of stories returned in this collection (up to 20).

collectionURI
string

The path to the full list of stories in this collection.

items
Array of StorySummary

The list of returned stories in this collection.

CharacterSummary
Object
resourceURI
string

The path to the individual character resource.

name
string

The full name of the character.

role
string

The role of the creator in the parent entity.

EventSummary
Object
resourceURI
string

The path to the individual event resource.

name
string

The name of the event.

SeriesSummary
Object
resourceURI
string

The path to the individual series resource.

name
string

The canonical name of the series.

ComicSummary
Object
resourceURI
string

The path to the individual comic resource.

name
string

The canonical name of the comic.

Url
Object
type
string

A text identifier for the URL.

url
string

A full URL (including scheme, domain, and path).

CreatorSummary
Object
resourceURI
string

The path to the individual creator resource.

name
string

The full name of the creator.

role
string

The role of the creator in the parent entity.

StorySummary
Object
resourceURI
string

The path to the individual story resource.

name
string

The canonical name of the story.

type
string

The type of the story (interior or cover).

Image
Object
path
string

The directory path of to the image.

extension
string

The file extension for the image.

ComicDate
Object
type
string

A description of the date (e.g. onsale date, FOC date).

date
string

The date.

CharacterDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Character

The list of characters returned by the call.

EventDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Event

The list of events returned by the call

ComicPrice
Object
type
string

A description of the price (e.g. print price, digital price).

price
number

The price (all prices in USD).

EventDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

Creator
Object
id
number

The unique ID of the creator resource.

firstName
string

The first name of the creator.

middleName
string

The middle name of the creator.

lastName
string

The last name of the creator.

suffix
string

The suffix or honorific for the creator.

fullName
string

The full name of the creator (a space-separated concatenation of the above four fields).

modified
string

The date the resource was most recently modified.

resourceURI
string

The canonical URL identifier for this resource.

urls
Array of Url

A set of public web site URLs for the resource.

thumbnail
series
stories
comics
events
Event
Object
id
number

The unique ID of the event resource.

title
string

The title of the event.

description
string

A description of the event.

resourceURI
string

The canonical URL identifier for this resource.

urls
Array of Url

A set of public web site URLs for the event.

modified
string

The date the resource was most recently modified.

start
string

The date of publication of the first issue in this event.

end
string

The date of publication of the last issue in this event.

thumbnail
comics
stories
series
characters
creators
previous
ComicDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Comic

The list of comics returned by the call

TextObject
Object
type
string

The canonical type of the text object (e.g. solicit text, preview text, etc.).

language
string

The IETF language tag denoting the language the text object is written in.

text
string

The text.

CreatorDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

StoryDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

Character
Object
id
number

The unique ID of the character resource.

name
string

The name of the character.

description
string

A short bio or description of the character.

modified
string

The date the resource was most recently modified.

resourceURI
string

The canonical URL identifier for this resource.

urls
Array of Url

A set of public web site URLs for the resource.

thumbnail
comics
stories
events
series
CharacterDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

ComicDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

Series
Object
id
number

The unique ID of the series resource.

title
string

The canonical title of the series.

description
string

A description of the series.

resourceURI
string

The canonical URL identifier for this resource.

urls
Array of Url

A set of public web site URLs for the resource.

startYear
number

The first year of publication for the series.

endYear
number

The last year of publication for the series (conventionally, 2099 for ongoing series) .

rating
string

The age-appropriateness rating for the series.

modified
string

The date the resource was most recently modified.

thumbnail
comics
stories
events
characters
creators
previous
SeriesDataWrapper
Object
code
number

The HTTP status code of the returned result.

status
string

A string description of the call status.

copyright
string

The copyright notice for the returned result.

attributionText
string

The attribution notice for this result. Please display either this notice or the contents of the attributionHTML field on all screens which contain data from the Marvel Comics API.

attributionHTML
string

An HTML representation of the attribution notice for this result. Please display either this notice or the contents of the attributionText field on all screens which contain data from the Marvel Comics API.

etag
string

A digest value of the content returned by the call.

SeriesDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Series

The list of series returned by the call

StoryDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Story

The list of stories returned by the call

Comic
Object
id
number

The unique ID of the comic resource.

digitalId
number

The ID of the digital comic representation of this comic. Will be 0 if the comic is not available digitally.

title
string

The canonical title of the comic.

issueNumber
number

The number of the issue in the series (will generally be 0 for collection formats).

variantDescription
string

If the issue is a variant (e.g. an alternate cover, second printing, or director’s cut), a text description of the variant.

description
string

The preferred description of the comic.

modified
string

The date the resource was most recently modified.

isbn
string

The ISBN for the comic (generally only populated for collection formats).

upc
string

The UPC barcode number for the comic (generally only populated for periodical formats).

diamondCode
string

The Diamond code for the comic.

ean
string

The EAN barcode for the comic.

issn
string

The ISSN barcode for the comic.

format
string

The publication format of the comic e.g. comic, hardcover, trade paperback.

pageCount
number

The number of story pages in the comic.

textObjects
Array of TextObject

A set of descriptive text blurbs for the comic.

resourceURI
string

The canonical URL identifier for this resource.

urls
Array of Url

A set of public web site URLs for the resource.

variants
Array of ComicSummary

A list of variant issues for this comic (includes the “original” issue if the current issue is a variant).

collections
Array of ComicSummary

A list of collections which include this comic (will generally be empty if the comic’s format is a collection).

collectedIssues
Array of ComicSummary

A list of issues collected in this comic (will generally be empty for periodical formats such as “comic” or “magazine”).

dates
Array of ComicDate

A list of key dates for this comic.

prices
Array of ComicPrice

A list of prices for this comic.

thumbnail
images
Array of Image

A list of promotional images associated with this comic.

creators
characters
stories
events
CreatorDataContainer
Object
offset
number

The requested offset (number of skipped results) of the call.

limit
number

The requested result limit.

total
number

The total number of resources available given the current filter set.

count
number

The total number of results returned by this call.

results
Array of Creator

The list of creators returned by the call.

Story
Object
id
number

The unique ID of the story resource.

title
string

The story title.

description
string

A short description of the story.

resourceURI
string

The canonical URL identifier for this resource.

type
string

The story type e.g. interior story, cover, text story.

modified
string

The date the resource was most recently modified.

thumbnail
comics
series
events
characters
creators
originalissue