Distinctions

Server

Distinctions/awards and their cinema assignments.

Get a cinema distinction

GET

https://api.cineamo.com

/cinema-distinctions/{cinemaDistinctionId}

Returns a CinemaDistinction object by its Id.

Get a cinema distinction › path Parameters

cinemaDistinctionId

integer · required

Get a cinema distinction › Responses

CinemaDistinction details

CinemaDistinction

id

integer · readOnly

createdDatetime

string | null · readOnly

readOnly

position

integer | null

GET/cinema-distinctions/{cinemaDistinctionId}

curl https://api.cineamo.com/cinema-distinctions/:cinemaDistinctionId

Example Responses

{
  "id": 1,
  "createdDatetime": "2022-04-11T04:11:22Z",
  "cinema": {
    "id": 1,
    "name": "some cinema name",
    "shortName": "short name",
    "slug": "some-cinema-name",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "state": "Some State",
    "stateAbbr": "SS",
    "country": "Germany",
    "countryCode": "DE",
    "currencyCode": "EUR",
    "longitude": "10.070198",
    "latitude": "49.778145",
    "distance": 0,
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/cinema-profile",
    "logoImageRef": "00000000-0000-0000-0000-000000000000",
    "logoImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/cinema-logo",
    "logoWideImageRef": "00000000-0000-0000-0000-000000000000",
    "logoWideImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/cinema-wide-logo",
    "priceTablePdfRef": "00000000-0000-0000-0000-000000000000",
    "priceTablePdfUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/cinema-price-table",
    "primaryColor": "primaryColor",
    "instagramLink": "instagramLink",
    "facebookLink": "facebookLink",
    "ticketSystemId": "ticketSystemId",
    "ticketSystem": "ticketSystem",
    "email": "some@email.com",
    "isActive": "true",
    "cinemaConfigurationId": 1,
    "cinemaConfiguration": {
      "id": 1,
      "minimalInitialEventVisitor": 0,
      "requestTimeoutAnswer": 0,
      "isCatering": "true",
      "ticketSystem": "ticketSystem",
      "ticketSystemId": "ticketSystemId",
      "ticketUrlTemplate": "ticketUrlTemplate",
      "facebookAccessToken": "facebookAccessToken",
      "hasMarketingAssistantBooked": "true",
      "visitorThreshold1": 0,
      "visitorThreshold2": 0,
      "isPublicRequestAvailable": "true",
      "isProgramSuggestionEnabled": "true",
      "isPrivateBookingEnabled": "true",
      "isActive": "true",
      "isPrivateBookingPartner": "true",
      "isOnlineTicketingAvailable": "true",
      "isOnlineTicketingEnabled": "true",
      "onlineTicketing": "{}",
      "isKOSCustomer": "true",
      "isInterestSystemActivated": "true",
      "isGiftCardRedemptionEnabled": "false",
      "isWebsiteCustomer": "true",
      "websiteConfiguration": "{}",
      "ticketUrlTemplateIosAppendix": "ticketUrlTemplateIosAppendix",
      "ticketUrlTemplateAndroidAppendix": "ticketUrlTemplateAndroidAppendix",
      "ticketUrlTemplateWebAppendix": "ticketUrlTemplateWebAppendix",
      "ticketUrlTemplateCinemaWebsiteAppendix": "ticketUrlTemplateCinemaWebsiteAppendix",
      "domain": "domain",
      "pulseTenantId": "pulseTenantId"
    },
    "showtimesUpdated": "showtimesUpdated",
    "isFavorite": "true",
    "hasMarketingAssistantBooked": "true",
    "cineamoTrailerConfirmedDatetime": "2022-04-11T04:11:22Z",
    "metricCustomersCount": 1,
    "metricCompareCustomersCount": 1,
    "metricCustomersTotalCount": 1,
    "cinemaChainId": 1,
    "cinemaCompanyId": 1,
    "cityId": 1,
    "openingHoursCustomText": {
      "deu": "German translation",
      "gsw": "Swiss German translation"
    }
  },
  "distinction": {
    "id": 1,
    "name": "Gold Standard",
    "description": "Premium cinema quality certification",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
  },
  "position": 1
}

json

application/json

List distinctions

GET

https://api.cineamo.com

/distinctions

Returns a list of Distinction objects.

List distinctions › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

List distinctions › Responses

Distinction list

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Create a distinction

POST

https://api.cineamo.com

/distinctions

Creates a Distinction. It returns the Distinction object.

Create a distinction › Request Body

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Create a distinction › Responses

Distinction was created

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

POST/distinctions

curl https://api.cineamo.com/distinctions \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}'

Example Request Body

{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}

json

Example Responses

{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}

json

application/json

Get a distinction

GET

https://api.cineamo.com

/distinctions/{distinctionId}

Returns a Distinction object by its Id.

Get a distinction › path Parameters

distinctionId

integer · required

Get a distinction › Responses

Distinction details

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Delete a distinction

DELETE

https://api.cineamo.com

/distinctions/{distinctionId}

Deletes a Distinction. It returns an empty response.

Delete a distinction › path Parameters

distinctionId

string · required

Delete a distinction › Responses

Distinction was deleted

No data returned

Update a distinction

PATCH

https://api.cineamo.com

/distinctions/{distinctionId}

Updates a Distinction. It returns the updated Distinction object.

Update a distinction › path Parameters

distinctionId

integer · required

Update a distinction › Request Body

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Update a distinction › Responses

Distinction was updated

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

PATCH/distinctions/{distinctionId}

curl https://api.cineamo.com/distinctions/:distinctionId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}'

Example Request Body

{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}

json

Example Responses

{
  "id": 1,
  "name": "Gold Standard",
  "description": "Premium cinema quality certification",
  "imageRef": "00000000-0000-0000-0000-000000000000",
  "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/distinction-logo"
}

json

application/json

Cities Equipments

Get a cinema distinction

GET

https://api.cineamo.com

/cinema-distinctions/{cinemaDistinctionId}

Returns a CinemaDistinction object by its Id.

Get a cinema distinction › path Parameters

cinemaDistinctionId

integer · required

Get a cinema distinction › Responses

CinemaDistinction details

CinemaDistinction

id

integer · readOnly

createdDatetime

string | null · readOnly

readOnly

position

integer | null

List distinctions

GET

https://api.cineamo.com

/distinctions

Returns a list of Distinction objects.

List distinctions › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

List distinctions › Responses

Distinction list

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Create a distinction

POST

https://api.cineamo.com

/distinctions

Creates a Distinction. It returns the Distinction object.

Create a distinction › Request Body

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Create a distinction › Responses

Distinction was created

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Get a distinction

GET

https://api.cineamo.com

/distinctions/{distinctionId}

Returns a Distinction object by its Id.

Get a distinction › path Parameters

distinctionId

integer · required

Get a distinction › Responses

Distinction details

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Update a distinction

PATCH

https://api.cineamo.com

/distinctions/{distinctionId}

Updates a Distinction. It returns the updated Distinction object.

Update a distinction › path Parameters

distinctionId

integer · required

Update a distinction › Request Body

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly

Update a distinction › Responses

Distinction was updated

Distinction

id

integer · readOnly

name

string

description

string | null

imageRef

string | null · readOnly

imageUrl

string | null · readOnly