Returns a list of authorizations based on the query parameters
<br>You must have at least one of these scopes: 'authorizations.read, authorizations.manage'.
Query parameters
Filter result by requested properties
Filter result by requested booking ids. Returns authorizations that are related to the specified booking or booking reservations. Use in combination with the Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.TargetTypes to get authorizations related only to bookings or to reservations.
Filter result by requested reservation ids
Filter result by authorization status
Filter by target types
Filter result by date and time attributes of authorization. Use in combination with the Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.From and Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.To attributes. All filters will check if the date specified by the filter type is between Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.From (included) and Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.To (excluded).
The start of the time interval. When filtering by Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.DateField, at least one of Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.From and Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.To has to be specified<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
The end of the time interval, must be larger than Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.From. When filtering by Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.DateField, at least one of Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.From and Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationListRequest.To has to be specified<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
Items per page. Default: 500. Maximum: 500.
List of all fields that can be used to sort the results. Possible values are: created:asc, created:desc, updated:asc, updated:desc, expiresat:asc, expiresat:desc. All other values will be silently ignored.
List of all embedded resources that should be expanded in the response. Possible values are: actions, remainingBalance. All other values will be silently ignored.
Response
Successfully returned authorization list
Example response
{
"authorizations": [
{
"id": "IUSENHBB",
"target": {
"type": "Booking",
"id": "KYKXKLWL",
"propertyId": "MUC"
},
"created": "2026-09-01T21:18:40.9170266Z",
"updated": "2026-09-01T21:18:40.9170268Z",
"externalReference": {
"paymentTransactionId": "VT6G6BFUR6XE5MHZARAX2ODK7Y"
},
"amount": {
"amount": 150,
"currency": "EUR"
},
"remainingBalance": {
"amount": 100,
"currency": "EUR"
},
"status": "Success",
"payerInteraction": "PaymentAccount",
"expiresAt": "2026-10-01T21:18:40.9170271Z",
"actions": [
{
"action": "Cancel",
"isAllowed": false,
"reasons": [
{
"code": "OnlySuccessfulAuthorizationCanBeCanceled",
"message": "Only a successful authorization can be canceled."
}
]
},
{
"action": "Refresh",
"isAllowed": true
},
{
"action": "ExpirePaymentLink",
"isAllowed": false,
"reasons": [
{
"code": "OnlyPendingPaymentLinkAuthorizationCanBeExpired",
"message": "Only pending payment link authorization can be expired."
}
]
}
]
}
],
"count": 1
}Changes
No recorded changes to this endpoint across all 1 revision of this API.