City reference data.
List city cinemas
Returns a list of Cinema objects located in the given City.
path Parameters
cityIdquery Parameters
pageperPagesortorderqueryisPrivateBookingPartnerisActivecitycountryCodeemployedUserIdfavoritedUserIdlongitudelatitudedistance(in meters)
cinemaChainIdisFavoritehasMarketingAssistantBookedisWebsiteCustomerembedmetricStartDatetimemetricEndDatetimekinofestPartnerCinemaDatetimeStartcinemaCompanyIds[]cinemaChainIds[]subscriptionPrograms[]Cinemas participating in ANY of the given subscription programs
hasSubscriptionProgramCinemas participating in at least one subscription program
movieIdCinemas that have at least one showing of the given movie
showingDatetimeStartRestricts the showings considered by movieId to those starting at or after this point
showingDatetimeEndRestricts the showings considered by movieId to those starting before this point
List city cinemas › Responses
A list of Cinema objects
idnamedescriptionstreetpostalCodecitystatestateAbbrcountrycountryCodecurrencyCodelongitudelatitudeemailisActiveshortNameslugphonedistance(in meters)
profileImageRefprofileImageUrllogoImageReflogoImageUrllogoWideImageReflogoWideImageUrlbrandImageUrlThe cinema's brand mark for a square or round slot: the logo, else the profile image. The wide logo is deliberately never used here, because every consumer of this field crops it square (a push notification icon, an avatar), which reduces a wide mark to its middle.
priceTablePdfRefpriceTablePdfUrlprimaryColorinstagramLinkfacebookLinkticketSystemIdticketSystemcinemaConfigurationIdshowtimesUpdatedisFavoritecineamoTrailerConfirmedDatetimekinofestPartnerCinemaDatetimemetricCustomersCountmetricCompareCustomersCountmetricCustomersTotalCountcinemaChainIdcinemaCompanyIdcityIdopeningHoursCustomTextsubscriptionProgramslinkedinLinkxLinkwhatsappLinktiktokLinkmetricRoomCountNumber of screening rooms that are not soft-deleted. Only set when embedded.
metricSeatCountSum of the seat counts of all rooms that are not soft-deleted. Rooms without a recorded seat count contribute nothing — read this together with metricSeatCountKnownRoomCount. Only set when embedded.
metricSeatCountKnownRoomCountHow many of the counted rooms actually carry a seat count, so consumers can tell a complete sum from a partial one. Only set when metricSeatCount is embedded.
timezoneIANA time zone of the cinema (e.g. "Europe/Berlin"). Null when the cinema has none recorded — consumers that need a fallback should apply their own.
homepageThe cinema's own website. Null when none is recorded.
hasMarketingAssistantBookedList cities
Returns a list of City objects. Cities are reference data and are never restricted to the caller's cinema chain: search any city here, then use its coordinates with GET /cinemas and a distance to find the cinemas around it. Without an iso31662 filter the list covers the countries Cineamo has active cinemas in, plus the DACH countries it operates in (DE, AT, CH).
query Parameters
pageperPagesortorderquerySearch in name, nameAscii, and nameAlt fields
iso31662Filter by country ISO2 code(s) (e.g., iso31662[]=US&iso31662[]=LT or iso31662=US)
includeCinemaCountriesWhen true, merges iso31662 codes with the countries that have active cinemas plus the DACH countries Cineamo operates in
hasCinemasWhen true, only cities holding at least one active cinema; when false, only cities holding none. Omit for no restriction.
latitudeLatitude for geographic search
longitudeLongitude for geographic search
distanceMaximum distance in meters (requires latitude and longitude)
List cities › Responses
A list of City objects
idnamenameAsciinameAltnameLocalnameLocalLangISO 639 language code for the local name
countryiso31662iso31663latitudelongitudeadminNamepopulationtimezonedistanceDistance in meters from the reference point (only present when filtering by location)
Get a city
Returns a City object by its ID.
path Parameters
cityIdGet a city › Responses
City detail
idnamenameAsciinameAltnameLocalnameLocalLangISO 639 language code for the local name
countryiso31662iso31663latitudelongitudeadminNamepopulationtimezonedistanceDistance in meters from the reference point (only present when filtering by location)