Skip to content

Issue

BasicIssue

Bases: BaseModel

Contains fields for all Issues.

ATTRIBUTE DESCRIPTION
api_url

Url to the resource in the GCD API.

TYPE: HttpUrl

series_name

The name of the series.

TYPE: str

descriptor

The descriptor of the issue.

TYPE: str

publication_str

The publication date of the issue.

TYPE: Annotated[str, Field(alias=publication_date)]

price

The price of the issue.

TYPE: str

page_count

The page count of the issue.

TYPE: Annotated[Decimal | None, BeforeValidator(blank_is_none)]

variant_of

The URL of the original issue if this issue is a variant.

TYPE: Annotated[HttpUrl | None, BeforeValidator(blank_is_none)]

series

Url to the Series of this resource in the GCD API.

TYPE: HttpUrl

Attributes

id property

The Issue id, extracted from the api_url field.

publication_date property

Returns the publication date as a date object if possible.

Attempts to parse the publication date string and return it as a date object. If parsing fails, returns None.

series_id property

The Series id, extracted from the series field.

Issue

Bases: BasicIssue

Extends BasicIssue to include more details.

ATTRIBUTE DESCRIPTION
number

TYPE: str

volume

TYPE: str

variant_name

TYPE: str

title

TYPE: str

key_str

TYPE: Annotated[str, Field(alias=key_date)]

editing

The editing credits for the issue.

TYPE: str

indicia_publisher

According to the indicia what is the publisher of the issue.

TYPE: str

brand_emblem

TYPE: str

isbn

The ISBN of the issue.

TYPE: str

barcode

The barcode of the issue.

TYPE: str

rating

The rating of the issue.

TYPE: str

on_sale_str

The on-sale date of the issue.

TYPE: Annotated[str, Field(alias=on_sale_date)]

indicia_frequency

According to the indicia what is the frequency release of the issue.

TYPE: str

notes

Additional notes about the issue.

TYPE: str

story_set

A list of stories in the issue.

TYPE: list[Story]

cover

The URL of the issue's cover image.

TYPE: Annotated[HttpUrl | None, BeforeValidator(blank_is_none)]

Attributes

key_date property

Returns the key date as a date object if possible.

Attempts to parse the key date string and return it as a date object. If parsing fails, returns None.

on_sale_date property

Returns the on-sale date as a date object if possible.

Attempts to parse the on-sale date string and return it as a date object. If parsing fails, returns None.

Story

Bases: BaseModel

Contains fields relating to the stories inside an Issue.

ATTRIBUTE DESCRIPTION
type

The type of the story.

TYPE: str

title

The title of the story.

TYPE: str

feature

TYPE: str

sequence_number

The order of the story in the larger issue.

TYPE: int

page_count

The page count of the story.

TYPE: Annotated[Decimal | None, BeforeValidator(blank_is_none)]

script

The script credits for the story.

TYPE: str

pencils

The pencil credits for the story.

TYPE: str

inks

The ink credits for the story.

TYPE: str

colors

The color credits for the story.

TYPE: str

letters

The letter credits for the story.

TYPE: str

editing

The editing credits for the story.

TYPE: str

job_number

TYPE: str

genre

The genre of the story.

TYPE: str

first_line

TYPE: str

characters

The characters in the story.

TYPE: str

synopsis

The synopsis of the story.

TYPE: str

notes

Additional notes about the story.

TYPE: str

keywords

TYPE: str