Skip to content
Wink

Show Recognition by Category

GET
/api/managing-entity/{managingEntityIdentifier}/extranet/property/recognition/{category}/list
 
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/hotel-1/extranet/property/recognition/AWARD/list \
  --header 'Wink-Version: 2.0'

Retrieve list recognitions by category

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Show list of recognitions for this property identifier

Example 
hotel-1
category
required
string
""

Filter list of recognitions by category

Example 
AWARD

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
Array<object>

Recognition for the ancillary blocking.

object
identifier
required

Recognition identifier.

string format: uuid
"" >= 1 characters
category
required

Recognition category.

string
""
Allowed values: THIRD_PARTY_REVIEW PUBLICATION AWARD
type
required

Type of rating system the recognition operated on. This allows us to display the score properly.

string
""
Allowed values: STAR_RATING NUMERIC_RATING PERCENT_RATING
provider
required

The name of the entity that administers this recognition.

string
"" >= 1 characters
rating
required

The actual award or rating received by the hotel facility.

number format: float
""
maxRating
required

Use this to let hotels indicate what the total score for this award is.

number format: float
""
date

The date the award was received

string format: date
""
officialAppointmentInd

When true, this indicates the property has received official permission from the award provider to use the rating in publications and marketing materials; when false this permission has not been granted.

boolean
ratingSymbol

Provides the symbol used in the rating. Used in conjunction with the Rating.

string
""
Example 
[
  null
]

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}