swagger.yaml

---
swagger: "2.0"
info:
  version: Cable
  title: gateway.marvel.com
host: gateway.marvel.com
basePath: /
tags:
- name: public
schemes:
- http
paths:
  /v1/public/characters:
    get:
      tags:
      - public
      summary: Fetches lists of characters.
      description: Fetches lists of comic characters with optional filters. See notes on individual parameters below.
      operationId: getCreatorCollection
      parameters:
      - name: name
        in: query
        description: Return only characters matching the specified full character name (e.g. Spider-Man).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return characters with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only characters which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only characters which appear the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only characters which appear in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only characters which appear the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/characters/{characterId}:
    get:
      tags:
      - public
      summary: Fetches a single character by id.
      description: This method fetches a single character resource.  It is the canonical URI for any character resource provided by the API.
      operationId: getCharacterIndividual
      parameters:
      - name: characterId
        in: path
        description: A single character id.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/characters/{characterId}/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics filtered by a character id.
      description: Fetches lists of comics containing a specific character, with optional filters. See notes on individual parameters below.
      operationId: getComicsFilteredByCharacter
      parameters:
      - name: characterId
        in: path
        description: The character id.
        required: true
        type: integer
        format: int32
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variant comics from the result set.
        required: false
        type: boolean
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: string
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: boolean
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only comics which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only comics which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/characters/{characterId}/events:
    get:
      tags:
      - public
      summary: Fetches lists of events filtered by a character id.
      description: Fetches lists of events in which a specific character appears, with optional filters. See notes on individual parameters below.
      operationId: getCharacterEventsCollection
      parameters:
      - name: characterId
        in: path
        description: The character ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Filter the event list by name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only events which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: comics
        in: query
        description: Return only events which take place in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only events which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/characters/{characterId}/series:
    get:
      tags:
      - public
      summary: Fetches lists of series filtered by a character id.
      description: Fetches lists of comic series in which a specific character appears, with optional filters. See notes on individual parameters below.
      operationId: getCharacterSeriesCollection
      parameters:
      - name: characterId
        in: path
        description: The character ID
        required: true
        type: integer
        format: int32
      - name: title
        in: query
        description: Filter by series title.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return series with titles that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only series matching the specified start year.
        required: false
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only series which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only series which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: seriesType
        in: query
        description: Filter the series by publication frequency type.
        required: false
        type: string
      - name: contains
        in: query
        description: Return only series containing one or more comics with the specified format.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
  /v1/public/characters/{characterId}/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories filtered by a character id.
      description: Fetches lists of comic stories  featuring a specific character with optional filters. See notes on individual parameters below.
      operationId: getCharacterStoryCollection
      parameters:
      - name: characterId
        in: path
        description: The character ID.
        required: true
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: comics
        in: query
        description: Return only stories contained in the specified (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only stories contained the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only stories which take place during the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics.
      description: Fetches lists of comics with optional filters. See notes on individual parameters below.
      operationId: getComics
      parameters:
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variants (alternate covers, secondary printings, director's cuts, etc.) from the result set.
        required: false
        type: boolean
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: string
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: boolean
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only comics which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only comics which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only comics which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/comics/{comicId}:
    get:
      tags:
      - public
      summary: Fetches a single comic by id.
      description: This method fetches a single comic resource.  It is the canonical URI for any comic resource provided by the API.
      operationId: getComicIndividual
      parameters:
      - name: comicId
        in: path
        description: A single comic.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/comics/{comicId}/characters:
    get:
      tags:
      - public
      summary: Fetches lists of characters filtered by a comic id.
      description: Fetches lists of characters which appear in a specific comic with optional filters. See notes on individual parameters below.
      operationId: getComicCharacterCollection
      parameters:
      - name: comicId
        in: path
        description: The comic id.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Return only characters matching the specified full character name (e.g. Spider-Man).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return characters with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only characters which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only characters which appear the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/comics/{comicId}/creators:
    get:
      tags:
      - public
      summary: Fetches lists of creators filtered by a comic id.
      description: Fetches lists of comic creators whose work appears in a specific comic, with optional filters. See notes on individual parameters below.
      operationId: getCreatorsFilteredByComic
      parameters:
      - name: comicId
        in: path
        description: The comic id.
        required: true
        type: integer
        format: int32
      - name: firstName
        in: query
        description: Filter by creator first name (e.g. brian).
        required: false
        type: string
      - name: middleName
        in: query
        description: Filter by creator middle name (e.g. Michael).
        required: false
        type: string
      - name: lastName
        in: query
        description: Filter by creator last name (e.g. Bendis).
        required: false
        type: string
      - name: suffix
        in: query
        description: Filter by suffix or honorific (e.g. Jr., Sr.).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Filter by creator names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: firstNameStartsWith
        in: query
        description: Filter by creator first names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: middleNameStartsWith
        in: query
        description: Filter by creator middle names that match critera (e.g. Mi).
        required: false
        type: string
      - name: lastNameStartsWith
        in: query
        description: Filter by creator last names that match critera (e.g. Ben).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only creators which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only creators who worked on the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/comics/{comicId}/events:
    get:
      tags:
      - public
      summary: Fetches lists of events filtered by a comic id.
      description: Fetches lists of events in which a specific comic appears, with optional filters. See notes on individual parameters below.
      operationId: getIssueEventsCollection
      parameters:
      - name: comicId
        in: path
        description: The comic ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Filter the event list by name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only events which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only events which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only events which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/comics/{comicId}/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories filtered by a comic id.
      description: Fetches lists of comic stories in a specific comic issue, with optional filters. See notes on individual parameters below.
      operationId: getComicStoryCollection
      parameters:
      - name: comicId
        in: path
        description: The comic ID.
        required: true
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: series
        in: query
        description: Return only stories contained the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only stories which take place during the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only stories which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/creators:
    get:
      tags:
      - public
      summary: Fetches lists of creators.
      description: Fetches lists of comic creators with optional filters. See notes on individual parameters below.
      operationId: getCreators
      parameters:
      - name: firstName
        in: query
        description: Filter by creator first name (e.g. Brian).
        required: false
        type: string
      - name: middleName
        in: query
        description: Filter by creator middle name (e.g. Michael).
        required: false
        type: string
      - name: lastName
        in: query
        description: Filter by creator last name (e.g. Bendis).
        required: false
        type: string
      - name: suffix
        in: query
        description: Filter by suffix or honorific (e.g. Jr., Sr.).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Filter by creator names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: firstNameStartsWith
        in: query
        description: Filter by creator first names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: middleNameStartsWith
        in: query
        description: Filter by creator middle names that match critera (e.g. Mi).
        required: false
        type: string
      - name: lastNameStartsWith
        in: query
        description: Filter by creator last names that match critera (e.g. Ben).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only creators which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only creators who worked on the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/creators/{creatorId}:
    get:
      tags:
      - public
      summary: Fetches a single creator by id.
      description: This method fetches a single creator resource.  It is the canonical URI for any creator resource provided by the API.
      operationId: getCreatorIndividual
      parameters:
      - name: creatorId
        in: path
        description: A single creator id.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/creators/{creatorId}/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics filtered by a creator id.
      description: Fetches lists of comics in which the work of a specific creator appears, with optional filters. See notes on individual parameters below.
      operationId: getComicsFilteredByCreator
      parameters:
      - name: creatorId
        in: path
        description: The creator ID.
        required: true
        type: integer
        format: int32
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variant comics from the result set.
        required: false
        type: boolean
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: string
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only comics which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only comics which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/creators/{creatorId}/events:
    get:
      tags:
      - public
      summary: Fetches lists of events filtered by a creator id.
      description: Fetches lists of events featuring the work of a specific creator with optional filters. See notes on individual parameters below.
      operationId: getCreatorEventsCollection
      parameters:
      - name: creatorId
        in: path
        description: The creator ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Filter the event list by name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only events which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: comics
        in: query
        description: Return only events which take place in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only events which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/creators/{creatorId}/series:
    get:
      tags:
      - public
      summary: Fetches lists of series filtered by a creator id.
      description: Fetches lists of comic series in which a specific creator's work appears, with optional filters. See notes on individual parameters below.
      operationId: getCreatorSeriesCollection
      parameters:
      - name: creatorId
        in: path
        description: The creator ID.
        required: true
        type: integer
        format: int32
      - name: title
        in: query
        description: Filter by series title.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return series with titles that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only series matching the specified start year.
        required: false
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only series which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only series which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only series which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: seriesType
        in: query
        description: Filter the series by publication frequency type.
        required: false
        type: string
      - name: contains
        in: query
        description: Return only series containing one or more comics with the specified format.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
  /v1/public/creators/{creatorId}/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories filtered by a creator id.
      description: Fetches lists of comic stories by a specific creator with optional filters. See notes on individual parameters below.
      operationId: getCreatorStoryCollection
      parameters:
      - name: creatorId
        in: path
        description: The ID of the creator.
        required: true
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: comics
        in: query
        description: Return only stories contained in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only stories contained the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only stories which take place during the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only stories which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/events:
    get:
      tags:
      - public
      summary: Fetches lists of events.
      description: Fetches lists of events with optional filters. See notes on individual parameters below.
      operationId: getEventsCollection
      parameters:
      - name: name
        in: query
        description: Return only events which match the specified name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only events which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only events which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: comics
        in: query
        description: Return only events which take place in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only events which take place in the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/events/{eventId}:
    get:
      tags:
      - public
      summary: Fetches a single event by id.
      description: This method fetches a single event resource.  It is the canonical URI for any event resource provided by the API.
      operationId: getEventIndividual
      parameters:
      - name: eventId
        in: path
        description: A single event.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/events/{eventId}/characters:
    get:
      tags:
      - public
      summary: Fetches lists of characters filtered by an event id.
      description: Fetches lists of characters which appear in a specific event, with optional filters. See notes on individual parameters below.
      operationId: getEventCharacterCollection
      parameters:
      - name: eventId
        in: path
        description: The event ID
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Return only characters matching the specified full character name (e.g. Spider-Man).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return characters with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only characters which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only characters which appear the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only characters which appear the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/events/{eventId}/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics filtered by an event id.
      description: Fetches lists of comics which take place during a specific event, with optional filters. See notes on individual parameters below.
      operationId: getComicsFilteredByEvent
      parameters:
      - name: eventId
        in: path
        description: The event id.
        required: true
        type: integer
        format: int32
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variant comics from the result set.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only comics which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only comics which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only comics which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/events/{eventId}/creators:
    get:
      tags:
      - public
      summary: Fetches lists of creators filtered by an event id.
      description: Fetches lists of comic creators whose work appears in a specific event, with optional filters. See notes on individual parameters below.
      operationId: getEventsCreatorCollection
      parameters:
      - name: eventId
        in: path
        description: The event ID.
        required: true
        type: integer
        format: int32
      - name: firstName
        in: query
        description: Filter by creator first name (e.g. brian).
        required: false
        type: string
      - name: middleName
        in: query
        description: Filter by creator middle name (e.g. Michael).
        required: false
        type: string
      - name: lastName
        in: query
        description: Filter by creator last name (e.g. Bendis).
        required: false
        type: string
      - name: suffix
        in: query
        description: Filter by suffix or honorific (e.g. Jr., Sr.).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Filter by creator names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: firstNameStartsWith
        in: query
        description: Filter by creator first names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: middleNameStartsWith
        in: query
        description: Filter by creator middle names that match critera (e.g. Mi).
        required: false
        type: string
      - name: lastNameStartsWith
        in: query
        description: Filter by creator last names that match critera (e.g. Ben).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only creators which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only creators who worked on the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/events/{eventId}/series:
    get:
      tags:
      - public
      summary: Fetches lists of series filtered by an event id.
      description: Fetches lists of comic series in which a specific event takes place, with optional filters. See notes on individual parameters below.
      operationId: getEventSeriesCollection
      parameters:
      - name: eventId
        in: path
        description: The event ID.
        required: true
        type: integer
        format: int32
      - name: title
        in: query
        description: Filter by series title.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return series with titles that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only series matching the specified start year.
        required: false
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only series which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only series which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only series which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: seriesType
        in: query
        description: Filter the series by publication frequency type.
        required: false
        type: string
      - name: contains
        in: query
        description: Return only series containing one or more comics with the specified format.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
  /v1/public/events/{eventId}/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories filtered by an event id.
      description: Fetches lists of comic stories from a specific event, with optional filters. See notes on individual parameters below.
      operationId: getEventStoryCollection
      parameters:
      - name: eventId
        in: path
        description: The ID of the event.
        required: true
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: comics
        in: query
        description: Return only stories contained in the specified (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only stories contained the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only stories which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/series:
    get:
      tags:
      - public
      summary: Fetches lists of series.
      description: Fetches lists of comic series with optional filters. See notes on individual parameters below.
      operationId: getSeriesCollection
      parameters:
      - name: title
        in: query
        description: Return only series matching the specified title.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return series with titles that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only series matching the specified start year.
        required: false
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only series which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only series which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only series which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: seriesType
        in: query
        description: Filter the series by publication frequency type.
        required: false
        type: string
      - name: contains
        in: query
        description: Return only series containing one or more comics with the specified format.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
  /v1/public/series/{seriesId}:
    get:
      tags:
      - public
      summary: Fetches a single comic series by id.
      description: This method fetches a single comic series resource.  It is the canonical URI for any comic series resource provided by the API.
      operationId: getSeriesIndividual
      parameters:
      - name: seriesId
        in: path
        description: Filter by series title.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
  /v1/public/series/{seriesId}/characters:
    get:
      tags:
      - public
      summary: Fetches lists of characters filtered by a series id.
      description: Fetches lists of characters which appear in specific series, with optional filters. See notes on individual parameters below.
      operationId: getSeriesCharacterWrapper
      parameters:
      - name: seriesId
        in: path
        description: The series id.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Return only characters matching the specified full character name (e.g. Spider-Man).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return characters with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only characters which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only characters which appear the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/series/{seriesId}/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics filtered by a series id.
      description: Fetches lists of comics which are published as part of a specific series, with optional filters. See notes on individual parameters below.
      operationId: getComicsFilteredBySeries
      parameters:
      - name: seriesId
        in: path
        description: The series ID.
        required: true
        type: integer
        format: int32
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variant comics from the result set.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only comics which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only comics which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/series/{seriesId}/creators:
    get:
      tags:
      - public
      summary: Fetches lists of creators filtered by a series id.
      description: Fetches lists of comic creators whose work appears in a specific series, with optional filters. See notes on individual parameters below.
      operationId: getSeriesCreatorCollection
      parameters:
      - name: seriesId
        in: path
        description: The series ID.
        required: true
        type: integer
        format: int32
      - name: firstName
        in: query
        description: Filter by creator first name (e.g. brian).
        required: false
        type: string
      - name: middleName
        in: query
        description: Filter by creator middle name (e.g. Michael).
        required: false
        type: string
      - name: lastName
        in: query
        description: Filter by creator last name (e.g. Bendis).
        required: false
        type: string
      - name: suffix
        in: query
        description: Filter by suffix or honorific (e.g. Jr., Sr.).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Filter by creator names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: firstNameStartsWith
        in: query
        description: Filter by creator first names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: middleNameStartsWith
        in: query
        description: Filter by creator middle names that match critera (e.g. Mi).
        required: false
        type: string
      - name: lastNameStartsWith
        in: query
        description: Filter by creator last names that match critera (e.g. Ben).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only creators which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only creators who worked on the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/series/{seriesId}/events:
    get:
      tags:
      - public
      summary: Fetches lists of events filtered by a series id.
      description: Fetches lists of events which occur in a specific series, with optional filters. See notes on individual parameters below.
      operationId: getEventsFilteredBySeries
      parameters:
      - name: seriesId
        in: path
        description: The series ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Filter the event list by name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only events which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: comics
        in: query
        description: Return only events which take place in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: stories
        in: query
        description: Return only events which contain the specified stories (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/series/{seriesId}/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories filtered by a series id.
      description: Fetches lists of comic stories from a specific series with optional filters. See notes on individual parameters below.
      operationId: getSeriesStoryCollection
      parameters:
      - name: seriesId
        in: path
        description: The series ID.
        required: true
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: comics
        in: query
        description: Return only stories contained in the specified (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only stories which take place during the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only stories which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/stories:
    get:
      tags:
      - public
      summary: Fetches lists of stories.
      description: Fetches lists of comic stories with optional filters. See notes on individual parameters below.
      operationId: getStoryCollection
      parameters:
      - name: modifiedSince
        in: query
        description: Return only stories which have been modified since the specified date.
        required: false
        type: string
        format: date
      - name: comics
        in: query
        description: Return only stories contained in the specified (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only stories contained the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only stories which take place during the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only stories which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only stories which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/stories/{storyId}:
    get:
      tags:
      - public
      summary: Fetches a single comic story by id.
      description: This method fetches a single comic story resource.  It is the canonical URI for any comic story resource provided by the API.
      operationId: getStoryIndividual
      parameters:
      - name: storyId
        in: path
        description: Filter by story id.
        required: true
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/StoryDataWrapper'
  /v1/public/stories/{storyId}/characters:
    get:
      tags:
      - public
      summary: Fetches lists of characters filtered by a story id.
      description: Fetches lists of comic characters appearing in a single story, with optional filters. See notes on individual parameters below.
      operationId: getStoriesCreatorCollection
      parameters:
      - name: storyId
        in: path
        description: The story ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Return only characters matching the specified full character name (e.g. Spider-Man).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return characters with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only characters which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only characters which appear the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CharacterDataWrapper'
  /v1/public/stories/{storyId}/comics:
    get:
      tags:
      - public
      summary: Fetches lists of comics filtered by a story id.
      description: Fetches lists of comics in which a specific story appears, with optional filters. See notes on individual parameters below.
      operationId: getComicsFilteredByStory
      parameters:
      - name: storyId
        in: path
        description: The story ID.
        required: true
        type: integer
        format: int32
      - name: format
        in: query
        description: Filter by the issue format (e.g. comic, digital comic, hardcover).
        required: false
        type: string
      - name: formatType
        in: query
        description: Filter by the issue format type (comic or collection).
        required: false
        type: string
      - name: noVariants
        in: query
        description: Exclude variant comics from the result set.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: dateDescriptor
        in: query
        description: Return comics within a predefined date range.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: dateRange
        in: query
        description: 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.
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Return only issues in series whose title matches the input.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return only issues in series whose title starts with the input.
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only issues in series whose start year matches the input.
        required: false
        type: integer
        format: int32
      - name: issueNumber
        in: query
        description: Return only issues in series whose issue number matches the input.
        required: false
        type: integer
        format: int32
      - name: diamondCode
        in: query
        description: Filter by diamond code.
        required: false
        type: string
      - name: digitalId
        in: query
        description: Filter by digital comic id.
        required: false
        type: integer
        format: int32
      - name: upc
        in: query
        description: Filter by UPC.
        required: false
        type: string
      - name: isbn
        in: query
        description: Filter by ISBN.
        required: false
        type: string
      - name: ean
        in: query
        description: Filter by EAN.
        required: false
        type: string
      - name: issn
        in: query
        description: Filter by ISSN.
        required: false
        type: string
      - name: hasDigitalIssue
        in: query
        description: Include only results which are available digitally.
        required: false
        type: array
        items:
          type: boolean
        collectionFormat: multi
      - name: modifiedSince
        in: query
        description: Return only comics which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only comics which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only comics which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: events
        in: query
        description: Return only comics which take place in the specified events (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/ComicDataWrapper'
  /v1/public/stories/{storyId}/creators:
    get:
      tags:
      - public
      summary: Fetches lists of creators filtered by a story id.
      description: Fetches lists of comic creators whose work appears in a specific story, with optional filters. See notes on individual parameters below.
      operationId: getCreatorsFilteredByStory
      parameters:
      - name: storyId
        in: path
        description: The story ID.
        required: true
        type: integer
        format: int32
      - name: firstName
        in: query
        description: Filter by creator first name (e.g. brian).
        required: false
        type: string
      - name: middleName
        in: query
        description: Filter by creator middle name (e.g. Michael).
        required: false
        type: string
      - name: lastName
        in: query
        description: Filter by creator last name (e.g. Bendis).
        required: false
        type: string
      - name: suffix
        in: query
        description: Filter by suffix or honorific (e.g. Jr., Sr.).
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Filter by creator names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: firstNameStartsWith
        in: query
        description: Filter by creator first names that match critera (e.g. B, St L).
        required: false
        type: string
      - name: middleNameStartsWith
        in: query
        description: Filter by creator middle names that match critera (e.g. Mi).
        required: false
        type: string
      - name: lastNameStartsWith
        in: query
        description: Filter by creator last names that match critera (e.g. Ben).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only creators which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only creators who worked on the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/CreatorDataWrapper'
  /v1/public/stories/{storyId}/events:
    get:
      tags:
      - public
      summary: Fetches lists of events filtered by a story id.
      description: Fetches lists of events in which a specific story appears, with optional filters. See notes on individual parameters below.
      operationId: getEventsFilteredByStory
      parameters:
      - name: storyId
        in: path
        description: The story ID.
        required: true
        type: integer
        format: int32
      - name: name
        in: query
        description: Filter the event list by name.
        required: false
        type: string
      - name: nameStartsWith
        in: query
        description: Return events with names that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: modifiedSince
        in: query
        description: Return only events which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only events which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: series
        in: query
        description: Return only events which are part of the specified series (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: comics
        in: query
        description: Return only events which take place in the specified comics (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/EventDataWrapper'
  /v1/public/stories/{storyId}/series:
    get:
      tags:
      - public
      summary: Fetches lists of series filtered by a story id.
      description: Fetches lists of comic series in which the specified story takes place. See notes on individual parameters below.
      operationId: getStorySeriesCollection
      parameters:
      - name: storyId
        in: path
        description: The story ID.
        required: true
        type: integer
        format: int32
      - 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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: title
        in: query
        description: Filter by series title.
        required: false
        type: string
      - name: titleStartsWith
        in: query
        description: Return series with titles that begin with the specified string (e.g. Sp).
        required: false
        type: string
      - name: startYear
        in: query
        description: Return only series matching the specified start year.
        required: false
        type: integer
        format: int32
      - name: modifiedSince
        in: query
        description: Return only series which have been modified since the specified date.
        required: false
        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
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: creators
        in: query
        description: Return only series which feature work by the specified creators (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: characters
        in: query
        description: Return only series which feature the specified characters (accepts a comma-separated list of ids).
        required: false
        type: array
        items:
          type: integer
          format: int32
        collectionFormat: multi
      - name: seriesType
        in: query
        description: Filter the series by publication frequency type.
        required: false
        type: string
      - name: contains
        in: query
        description: Return only series containing one or more comics with the specified format.
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - 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
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: limit
        in: query
        description: Limit the result set to the specified number of resources.
        required: false
        type: integer
        format: int32
      - name: offset
        in: query
        description: Skip the specified number of resources in the result set.
        required: false
        type: integer
        format: int32
      responses:
        "200":
          description: No response was specified
          schema:
            $ref: '#/definitions/SeriesDataWrapper'
definitions:
  ComicList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available issues in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of issues returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of issues in this collection.
      items:
        type: array
        description: The list of returned issues in this collection.
        items:
          $ref: '#/definitions/ComicSummary'
  EventList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available events in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of events returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of events in this collection.
      items:
        type: array
        description: The list of returned events in this collection.
        items:
          $ref: '#/definitions/EventSummary'
  CreatorList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available creators in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of creators returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of creators in this collection.
      items:
        type: array
        description: The list of returned creators in this collection.
        items:
          $ref: '#/definitions/CreatorSummary'
  CharacterList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available characters in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of characters returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of characters in this collection.
      items:
        type: array
        description: The list of returned characters in this collection.
        items:
          $ref: '#/definitions/CharacterSummary'
  SeriesList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available series in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of series returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of series in this collection.
      items:
        type: array
        description: The list of returned series in this collection.
        items:
          $ref: '#/definitions/SeriesSummary'
  StoryList:
    properties:
      available:
        type: integer
        format: int32
        description: The number of total available stories in this list. Will always be greater than or equal to the "returned" value.
      returned:
        type: integer
        format: int32
        description: The number of stories returned in this collection (up to 20).
      collectionURI:
        type: string
        description: The path to the full list of stories in this collection.
      items:
        type: array
        description: The list of returned stories in this collection.
        items:
          $ref: '#/definitions/StorySummary'
  CharacterSummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual character resource.
      name:
        type: string
        description: The full name of the character.
      role:
        type: string
        description: The role of the creator in the parent entity.
  EventSummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual event resource.
      name:
        type: string
        description: The name of the event.
  SeriesSummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual series resource.
      name:
        type: string
        description: The canonical name of the series.
  ComicSummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual comic resource.
      name:
        type: string
        description: The canonical name of the comic.
  Url:
    properties:
      type:
        type: string
        description: A text identifier for the URL.
      url:
        type: string
        description: A full URL (including scheme, domain, and path).
  CreatorSummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual creator resource.
      name:
        type: string
        description: The full name of the creator.
      role:
        type: string
        description: The role of the creator in the parent entity.
  StorySummary:
    properties:
      resourceURI:
        type: string
        description: The path to the individual story resource.
      name:
        type: string
        description: The canonical name of the story.
      type:
        type: string
        description: The type of the story (interior or cover).
  Image:
    properties:
      path:
        type: string
        description: The directory path of to the image.
      extension:
        type: string
        description: The file extension for the image.
  ComicDate:
    properties:
      type:
        type: string
        description: A description of the date (e.g. onsale date, FOC date).
      date:
        type: string
        format: date
        description: The date.
  CharacterDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of characters returned by the call.
        items:
          $ref: '#/definitions/Character'
  EventDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of events returned by the call
        items:
          $ref: '#/definitions/Event'
  ComicPrice:
    properties:
      type:
        type: string
        description: A description of the price (e.g. print price, digital price).
      price:
        type: number
        format: float
        description: The price (all prices in USD).
  EventDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/EventDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  Creator:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the creator resource.
      firstName:
        type: string
        description: The first name of the creator.
      middleName:
        type: string
        description: The middle name of the creator.
      lastName:
        type: string
        description: The last name of the creator.
      suffix:
        type: string
        description: The suffix or honorific for the creator.
      fullName:
        type: string
        description: The full name of the creator (a space-separated concatenation of the above four fields).
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      resourceURI:
        type: string
        description: The canonical URL identifier for this resource.
      urls:
        type: array
        description: A set of public web site URLs for the resource.
        items:
          $ref: '#/definitions/Url'
      thumbnail:
        description: The representative image for this creator.
        $ref: '#/definitions/Image'
      series:
        description: A resource list containing the series which feature work by this creator.
        $ref: '#/definitions/SeriesList'
      stories:
        description: A resource list containing the stories which feature work by this creator.
        $ref: '#/definitions/StoryList'
      comics:
        description: A resource list containing the comics which feature work by this creator.
        $ref: '#/definitions/ComicList'
      events:
        description: A resource list containing the events which feature work by this creator.
        $ref: '#/definitions/EventList'
  Event:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the event resource.
      title:
        type: string
        description: The title of the event.
      description:
        type: string
        description: A description of the event.
      resourceURI:
        type: string
        description: The canonical URL identifier for this resource.
      urls:
        type: array
        description: A set of public web site URLs for the event.
        items:
          $ref: '#/definitions/Url'
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      start:
        type: string
        format: date
        description: The date of publication of the first issue in this event.
      end:
        type: string
        format: date
        description: The date of publication of the last issue in this event.
      thumbnail:
        description: The representative image for this event.
        $ref: '#/definitions/Image'
      comics:
        description: A resource list containing the comics in this event.
        $ref: '#/definitions/ComicList'
      stories:
        description: A resource list containing the stories in this event.
        $ref: '#/definitions/StoryList'
      series:
        description: A resource list containing the series in this event.
        $ref: '#/definitions/SeriesList'
      characters:
        description: A resource list containing the characters which appear in this event.
        $ref: '#/definitions/CharacterList'
      creators:
        description: A resource list containing creators whose work appears in this event.
        $ref: '#/definitions/CreatorList'
      next:
        description: A summary representation of the event which follows this event.
        $ref: '#/definitions/EventSummary'
      previous:
        description: A summary representation of the event which preceded this event.
        $ref: '#/definitions/EventSummary'
  ComicDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of comics returned by the call
        items:
          $ref: '#/definitions/Comic'
  TextObject:
    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 denoting the language the text object is written in.
      text:
        type: string
        description: The text.
  CreatorDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/CreatorDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  StoryDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/StoryDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  Character:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the character resource.
      name:
        type: string
        description: The name of the character.
      description:
        type: string
        description: A short bio or description of the character.
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      resourceURI:
        type: string
        description: The canonical URL identifier for this resource.
      urls:
        type: array
        description: A set of public web site URLs for the resource.
        items:
          $ref: '#/definitions/Url'
      thumbnail:
        description: The representative image for this character.
        $ref: '#/definitions/Image'
      comics:
        description: A resource list containing comics which feature this character.
        $ref: '#/definitions/ComicList'
      stories:
        description: A resource list of stories in which this character appears.
        $ref: '#/definitions/StoryList'
      events:
        description: A resource list of events in which this character appears.
        $ref: '#/definitions/EventList'
      series:
        description: A resource list of series in which this character appears.
        $ref: '#/definitions/SeriesList'
  CharacterDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/CharacterDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  ComicDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/ComicDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  Series:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the series resource.
      title:
        type: string
        description: The canonical title of the series.
      description:
        type: string
        description: A description of the series.
      resourceURI:
        type: string
        description: The canonical URL identifier for this resource.
      urls:
        type: array
        description: A set of public web site URLs for the resource.
        items:
          $ref: '#/definitions/Url'
      startYear:
        type: integer
        format: int32
        description: The first year of publication for the series.
      endYear:
        type: integer
        format: int32
        description: The last year of publication for the series (conventionally, 2099 for ongoing series) .
      rating:
        type: string
        description: The age-appropriateness rating for the series.
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      thumbnail:
        description: The representative image for this series.
        $ref: '#/definitions/Image'
      comics:
        description: A resource list containing comics in this series.
        $ref: '#/definitions/ComicList'
      stories:
        description: A resource list containing stories which occur in comics in this series.
        $ref: '#/definitions/StoryList'
      events:
        description: A resource list containing events which take place in comics in this series.
        $ref: '#/definitions/EventList'
      characters:
        description: A resource list containing characters which appear in comics in this series.
        $ref: '#/definitions/CharacterList'
      creators:
        description: A resource list of creators whose work appears in comics in this series.
        $ref: '#/definitions/CreatorList'
      next:
        description: A summary representation of the series which follows this series.
        $ref: '#/definitions/SeriesSummary'
      previous:
        description: A summary representation of the series which preceded this series.
        $ref: '#/definitions/SeriesSummary'
  SeriesDataWrapper:
    properties:
      code:
        type: integer
        format: int32
        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:
        description: The results returned by the call.
        $ref: '#/definitions/SeriesDataContainer'
      etag:
        type: string
        description: A digest value of the content returned by the call.
  SeriesDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of series returned by the call
        items:
          $ref: '#/definitions/Series'
  StoryDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of stories returned by the call
        items:
          $ref: '#/definitions/Story'
  Comic:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the comic resource.
      digitalId:
        type: integer
        format: int32
        description: The ID of the digital comic representation of this comic. Will be 0 if the comic is not available digitally.
      title:
        type: string
        description: The canonical title of the comic.
      issueNumber:
        type: number
        format: double
        description: The number of the issue in the series (will generally be 0 for collection formats).
      variantDescription:
        type: string
        description: If the issue is a variant (e.g. an alternate cover, second printing, or director’s cut), a text description of the variant.
      description:
        type: string
        description: The preferred description of the comic.
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      isbn:
        type: string
        description: The ISBN for the comic (generally only populated for collection formats).
      upc:
        type: string
        description: The UPC barcode number for the comic (generally only populated for periodical formats).
      diamondCode:
        type: string
        description: The Diamond code for the comic.
      ean:
        type: string
        description: The EAN barcode for the comic.
      issn:
        type: string
        description: The ISSN barcode for the comic.
      format:
        type: string
        description: The publication format of the comic e.g. comic, hardcover, trade paperback.
      pageCount:
        type: integer
        format: int32
        description: The number of story pages in the comic.
      textObjects:
        type: array
        description: A set of descriptive text blurbs for the comic.
        items:
          $ref: '#/definitions/TextObject'
      resourceURI:
        type: string
        description: The canonical URL identifier for this resource.
      urls:
        type: array
        description: A set of public web site URLs for the resource.
        items:
          $ref: '#/definitions/Url'
      series:
        description: A summary representation of the series to which this comic belongs.
        $ref: '#/definitions/SeriesSummary'
      variants:
        type: array
        description: A list of variant issues for this comic (includes the "original" issue if the current issue is a variant).
        items:
          $ref: '#/definitions/ComicSummary'
      collections:
        type: array
        description: A list of collections which include this comic (will generally be empty if the comic's format is a collection).
        items:
          $ref: '#/definitions/ComicSummary'
      collectedIssues:
        type: array
        description: A list of issues collected in this comic (will generally be empty for periodical formats such as "comic" or "magazine").
        items:
          $ref: '#/definitions/ComicSummary'
      dates:
        type: array
        description: A list of key dates for this comic.
        items:
          $ref: '#/definitions/ComicDate'
      prices:
        type: array
        description: A list of prices for this comic.
        items:
          $ref: '#/definitions/ComicPrice'
      thumbnail:
        description: The representative image for this comic.
        $ref: '#/definitions/Image'
      images:
        type: array
        description: A list of promotional images associated with this comic.
        items:
          $ref: '#/definitions/Image'
      creators:
        description: A resource list containing the creators associated with this comic.
        $ref: '#/definitions/CreatorList'
      characters:
        description: A resource list containing the characters which appear in this comic.
        $ref: '#/definitions/CharacterList'
      stories:
        description: A resource list containing the stories which appear in this comic.
        $ref: '#/definitions/StoryList'
      events:
        description: A resource list containing the events in which this comic appears.
        $ref: '#/definitions/EventList'
  CreatorDataContainer:
    properties:
      offset:
        type: integer
        format: int32
        description: The requested offset (number of skipped results) of the call.
      limit:
        type: integer
        format: int32
        description: The requested result limit.
      total:
        type: integer
        format: int32
        description: The total number of resources available given the current filter set.
      count:
        type: integer
        format: int32
        description: The total number of results returned by this call.
      results:
        type: array
        description: The list of creators returned by the call.
        items:
          $ref: '#/definitions/Creator'
  Story:
    properties:
      id:
        type: integer
        format: int32
        description: The unique ID of the story resource.
      title:
        type: string
        description: The story title.
      description:
        type: string
        description: A short description of the story.
      resourceURI:
        type: string
        description: 'The canonical URL identifier for this resource. '
      type:
        type: string
        description: The story type e.g. interior story, cover, text story.
      modified:
        type: string
        format: date
        description: The date the resource was most recently modified.
      thumbnail:
        description: The representative image for this story.
        $ref: '#/definitions/Image'
      comics:
        description: A resource list containing comics in which this story takes place.
        $ref: '#/definitions/ComicList'
      series:
        description: A resource list containing series in which this story appears.
        $ref: '#/definitions/SeriesList'
      events:
        description: A resource list of the events in which this story appears.
        $ref: '#/definitions/EventList'
      characters:
        description: A resource list of characters which appear in this story.
        $ref: '#/definitions/CharacterList'
      creators:
        description: A resource list of creators who worked on this story.
        $ref: '#/definitions/CreatorList'
      originalissue:
        description: A summary representation of the issue in which this story was originally published.
        $ref: '#/definitions/ComicSummary'