Skip to content

List applications

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

Retrieves all OAuth2 applications (registered clients) owned by the authenticated user within a managing entity.

managingEntityIdentifier
required
string
""

Identifier of the managing entity (property owner or partner company).

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

OK

Media type application/json
Array<object>
object
id
required

Unique application identifier.

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

Unique user record identifier who owns this application.

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

Display name of this OAuth2 application. The first application for every integrator typically matches the company name.

string
"" >= 1 characters
iconIdentifier

Application icon shown on the OAuth2 consent screen.

string | null
""
redirectUris

OAuth2 redirect URIs where the authorization server redirects after successful authentication.

Array<string>
""
postLogoutRedirectUris

Post-logout redirect URIs where the authorization server redirects after successful sign-out.

Array<string>
""
clientId
required

OAuth2 client identifier used to authenticate requests on behalf of this application.

string
""
scopes

OAuth2 scopes this application is granted permission to request (e.g., booking.read, booking.write). Empty list means OIDC-only access.

Array<string>
""
Example
[
{
"id": "",
"userIdentifier": "",
"name": "",
"iconIdentifier": "",
"redirectUris": "",
"postLogoutRedirectUris": "",
"clientId": "",
"scopes": ""
}
]

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"
}
}

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

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

Internal Server Error

object
Example generated
{}