description:Return characters with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only characters which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only characters which appear in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only characters which appear the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only characters which appear in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only characters which appear the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- -name
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Exclude variant comics from the result set.
required:false
schema:
type:boolean
- name:dateDescriptor
in:query
description:Return comics within a predefined date range.
required:false
schema:
type:string
enum:
- lastWeek
- thisWeek
- nextWeek
- thisMonth
- name:dateRange
in:query
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:string
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
schema:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only comics which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only comics which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description:Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description:Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- issueNumber
- modified
- onSaleDate
- focDate
- title
- -issueNumber
- -modified
- -onSaleDate
- -focDate
- -title
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only events which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only events which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:comics
in:query
description:Return only events which take place in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only events which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- startDate
- -name
- -modified
- -startDate
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only series matching the specified start year.
required:false
schema:
type:integer
- name:modifiedSince
in:query
description:Return only series which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only series which contain the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only series which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:seriesType
in:query
description:Filter the series by publication frequency type.
required:false
schema:
type:string
enum:
- collection
- one shot
- limited
- ongoing
- name:contains
in:query
description:Return only series containing one or more comics with the specified format.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- comic
- magazine
- trade paperback
- hardcover
- digest
- graphic novel
- digital comic
- infinite comic
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- modified
- startYear
- -title
- -modified
- -startYear
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained in the specified (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only stories contained the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only stories which take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:"Exclude variants (alternate covers, secondary printings, director's cuts, etc.) from the result set."
required:false
schema:
type:boolean
- name:dateDescriptor
in:query
description:Return comics within a predefined date range.
required:false
schema:
type:string
enum:
- lastWeek
- thisWeek
- nextWeek
- thisMonth
- name:dateRange
in:query
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:string
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
schema:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only comics which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only comics which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only comics which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- issueNumber
- modified
- onSaleDate
- focDate
- title
- -issueNumber
- -modified
- -onSaleDate
- -focDate
- -title
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return characters with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only characters which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:series
in:query
description:Return only characters which appear the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only characters which appear the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- -name
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:"Filter by creator names that match critera"
example:B
required:false
schema:
type:string
- name:firstNameStartsWith
in:query
description:"Filter by creator first names that match critera"
example:B
required:false
schema:
type:string
- name:middleNameStartsWith
in:query
description:Filter by creator middle names that match criteria.
example:Mi
required:false
schema:
type:string
- name:lastNameStartsWith
in:query
description:Filter by creator last names that match criteria.
example:Ben
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only creators which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only creators who worked on the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- firstName
- middleName
- lastName
- suffix
- modified
- -firstName
- -middleName
- -lastName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only events which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only events which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only events which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only events which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- startDate
- -name
- -modified
- -startDate
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only stories which take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only stories which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources.
description:Filter by creator names that match criteria.
example:B
required:false
schema:
type:string
- name:firstNameStartsWith
in:query
description:Filter by creator first names that match criteria.
example:B
required:false
schema:
type:string
- name:middleNameStartsWith
in:query
description:Filter by creator middle names that match criteria.
example:Mi
required:false
schema:
type:string
- name:lastNameStartsWith
in:query
description:Filter by creator last names that match criteria.
example:Ben
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only creators which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only creators who worked on the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- firstName
- middleName
- lastName
- suffix
- modified
- -firstName
- -middleName
- -lastName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:string
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:characters
in:query
description:Return only comics which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only comics which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only comics which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description:Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description:Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- issueNumber
- modified
- onSaleDate
- focDate
- -title
- -issueNumber
- -modified
- -onSaleDate
- -focDate
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:characters
in:query
description:Return only events which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only events which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:comics
in:query
description:Return only events which take place in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only events which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- startDate
- -name
- -modified
- -startDate
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only series matching the specified start year.
required:false
schema:
type:integer
- name:modifiedSince
in:query
description:Return only series which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only series which contain the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only series which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only series which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:seriesType
in:query
description:Filter the series by publication frequency type.
required:false
schema:
type:string
enum:
- collection
- one shot
- limited
- ongoing
- name:contains
in:query
description:Return only series containing one or more comics with the specified format.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- comic
- magazine
- trade paperback
- hardcover
- digest
- graphic novel
- digital comic
- infinite comic
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- startYear
- modified
- -title
- -startYear
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only stories contained the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only stories which take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only stories which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only events which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only events which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only events which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:comics
in:query
description:Return only events which take place in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only events which take place in the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- startDate
- -name
- -modified
- -startDate
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return characters with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only characters which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only characters which appear in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only characters which appear the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only characters which appear the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- -name
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Exclude variant comics from the result set.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:dateDescriptor
in:query
description:Return comics within a predefined date range.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastWeek
- thisWeek
- nextWeek
- thisMonth
- name:dateRange
in:query
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:string
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only comics which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only comics which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only comics which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description:Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description:Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- focDate
- onSaleDate
- title
- issueNumber
- modified
- -focDate
- -onSaleDate
- -title
- -issueNumber
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Filter by creator names that match criteria.
example:B
required:false
schema:
type:string
- name:firstNameStartsWith
in:query
description:Filter by creator first names that match criteria.
example:B
required:false
schema:
type:string
- name:middleNameStartsWith
in:query
description:Filter by creator middle names that match criteria.
example:Mi
required:false
schema:
type:string
- name:lastNameStartsWith
in:query
description:Filter by creator last names that match criteria.
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only creators which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only creators who worked on the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastName
- firstName
- middleName
- suffix
- modified
- -lastName
- -firstName
- -middleName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only series matching the specified start year.
required:false
schema:
type:integer
- name:modifiedSince
in:query
description:Return only series which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only series which contain the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only series which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only series which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:seriesType
in:query
description:Filter the series by publication frequency type.
required:false
schema:
type:string
enum:
- collection
- one shot
- limited
- ongoing
- name:contains
in:query
description:Return only series containing one or more comics with the specified format.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- comic
- magazine
- trade paperback
- hardcover
- digest
- graphic novel
- digital comic
- infinite comic
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- modified
- startYear
- -title
- -modified
- -startYear
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained in the specified (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only stories contained the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only stories which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only series matching the specified start year.
required:false
schema:
type:integer
- name:modifiedSince
in:query
description:Return only series which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only series which contain the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only series which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only series which have comics that take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only series which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:seriesType
in:query
description:Filter the series by publication frequency type.
required:false
schema:
type:string
enum:
- collection
- one shot
- limited
- ongoing
- name:contains
in:query
description:Return only series containing one or more comics with the specified format.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- comic
- magazine
- trade paperback
- hardcover
- digest
- graphic novel
- digital comic
- infinite comic
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- modified
- startYear
- -title
- -modified
- -startYear
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return characters with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only characters which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only characters which appear in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only characters which appear the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- -name
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Exclude variant comics from the result set.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:dateDescriptor
in:query
description:Return comics within a predefined date range.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastWeek
- thisWeek
- nextWeek
- thisMonth
- name:dateRange
in:query
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:string
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only comics which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only comics which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description:Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description:Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- focDate
- onsaleDate
- title
- issueNumber
- modified
- -focDate
- -onsaleDate
- -title
- -issueNumber
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Filter by creator names that match criteria.
example:B
required:false
schema:
type:string
- name:firstNameStartsWith
in:query
description:Filter by creator first names that match criteria.
example:B
required:false
schema:
type:string
- name:middleNameStartsWith
in:query
description:Filter by creator middle names that match criteria.
example:Mi
required:false
schema:
type:string
- name:lastNameStartsWith
in:query
description:Filter by creator last names that match criteria.
example:Ben
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only creators which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastName
- firstName
- middleName
- suffix
- modified
- -lastName
- -firstName
- -middleName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only events which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only events which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:comics
in:query
description:Return only events which take place in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:stories
in:query
description:Return only events which contain the specified stories (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- startDate
- modified
- -name
- -startDate
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained in the specified (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only stories which take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only stories which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only stories contained in the specified (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only stories contained the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only stories which take place during the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only stories which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- id
- modified
- -id
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return characters with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only characters which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only characters which appear in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only characters which appear the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only characters which appear comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- name
- modified
- -name
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Exclude variant comics from the result set.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:dateDescriptor
in:query
description:Return comics within a predefined date range.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastWeek
- thisWeek
- nextWeek
- thisMonth
- name:dateRange
in:query
description:Return comics within a predefined date range. Dates must be specified as date1,date2. Dates are preferably formatted as YYYY-MM-DD but may be sent as any common date format.
example:2013-01-01,2013-01-02
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:title
in:query
description:Return only issues in series whose title matches the input.
required:false
schema:
type:string
- name:titleStartsWith
in:query
description:Return only issues in series whose title starts with the input.
required:false
schema:
type:string
- name:startYear
in:query
description:Return only issues in series whose start year matches the input.
required:false
schema:
type:integer
- name:issueNumber
in:query
description:Return only issues in series whose issue number matches the input.
required:false
schema:
type:integer
- name:diamondCode
in:query
description:Filter by diamond code.
required:false
schema:
type:string
- name:digitalId
in:query
description:Filter by digital comic id.
required:false
schema:
type:integer
- name:upc
in:query
description:Filter by UPC.
required:false
schema:
type:string
- name:isbn
in:query
description:Filter by ISBN.
required:false
schema:
type:string
- name:ean
in:query
description:Filter by EAN.
required:false
schema:
type:string
- name:issn
in:query
description:Filter by ISSN.
required:false
schema:
type:string
- name:hasDigitalIssue
in:query
description:Include only results which are available digitally.
required:false
style:form
explode:false
schema:
type:array
items:
type:boolean
- name:modifiedSince
in:query
description:Return only comics which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only comics which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only comics which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only comics which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only comics which take place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:sharedAppearances
in:query
description:Return only comics in which the specified characters appear together (for example in which BOTH Spider-Man and Wolverine appear).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:collaborators
in:query
description:Return only comics in which the specified creators worked together (for example in which BOTH Stan Lee and Jack Kirby did work).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- focDate
- onsaleDate
- title
- issueNumber
- modified
- -focDate
- -onsaleDate
- -title
- -issueNumber
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Filter by creator names that match criteria.
example:B
required:false
schema:
type:string
- name:firstNameStartsWith
in:query
description:Filter by creator first names that match criteria.
example:B
required:false
schema:
type:string
- name:middleNameStartsWith
in:query
description:Filter by creator middle names that match criteria.
example:Mi
required:false
schema:
type:string
- name:lastNameStartsWith
in:query
description:Filter by creator last names that match criteria.
example:Ben
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only creators which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only creators who worked on in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only creators who worked on the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:events
in:query
description:Return only creators who worked on comics that took place in the specified events (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastName
- firstName
- middleName
- suffix
- modified
- -lastName
- -firstName
- -middleName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return events with names that begin with the specified string.
example:Sp
required:false
schema:
type:string
- name:modifiedSince
in:query
description:Return only events which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:creators
in:query
description:Return only events which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only events which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:series
in:query
description:Return only events which are part of the specified series (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:comics
in:query
description:Return only events which take place in the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- lastName
- firstName
- middleName
- suffix
- modified
- -lastName
- -firstName
- -middleName
- -suffix
- -modified
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:Return only series matching the specified start year.
required:false
schema:
type:integer
- name:modifiedSince
in:query
description:Return only series which have been modified since the specified date.
required:false
schema:
type:string
format:date
- name:comics
in:query
description:Return only series which contain the specified comics (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:creators
in:query
description:Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:characters
in:query
description:Return only series which feature the specified characters (accepts a comma-separated list of ids).
required:false
style:form
explode:false
schema:
type:array
items:
type:integer
- name:seriesType
in:query
description:Filter the series by publication frequency type.
required:false
schema:
type:string
enum:
- collection
- one shot
- limited
- ongoing
- name:contains
in:query
description:Return only series containing one or more comics with the specified format.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- comic
- magazine
- trade paperback
- hardcover
- digest
- graphic novel
- digital comic
- infinite comic
- name:orderBy
in:query
description: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.
required:false
style:form
explode:false
schema:
type:array
items:
type:string
enum:
- title
- modified
- startYear
- -title
- -modified
- -startYear
- name:limit
in:query
description:Limit the result set to the specified number of resources.
required:false
schema:
type:integer
minimum:1
maximum:100
- name:offset
in:query
description:Skip the specified number of resources in the result set.
description:A character resource type that represents 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 as well as various alternate universes, timelines and altered realities therein (e.g. Spider-Man).
description:A comic book resource type that represents physical or digital products that end-users read. This definition includes individual print and digital comic issues, collections and graphic novels (e.g. Amazing Fantasy \#15).
description:A creator resource type that represents women, men and organizations who create comics (e.g. Jack Kirby). 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.
description:An event resource type that represents big, universe-altering storylines (e.g. Infinity). A comic's appearance in an event is often independent of its membership in a series.
description:A series resource type that represents (usually) sequentially number list of comics with the same title and volume (e.g. Uncanny X-Men). Marvel uses the year of original publication for a series as the volume number.
description:A story resource type that represents an indivisible, reusable components of comics. Most comics have two stories - a cover and an interior story (e. g. the cover from Amazing Fantasy \#15 and the origin of Spider-Man story from that comic) - 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.
description:The copyright notice for the returned result.
attributionText:
type:string
description: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:
type:string
description: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.
description:A digest value of the content returned by the call.
required:
- code
- status
- copyright
- attributionText
- attributionHTML
- data
- etag
ComicDataWrapper:
type:object
description:The wrapper for the comic data.
properties:
code:
type:integer
description:The HTTP status code of the returned result.
status:
type:string
description:A string description of the call status.
copyright:
type:string
description:The copyright notice for the returned result.
attributionText:
type:string
description: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:
type:string
description: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.
data:
$ref:'#/components/schemas/ComicDataContainer'
etag:
type:string
description:A digest value of the content returned by the call.
required:
- code
- status
- copyright
- attributionText
- attributionHTML
- data
- etag
CreatorDataWrapper:
type:object
description:The wrapper for the creator data.
properties:
code:
type:integer
description:The HTTP status code of the returned result.
status:
type:string
description:A string description of the call status.
copyright:
type:string
description:The copyright notice for the returned result.
attributionText:
type:string
description: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:
type:string
description: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.
data:
$ref:'#/components/schemas/CreatorDataContainer'
etag:
type:string
description:A digest value of the content returned by the call.
required:
- code
- status
- copyright
- attributionText
- attributionHTML
- data
- etag
EventDataWrapper:
type:object
description:The wrapper for the event data.
properties:
code:
type:integer
description:The HTTP status code of the returned result.
status:
type:string
description:A string description of the call status.
copyright:
type:string
description:The copyright notice for the returned result.
attributionText:
type:string
description: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.
description: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.
data:
$ref:'#/components/schemas/EventDataContainer'
etag:
type:string
description:A digest value of the content returned by the call.
description:The HTTP status code of the returned result.
status:
type:string
description:A string description of the call status.
copyright:
type:string
description:The copyright notice for the returned result.
attributionText:
type:string
description: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:
type:string
description: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.
data:
$ref:'#/components/schemas/SeriesDataContainer'
etag:
type:string
description:A digest value of the content returned by the call.
required:
- code
- status
- copyright
- attributionText
- attributionHTML
- data
- etag
StoryDataWrapper:
type:object
description:The wrapper for the story data.
properties:
code:
type:integer
description:The HTTP status code of the returned result.
status:
type:string
description:A string description of the call status.
copyright:
type:string
description:The copyright notice for the returned result.
attributionText:
type:string
description: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:
type:string
description: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.
data:
$ref:'#/components/schemas/StoryDataContainer'
etag:
type:string
description:A digest value of the content returned by the call.
required:
- code
- status
- copyright
- attributionText
- attributionHTML
- data
- etag
# Common Structures
ComicDate:
type:object
description:A type that represents a date and time for which the comic was released.
description:A type that represents a price (e.g. print price, digital price) for the comic.
properties:
type:
type:string
description:A description of the price (e.g. print price, digital price).
price:
type:number
description:The price (all prices in USD).
format:float
required:
- type
- price
Image:
type:object
description:A type that represents an image for a resource.
properties:
path:
type:string
description:The directory path of to the image.
extension:
type:string
description:The file extension for the image.
required:
- path
- extension
TextObject:
type:object
description:A type that represents bits of descriptive text which are attached to an entity.
properties:
type:
type:string
description:The canonical type of the text object (e.g. solicit text, preview text, etc.).
language:
type:string
description:The IETF language tag (or language code) denoting which language the text object is written in.
text:
type:string
description:The text of the text object.
required:
- type
- language
- text
Url:
type:object
description:A type that represents a reference to web pages or deep links into applications. When present in a resultset, it is preferred that you use these to link back to Marvel. Many resources will have more than one representation on the web so URLs are generally presented as an array of URL resources.
properties:
type:
type:string
description:A text identifier for the URL.
url:
type:string
description:A full URL (including scheme, domain, and path).
