Marvel Public API v1

Base URI

http://gateway.marvel.com:80/v1/public
Documentation
Getting started

Welcome to the world’s greatest comics API!

The Marvel Comics API is a tool to help developers everywhere create amazing, uncanny and incredible web sites and applications using data from the 70-plus years of the Marvel age of comics.

Ready to get started? Great!

Here’s the short version of what you need to do:

  • Sign up: Get an API key
  • Be a good API citizen: read, understand, and abide by the terms of use for the Marvel Comics API
  • Link back: observe the attribution and linking guidelines when displaying data from the API
  • Keep in touch: tell us about what you’re building and talk to other developers on our community page
  • Build cool stuff

Finally, remember that the Marvel API suite and portal are in beta and this is an evolving project.
To the extent that it is possible, we will try to communicate changes to the API before they occur and will try to limit any modifications which cause backwards incompatible changes to applications.

General API Information

The Marvel Comics API is a RESTful service which provides methods for accessing specific resources at canonical URLs and for searching and filtering sets of resources by various criteria.
All representations are encoded as JSON objects.

Service Endpoint

The Marvel Comics API’s base endpoint is http(s)://gateway.marvel.com/.

Resources

You can access six resource types using the API:

  • Comics: individual print and digital comic issues, collections and graphic novels. For example: Amazing Fantasy #15.
  • Comic series: sequentially numbered (well, mostly sequentially numbered) groups comics with the same title. For example, Uncanny X-Men.
  • Comic stories: indivisible, reusable components of comics. For example, the cover from Amazing Fantasy #15 or the origin of Spider-Man story from that comic.
  • Comic events and crossovers: big, universe-altering storylines. For example, Infinity
  • Creators: women, men and organizations who create comics. For example, Jack Kirby.
  • Characters: the women, men, organizations, alien species, deities, animals, non-corporeal entities, trans-dimensional manifestations, abstract personifications,
  • and green amorphous blobs which occupy the Marvel Universe (and various alternate universes, timelines and altered realities therein).
  • For example, Spider-Man.

All the entity types are described in detail in our overview of entity types and representations.

Authentication

All requests to the APIs must be authenticated using the methods outlined in the request signing and authentication guidelines. Requests which fail authentication generally pass a 401 HTTP code and an error describing the reason for rejection.

Authorizing and signing requests

We want to ensure that calls made with your keys come from your applications. In order to help keep your keys from being used improperly, please follow the security and request signing guidelines below.

Using your keys

All calls to the Marvel Comics API must pass your public key via an apikey parameter.

Client-side and server-side applications have slightly different authentication rules in order to access the API. Please read below for the appropriate method for your application.

Please keep your private key private! Do not store your private key in publicly available code or repositories that are accessible to the public. Do not accidentally leave it at the bar.

Authentication for Client-Side Applications

Requests from client-side (browser-based) applications must originate from a pre-authorized web site or browser extension URL.

You may add or edit your authorized domains in your API account panel. You may use the “*” wildcard to denote subdomains or paths. For example:

Authentication for Server-Side Applications

Server-side applications must pass two parameters in addition to the apikey parameter:

  • ts - a timestamp (or other long string which can change on a request-by-request basis)
  • hash - a md5 digest of the ts parameter, your private key and your public key (e.g. md5(ts+privateKey+publicKey) For example, a user with a public key of “1234” and a private key of "abcd" could construct a valid call as follows: http://gateway.marvel.com/v1/comics/?ts=1&apikey=1234&hash=ffd275c5130566a2916217b101f26150 (the hash value is the md5 digest of 1abcd1234)
Authorization Errors

The following errors are returned by the Marvel Comics API when issues with authorization occur. These errors are returned by all endpoints.

Error Code Error Message Reason for occurring
409 Missing API Key Occurs when the apikey parameter is not included with a request.
409 Missing Hash Occurs when an apikey parameter is included with a request, a ts parameter is present , but no hash parameter is sent. Occurs on server-side applications only.
409 Missing Timestamp Occurs when an apikey parameter is included with a request, a hash parameter is present, but no ts parameter is sent. Occurs on server-side applications only.
401 Invalid Referer Occurs when a referrer which is not valid for the passed apikey parameter is sent.
401 Invalid Hash Occurs when a ts, hash and apikey parameter are sent but the hash is not valid per the above hash generation rule.
405 Method Not Allowed Occurs when an API endpoint is accessed using an HTTP verb which is not allowed for that endpoint.
403 Forbidden Occurs when a user with an otherwise authenticated request attempts to access an endpoint to which they do not have access.
HTTP Verbs

All endpoints currently accept only HTTP GET requests.

ETags

Most successful results will contain an etag attribute and ETag HTTP header with a digest of the returned content. In order to save bandwidth and make your application more performant, you may optionally pass an if-none-match HTTP header with that digest for subsequent requests to the same URL. If the content has not changed since the last request, the response code will return with an empty body and a 304/Not Modified HTTP header and you can use a previously-stored value for the content.

Note: Most browsers will do this automatically, but you may need to manually add this logic to server-side applications.

For example:

Initial request:

Request Url: http://gateway.marvel.com/v1/public/comics 
Request Method: GET 
Params: 
    {   
       "apikey": "your api key",   
       "ts": "a timestamp",   
       "hash": "your hash" 
    } 
    
Headers: 
    {   
        Accept: */* 
    }

Initial response:

    Status Code: 200 
    Access-Control-Allow-Origin: * 
    Date: Wed, 18 Dec 2013 22:00:55 GMT Connection: keep-alive 
    ETag: f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3 
    Content-Length: 54943 
    Content-Type: application/json

Subsequent request:

    Request Url: http://gateway.marvel.com/v1/public/comics 
    Request Method: GET 
    Params: 
        {   
            "apikey": "your api key",   
            "ts": "a timestamp",  
            "hash": "your hash" 
        } 
    Headers: 
        {   
            Accept: */*   
            If-None-Match: f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3 
        }

Subsequent response:

Status Code: 304 
Access-Control-Allow-Origin: * 
Date: Wed, 18 Dec 2013 22:03:20 GMT Connection: keep-alive 
ETag: f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3
Cross-origin requests and JSONP

Responses returned by the Marvel Comics API are compliant with the W3C CORS specification, which allows any properly-authorized requests to be made from any origin domain. This means that you should not need to wrap calls in JSONP callbacks in order to make calls from browser-based applications. If you do prefer to use JSONP, however, all endpoints will accept a callback parameter to all endpoints that will wrap results in a JSONP wrapper.

Examples

Without a callback:

    Request: GET http://gateway.marvel.com/v1/public/comics?apikey=yourAPIKEY 
    Response:  
        {   
            "code": 200,   
            "status": "Ok",   
            "etag": "f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3",   
            "data": 
                { 
                    … [other data points] 
                }
        }        

With a callback:

Request: GET http://gateway.marvel.com/v1/public/comics?apikey=yourAPIKEY&callback=callback_param
Response:  
    callback_param({
        "code": 200,   
        "status": "Ok",   
        "etag": "f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3",   
        "data": {   … [other data points] }
    })

GZIP Compression

In order to save bandwidth and make your application more performant, the Marvel Comics API can compress responses with GZIP. You may request a GZIP-ed response by passing an Accept-Encoding header to any endpoint.

Example:

Request:

Request Url: http://gateway.marvel.com/v1/public/comics 
Request Method: GET 
Params: 
    {   
        "apikey": "your api key",   
        "ts": "a timestamp",   
        "hash": "your hash" 
    } 
Headers: 
    {   
        Accept-Encoding:gzip
    }

Response:

    Status Code: 200 
    Access-Control-Allow-Origin: * 
    Date: Wed, 18 Dec 2013 22:03:20 GMT 
    Connection: keep-alive 
    ETag: f0fbae65eb2f8f28bdeea0a29be8749a4e67acb3 
    Content-Encoding: gzip
Errors

If a call to an API endpoint fails, the API will return an error object with the following format:

Attribute Type Description
code number the http status code of the error
status string a description of the error
API Methods
Characters

Characters are people and organizations which appear in comics. They are also assigned to stories initially and bubbled up to issues, series and events.

GET /characters
GET /characters/{characterId}
GET /characters/{characterId}/comics
GET /characters/{characterId}/events
GET /characters/{characterId}/series
GET /characters/{characterId}/stories
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 OK
Character by Id
GET /characters/{characterId}

Fetches a single character by id.

Path variables

characterId
string required

A single character id.

Responses

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 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 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 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 OK
Comics

Comic issues (or just comics) are the physical or digital products that end-users read. (The Marvel Comics API returns comic issues, collections, graphic novels and digital comics as part of the overall comics endpoint and entity type.)

GET /comics
GET /comics/{comicId}
GET /comics/{comicId}/characters
GET /comics/{comicId}/creators
GET /comics/{comicId}/events
GET /comics/{comicId}/stories
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 OK
Comic by Id
GET /comics/{comicId}

Fetches a single comic by id.

Path variables

comicId
string required

A single comic.

Responses

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 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 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 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 OK
Creators

Creators are the people and entities that make comics. They are assigned to the specific comic stories on which they worked, but we bubble up those assignments to the issues, series and events in which the stories appear as a convenience.

GET /creators
GET /creators/{creatorId}
GET /creators/{creatorId}/comics
GET /creators/{creatorId}/events
GET /creators/{creatorId}/series
GET /creators/{creatorId}/stories
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 OK
Creator by Id
GET /creators/{creatorId}

Fetches a single creator by id.

Path variables

creatorId
string required

A single creator id.

Responses

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 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 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 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 OK
Events

Comics can also be a part of an event, which is a big, universe-changing storyline. A comic’s appearance in an event is often independent of its membership in a series.

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
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 OK
Event by Id
GET /events/{eventId}

Fetches a single event by id.

Path variables

eventId
string required

A single event.

Responses

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 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 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 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 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 OK
Series

Comics belong to a series, which is a (usually) sequentially number list of comics with the same title and volume. Marvel uses the year of original publication for a series as the volume number.

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
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 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 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 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 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 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 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 OK
Stories

Comics are made up of stories, which are indivisible components of comics. Most comics have two stories - a cover and an interior story - but many, such as anthology comics and collections, will have more. Stories may be re-published in several comics, but the comic in which they originally appeared will always be present as a data point.

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 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 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 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 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 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 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 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 OK
Data Reference
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.

Types: CreatorList
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).

Types: StoryList
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.

Types: Comic
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).

Types: Comic
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.

The results returned by the call.

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

The representative image for this creator.

series

A resource list containing the series which feature work by this creator.

stories

A resource list containing the stories which feature work by this creator.

comics

A resource list containing the comics which feature work by this creator.

events

A resource list containing the events which feature work by this creator.

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

The representative image for this event.

comics

A resource list containing the comics in this event.

stories

A resource list containing the stories in this event.

series

A resource list containing the series in this event.

characters

A resource list containing the characters which appear in this event.

creators

A resource list containing creators whose work appears in this event.

A summary representation of the event which follows this event.

previous

A summary representation of the event which preceded this event.

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.

Types: Comic
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.

The results returned by the call.

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.

The results returned by the call.

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

The representative image for this character.

comics

A resource list containing comics which feature this character.

stories

A resource list of stories in which this character appears.

events

A resource list of events in which this character appears.

series

A resource list of series in which this character appears.

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.

The results returned by the call.

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.

The results returned by the call.

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

The representative image for this series.

comics

A resource list containing comics in this series.

stories

A resource list containing stories which occur in comics in this series.

events

A resource list containing events which take place in comics in this series.

characters

A resource list containing characters which appear in comics in this series.

creators

A resource list of creators whose work appears in comics in this series.

A summary representation of the series which follows this series.

previous

A summary representation of the series which preceded this series.

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.

The results returned by the call.

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.

A summary representation of the series to which this comic belongs.

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

The representative image for this comic.

images
Array of Image

A list of promotional images associated with this comic.

creators

A resource list containing the creators associated with this comic.

characters

A resource list containing the characters which appear in this comic.

stories

A resource list containing the stories which appear in this comic.

events

A resource list containing the events in which this comic appears.

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

The representative image for this story.

comics

A resource list containing comics in which this story takes place.

series

A resource list containing series in which this story appears.

events

A resource list of the events in which this story appears.

characters

A resource list of characters which appear in this story.

creators

A resource list of creators who worked on this story.

originalissue

A summary representation of the issue in which this story was originally published.

Common Wrapper

Results returned by the API endpoints have the same general format, no matter which entity type the endpoint returns. Every successful call will return a wrapper object, which contains metadata about the call and a container object, which displays pagination information and an array of the results returned by this call. This pattern is consistent even if you are requesting a single object.

Wrappers for successful calls have the following format:

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

Methods: List characters