Skip to content
Wink

Show one

GET
/api/managing-entity/{managingEntityIdentifier}/extranet/sales/affiliate/{affiliateManagingEntityIdentifier}
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/sales/affiliate/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69 \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Retrieve a single affiliate’s company details and booking sales metrics by identifier.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
managingEntityIdentifier
required
string
""

Managing entity identifier (UUID)

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
affiliateManagingEntityIdentifier
required
string
""

Affiliate managing entity identifier (UUID)

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

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”

Company details and booking sales metrics for the requested affiliate

Media typeapplication/json

Booking sales metrics for a managing entity, broken down by property and country.

object
byCountryList
Array<object>

Sales metrics grouped by country.

object
averageBookingAmount

Average booking value in the display currency.

number format: double
""
bookings

Total number of bookings in this metric set.

integer format: int64
""
currencyCode

Currency code for the monetary amounts.

string
"" /^[A-Z]{3}$/
totalPriceAmount

Total revenue from all bookings in the display currency.

number format: double
""
type

The dimension by which sales metrics are grouped.

string
""
Allowed values: BY_TOTAL BY_COUNTRY BY_PROPERTY
typeIdentifier

Unique identifier of the grouping entity.

string format: uuid
""
typeName

Display name of the grouping entity.

string
""
byPropertyList
Array<object>

Sales metrics grouped by individual property.

object
averageBookingAmount

Average booking value in the display currency.

number format: double
""
bookings

Total number of bookings in this metric set.

integer format: int64
""
currencyCode

Currency code for the monetary amounts.

string
"" /^[A-Z]{3}$/
totalPriceAmount

Total revenue from all bookings in the display currency.

number format: double
""
type

The dimension by which sales metrics are grouped.

string
""
Allowed values: BY_TOTAL BY_COUNTRY BY_PROPERTY
typeIdentifier

Unique identifier of the grouping entity.

string format: uuid
""
typeName

Display name of the grouping entity.

string
""
managingEntity

The managing entity associated with these metrics.

object
annualTravelSpendInDollars

How much user or company spends on travel per year.

object
amount
required

Monetary amount value

number
""
currency
required

ISO 4217 currency code

string
"" >= 1 characters /^[A-Z]{3}$/
city
required

Key-value pair representing the city (GeoNames ID and ASCII name) where the entity is located.

object
label
required

English readable text of the value.

string
"" >= 1 characters
value
required

The value that should be persisted.

string
"" >= 1 characters
continent
required

Key-value pair representing the continent of the entity.

object
label
required

English readable text of the value.

string
"" >= 1 characters
value
required

The value that should be persisted.

string
"" >= 1 characters
country
required

Key-value pair representing the country of the entity.

object
label
required

English readable text of the value.

string
"" >= 1 characters
value
required

The value that should be persisted.

string
"" >= 1 characters
createdDate
required

Timestamp when the managing entity was created.

string format: date-time
""
description

Short description reflecting the entity’s brand and positioning.

string
""
identifier
required

Unique identifier of the managing entity.

string
""
lastUpdate
required

Timestamp of the most recent update to the managing entity.

string format: date-time
""
name
required

Display name of the managing entity.

string
"" >= 1 characters
onlinePresence
Array<object>

Online presence of entity.

object
audienceSize

The size of your audience.

integer format: int64
""
audiences
Array<string>
Allowed values: EVERYONE ADVENTURE BEACH BUSINESS CULTURAL_EXPERIENCE EDUCATION FAMILY FOOD_AND_CULINARY HIKING HISTORICAL_SITES HONEYMOON LUXURY MEDICAL_TOURISM MUSIC_AND_FESTIVALS NATURE_AND_WILDLIFE PHOTOGRAPHY PILGRIMAGE RELAXATION ROAD_TRIP ROMANCE SHOPPING SKIING SOLO_TRAVEL SPORTS_EVENTS VOLUNTEERING WELLNESS_AND_SPA CITY WILDLIFE
disabled

Whether to disable this entry temporarily.

boolean
identifier
required

The url, account name or phone number that identifies this user with the specified network.

string
"" >= 1 characters
sort

How you would like to order your accounts.

integer format: int32
""
type
required

List of all active accounts that could be used for selling or seeing a company’s reach.

string
""
Allowed values: WINK WEB_SITE PERSONAL_WEB_SITE CORPORATE_WEB_SITE FACEBOOK INSTAGRAM TWITTER_X LINKEDIN TIKTOK SNAPCHAT MASTODON THREADS WEIBO HIVE_SOCIAL MEWE ELLO WHATSAPP TELEGRAM SIGNAL WECHAT LINE KAKAOTALK VIBER DISCORD SKYPE FACEBOOK_MESSENGER YOUTUBE TWITCH BILIBILI VIMEO DAILYMOTION KICK UPLIVE PINTEREST BEREAL VSCO IMGUR FLICKR FIVE_HUNDRED_PX REDDIT QUORA TUMBLR PLURK MEDIUM BLUESKY MINDS STEEMIT DIASPORA WHISPER YIK_YAK TELLONYM GOOGLE GITHUB SPOTIFY UPWORK SHOPIFY AMAZON PERSONAL_EMAIL WORK_EMAIL ONLY_FANS FANSLY
ownerImageId

Cloudinary image identifier for the owner’s profile picture or company logo.

string
""
ownerName
required

Full name of the managing entity owner.

string
"" >= 1 characters
status
required

Current lifecycle status of the managing entity.

string
""
Allowed values: PENDING_APPROVAL ACTIVE INACTIVE UNDER_REVIEW SUSPENDED REJECTED REMOVED
travelAgent

Travel agent-specific details; null for non-travel-agent entity types.

object
selfAcquires
required

Whether the agent is in charge of charging the property.

boolean
selfDisburses
required

Whether the agent is in charge of paying the property.

boolean
type
required

Entity type: HOTEL, APPLICATION, TRAVEL_AGENT, INFLUENCER, etc.

string
""
Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER
uniqueId
required

Human-friendly short unique identifier used in some public contexts.

string
"" >= 1 characters
urlName
required

URL-friendly slug identifying the entity in public profiles and links.

string
"" >= 1 characters /^[a-z0-9][a-z0-9-]*[a-z0-9]$/
total

Total aggregated sales metrics across all properties.

object
averageBookingAmount

Average booking value in the display currency.

number format: double
""
bookings

Total number of bookings in this metric set.

integer format: int64
""
currencyCode

Currency code for the monetary amounts.

string
"" /^[A-Z]{3}$/
totalPriceAmount

Total revenue from all bookings in the display currency.

number format: double
""
type

The dimension by which sales metrics are grouped.

string
""
Allowed values: BY_TOTAL BY_COUNTRY BY_PROPERTY
typeIdentifier

Unique identifier of the grouping entity.

string format: uuid
""
typeName

Display name of the grouping entity.

string
""
key
additional properties
""
Example
{
  "byCountryList": [
    {
      "averageBookingAmount": 450,
      "bookings": 120,
      "currencyCode": "USD",
      "totalPriceAmount": 54000,
      "type": "BY_COUNTRY",
      "typeIdentifier": "6f9e4d8a-1b5c-7d3e-0f2a-9c7d3e1f5a84",
      "typeName": "Thailand"
    }
  ],
  "byPropertyList": [
    {
      "averageBookingAmount": 450,
      "bookings": 85,
      "currencyCode": "USD",
      "totalPriceAmount": 38250,
      "type": "BY_PROPERTY",
      "typeIdentifier": "5e8d3c7f-0a4b-6c2d-9e1f-8b6c2d0e4f73",
      "typeName": "The Siam Residences, Bangkok"
    }
  ],
  "managingEntity": {
    "annualTravelSpendInDollars": null,
    "city": {
      "key": "1609350",
      "value": "Bangkok"
    },
    "continent": {
      "key": "AS",
      "value": "AS"
    },
    "country": {
      "key": "1605651",
      "value": "Thailand"
    },
    "createdDate": "2026-01-15T10:30:00",
    "description": "Luxury boutique property on the Chao Phraya River.",
    "identifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
    "lastUpdate": "2026-06-20T08:00:00",
    "name": "The Siam Residences",
    "onlinePresence": [],
    "ownerImageId": "v1/property/the-siam-residences.jpg",
    "ownerName": "Alexandra Beaumont",
    "status": "ACTIVE",
    "travelAgent": null,
    "type": "HOTEL",
    "uniqueId": "siam-bkk",
    "urlName": "the-siam-residences"
  },
  "total": {
    "averageBookingAmount": 450,
    "bookings": 120,
    "currencyCode": "USD",
    "totalPriceAmount": 54000,
    "type": "BY_TOTAL",
    "typeIdentifier": "4d7c2b6e-9f3a-5b1c-8d0e-7a5b1c9d3e62",
    "typeName": "All Properties"
  }
}

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

401

Section titled “401”

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

403

Section titled “403”

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

404

Section titled “404”

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

405

Section titled “405”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

415

Section titled “415”

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

500

Section titled “500”

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

503

Section titled “503”

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example