Skip to content

Wish List

AcquireWishListItem

Bases: BaseModel

A data model representing a request to mark a wish list item as acquired.

This creates a new collection item from the wish list item.

ATTRIBUTE DESCRIPTION
purchase_date

The date the issue was purchased.

TYPE: date

purchase_price

The price paid for the issue.

TYPE: Decimal

purchase_price_currency

Currency for purchase_price (default "USD").

TYPE: str

purchase_store

The store or vendor where the issue was purchased.

TYPE: str

notes

Additional notes about the purchase.

TYPE: str

Currency

Bases: str, Enum

Enumeration of supported currencies.

Values:

Text Only
USD: US Dollar
GBP: British Pound Sterling

Priority

Bases: int, Enum

Enumeration of wish list item priority levels (1=highest, 5=lowest).

Values:

Text Only
ONE: Priority 1 (highest)
TWO: Priority 2
THREE: Priority 3 (default)
FOUR: Priority 4
FIVE: Priority 5 (lowest)

WishList

Bases: BaseModel

A data model representing a user's wish list.

ATTRIBUTE DESCRIPTION
id

The unique identifier of the wish list.

TYPE: int

item_count

Number of items in the wish list.

TYPE: int

items_url

URL to retrieve the wish list items.

TYPE: str

modified

The date and time when the wish list was last modified.

TYPE: datetime

WishListAddItem

Bases: BaseModel

A data model representing a request to add an issue to the wish list.

ATTRIBUTE DESCRIPTION
issue_id

The unique identifier of the issue to add.

TYPE: int

priority

Priority level 1-5 (default 3).

TYPE: int

desired_grade

The desired CGC grade for the issue.

TYPE: Decimal

max_price

The maximum price willing to pay.

TYPE: Decimal

max_price_currency

Currency for max_price (default "USD").

TYPE: str

notes

Additional notes about this wish list item.

TYPE: str

WishListItemList

Bases: BaseModel

A data model representing a wish list item in list view.

ATTRIBUTE DESCRIPTION
id

The unique identifier of the wish list item.

TYPE: int

issue

The issue associated with this wish list item.

TYPE: CollectionIssue

status

The current status of the wish list item.

TYPE: str

priority

The priority level for acquiring this item.

TYPE: Priority

desired_grade

The desired CGC grade for the issue.

TYPE: Grade

modified

The date and time when the item was last modified.

TYPE: datetime

WishListItemRead

Bases: BaseModel

A data model representing a wish list item in detailed view.

ATTRIBUTE DESCRIPTION
id

The unique identifier of the wish list item.

TYPE: int

issue

The issue associated with this wish list item.

TYPE: CollectionIssue

status

The current status of the wish list item.

TYPE: str

priority

The priority level for acquiring this item.

TYPE: Priority

desired_grade

The desired CGC grade for the issue.

TYPE: Grade

max_price

The maximum price willing to pay.

TYPE: Decimal

max_price_currency

Currency code for max_price (e.g. "USD", "GBP").

TYPE: str

notes

Additional notes about this wish list item.

TYPE: str

added_on

The date and time when the item was added to the wish list.

TYPE: datetime

modified

The date and time when the item was last modified.

TYPE: datetime