Models

Generated pydantic models for ThemeParks.wiki API payloads. Only the most commonly used models are documented here — see themeparks._generated.models for the full set.

Enums

Bases: Enum

Type of entity in the theme park system

Bases: Enum

Current operating status of an entity

Entity data

Bases: BaseModel

A single entity. Beyond the properties listed here, an entity may carry additional tag-derived properties named after the tag's slug, for example minimumHeight (integer, centimetres) or mayGetWet (boolean). The set is open-ended and driven by data rather than fixed by this contract, so clients should read them defensively rather than assume any particular tag is present.

id instance-attribute

id: str

Unique entity identifier

name instance-attribute

name: str

Entity name

attractionType class-attribute instance-attribute

attractionType: AttractionType | None = None

Kind of attraction. Present on ATTRACTION entities.

parentId class-attribute instance-attribute

parentId: str | None = None

Parent entity identifier

destinationId class-attribute instance-attribute

destinationId: str | None = None

DestinationEntry identifier

parkId class-attribute instance-attribute

parkId: str | None = None

Identifier of the park this entity belongs to. Absent on destinations and on parks themselves.

timezone instance-attribute

timezone: str

Entity timezone

externalId class-attribute instance-attribute

externalId: str | None = None

Identifier used by the source data provider.

slug class-attribute instance-attribute

slug: str | None = None

URL-friendly slug. Served for destinations.

Bases: BaseModel

id instance-attribute

id: str

Unique entity identifier

name instance-attribute

name: str

Entity name

externalId class-attribute instance-attribute

externalId: str | None = None

External identifier

parentId class-attribute instance-attribute

parentId: str | None = None

Parent entity identifier

slug class-attribute instance-attribute

slug: str | None = None

URL-friendly slug

Bases: BaseModel

id class-attribute instance-attribute

id: str | None = None

Parent entity identifier

name class-attribute instance-attribute

name: str | None = None

Parent entity name

timezone class-attribute instance-attribute

timezone: str | None = None

Entity timezone

Live data

Bases: BaseModel

id instance-attribute

id: str

Entity identifier

name instance-attribute

name: str

Entity name

lastUpdated instance-attribute

lastUpdated: AwareDatetime

Last update timestamp

Bases: BaseModel

id class-attribute instance-attribute

id: str | None = None

Entity identifier

name class-attribute instance-attribute

name: str | None = None

Entity name

timezone class-attribute instance-attribute

timezone: str | None = None

Entity timezone

Queues

Bases: BaseModel

Bases: BaseModel

waitTime class-attribute instance-attribute

waitTime: float | None = None

Current standby wait time in minutes

Bases: BaseModel

waitTime class-attribute instance-attribute

waitTime: float | None = None

Current single rider wait time in minutes

Bases: BaseModel

returnStart class-attribute instance-attribute

returnStart: AwareDatetime | None = None

Start time of return window

returnEnd class-attribute instance-attribute

returnEnd: AwareDatetime | None = None

End time of return window

Bases: BaseModel

Bases: BaseModel

currentGroupStart class-attribute instance-attribute

currentGroupStart: float | None = None

Current boarding group start number

currentGroupEnd class-attribute instance-attribute

currentGroupEnd: float | None = None

Current boarding group end number

nextAllocationTime class-attribute instance-attribute

nextAllocationTime: AwareDatetime | None = None

Next boarding group allocation time

estimatedWait class-attribute instance-attribute

estimatedWait: float | None = None

Estimated wait time in minutes

Bases: BaseModel

waitTime class-attribute instance-attribute

waitTime: float | None = None

Current paid standby wait time in minutes

Shows and dining

Bases: BaseModel

type instance-attribute

type: str

Type of show time entry

startTime class-attribute instance-attribute

startTime: AwareDatetime | None = None

Start time of the show

endTime class-attribute instance-attribute

endTime: AwareDatetime | None = None

End time of the show

Bases: BaseModel

partySize class-attribute instance-attribute

partySize: float | None = None

Available party size

waitTime class-attribute instance-attribute

waitTime: float | None = None

Current wait time in minutes

Schedule

Bases: BaseModel

date instance-attribute

date: str

Schedule date

openingTime instance-attribute

openingTime: AwareDatetime

Opening time

closingTime instance-attribute

closingTime: AwareDatetime

Closing time

type instance-attribute

type: Type9

Type of schedule entry

description class-attribute instance-attribute

description: str | None = None

Optional description of the schedule entry

purchases class-attribute instance-attribute

purchases: list[SchedulePriceObject] | None = None

Available purchases for this schedule entry

Bases: BaseModel

id class-attribute instance-attribute

id: str | None = None

Entity identifier

name class-attribute instance-attribute

name: str | None = None

Entity name

entityType class-attribute instance-attribute

entityType: EntityType | None = None

Type of entity

timezone class-attribute instance-attribute

timezone: str | None = None

Entity timezone

parks class-attribute instance-attribute

parks: list[ParkSchedule] | None = None

Only included for destinations, lists all parks within the destination

Destinations

Bases: BaseModel

id instance-attribute

id: str

Unique identifier of the destination

name instance-attribute

name: str

Name of the destination

slug class-attribute instance-attribute

slug: str | None = None

URL-friendly slug for the destination

externalId class-attribute instance-attribute

externalId: str | None = None

External entity ID from the source data provider

parks instance-attribute

parks: list[Park]

Array of parks within this destination

Bases: BaseModel

id instance-attribute

id: str

Unique identifier of the park

name instance-attribute

name: str

Name of the park

Bases: BaseModel

destinations instance-attribute

destinations: list[DestinationEntry]

Array of all destinations

Shared

Bases: BaseModel

latitude class-attribute instance-attribute

latitude: float | None = None

Latitude coordinate of the entity location

longitude class-attribute instance-attribute

longitude: float | None = None

Longitude coordinate of the entity location

Bases: BaseModel

amount class-attribute instance-attribute

amount: float | None = None

Numerical price amount, in the currency's lowest denomination (e.g. cents). null when the item costs money but the provider does not publish an amount; 0 means genuinely free

currency instance-attribute

currency: str

Currency code

formatted class-attribute instance-attribute

formatted: str | None = None

Formatted price string