Cities

Server

City reference data.

List cities

GET

https://api.cineamo.com

/cities

Returns a list of City objects.

List cities › query Parameters

page

integer

perPage

integer

sort

string · enum

Enum values:

name

population

order

string · enum

Enum values:

asc

desc

query

string

Search in name, nameAscii, and nameAlt fields

iso31662

string[]

Filter by country ISO2 code(s) (e.g., iso31662[]=US&iso31662[]=LT or iso31662=US)

includeCinemaCountries

boolean

When true, merges iso31662 codes with countries that have active cinemas

latitude

number · float

Latitude for geographic search

longitude

number · float

Longitude for geographic search

distance

number · float

Maximum distance in meters (requires latitude and longitude)

List cities › Responses

200

A list of City objects

City[]

City

name

string · readOnly · required

id

integer | null · readOnly

nameAscii

string · readOnly

nameAlt

string | null · readOnly

nameLocal

string | null · readOnly

nameLocalLang

string | null · readOnly

ISO 639 language code for the local name

Example: lit

country

string · readOnly

iso31662

string | null · readOnly

iso31663

string | null · readOnly

latitude

string | null · readOnly

longitude

string | null · readOnly

adminName

string | null · readOnly

population

number | null · float · readOnly

timezone

string | null · readOnly

distance

number | null · float · readOnly

Distance in meters from the reference point (only present when filtering by location)

Example: 1234.56

Get a city

GET

https://api.cineamo.com

/cities/{cityId}

Returns a City object by its ID.

Get a city › path Parameters

cityId

integer · required

Get a city › Responses

City detail

City

name

string · readOnly · required

id

integer | null · readOnly

nameAscii

string · readOnly

nameAlt

string | null · readOnly

nameLocal

string | null · readOnly

nameLocalLang

string | null · readOnly

ISO 639 language code for the local name

Example: lit

country

string · readOnly

iso31662

string | null · readOnly

iso31663

string | null · readOnly

latitude

string | null · readOnly

longitude

string | null · readOnly

adminName

string | null · readOnly

population

number | null · float · readOnly

timezone

string | null · readOnly

distance

number | null · float · readOnly

Distance in meters from the reference point (only present when filtering by location)

Example: 1234.56

Cinema Sites Distinctions

Cineamo API

Cities

Server

City reference data.

List cities

GET

https://api.cineamo.com

/cities

Returns a list of City objects.

List cities › query Parameters

page

integer

perPage

integer

sort

string · enum

Enum values:

name

population

order

string · enum

Enum values:

asc

desc

query

string

Search in name, nameAscii, and nameAlt fields

iso31662

string[]

Filter by country ISO2 code(s) (e.g., iso31662[]=US&iso31662[]=LT or iso31662=US)

includeCinemaCountries

boolean

When true, merges iso31662 codes with countries that have active cinemas

latitude

number · float

Latitude for geographic search

longitude

number · float

Longitude for geographic search

distance

number · float

Maximum distance in meters (requires latitude and longitude)

List cities › Responses

200

A list of City objects

City[]

City

name

string · readOnly · required

id

integer | null · readOnly

nameAscii

string · readOnly

nameAlt

string | null · readOnly

nameLocal

string | null · readOnly

nameLocalLang

string | null · readOnly

ISO 639 language code for the local name

Example: lit

country

string · readOnly

iso31662

string | null · readOnly

iso31663

string | null · readOnly

latitude

string | null · readOnly

longitude

string | null · readOnly

adminName

string | null · readOnly

population

number | null · float · readOnly

timezone

string | null · readOnly

distance

number | null · float · readOnly

Distance in meters from the reference point (only present when filtering by location)

Example: 1234.56

Get a city

GET

https://api.cineamo.com

/cities/{cityId}

Returns a City object by its ID.

Get a city › path Parameters

cityId

integer · required

Get a city › Responses

City detail

City

name

string · readOnly · required

id

integer | null · readOnly

nameAscii

string · readOnly

nameAlt

string | null · readOnly

nameLocal

string | null · readOnly

nameLocalLang

string | null · readOnly

ISO 639 language code for the local name

Example: lit

country

string · readOnly

iso31662

string | null · readOnly

iso31663

string | null · readOnly

latitude

string | null · readOnly

longitude

string | null · readOnly

adminName

string | null · readOnly

population

number | null · float · readOnly

timezone

string | null · readOnly

distance

number | null · float · readOnly

Distance in meters from the reference point (only present when filtering by location)

Example: 1234.56

Cinema Sites Distinctions