APapaleo
Authorization

Returns a list of authorizations based on the query parameters

<br>You must have at least one of these scopes: 'authorizations.read, authorizations.manage'.<br>For fine-grained clients, you must have this permission: 'core.authorizations.read'.

get/booking/v0-nsfw/authorizations

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/booking/v0-nsfw/authorizations
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: authorizations.read, authorizations.manage, admin

Query parameters

propertyIdsstring[]

Filter result by requested properties

bookingIdsstring[]

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.

reservationIdsstring[]

Filter result by requested reservation ids

statusstring[]

Filter result by authorization status

targetTypesstring[]

Filter by target types

dateField'Creation' | 'Modification' | 'Expiration'

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).

fromstring date-time

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 in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

tostring date-time

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 in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

pageNumberinteger

Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.

pageSizeinteger

Items per page. Default: 500. Maximum: 500.

sortstring[]

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.

expandstring[]

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

countinteger required

Total count of items

Example response

{
  "authorizations": [
    {
      "id": "IUSENHBB",
      "target": {
        "type": "Booking",
        "id": "KYKXKLWL",
        "propertyId": "MUC"
      },
      "created": "2026-10-30T15:13:47.1773279Z",
      "updated": "2026-10-30T15:13:47.1773281Z",
      "externalReference": {
        "paymentTransactionId": "VT6G6BFUR6XE5MHZARAX2ODK7Y"
      },
      "amount": {
        "amount": 150,
        "currency": "EUR"
      },
      "remainingBalance": {
        "amount": 100,
        "currency": "EUR"
      },
      "status": "Success",
      "payerInteraction": "PaymentAccount",
      "expiresAt": "2026-11-29T15:13:47.1773286Z",
      "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 operation changes recorded.