BokaMera.API.Host

<back to all web services

QueryBookingReservations

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, bookingsupplier-administrator-read, superadmin
The following routes are available for this service:
GET/admin/bookingreservationsList booking-reservation holds (admin)Lists the active reservation holds for a company. By default only the spot-holding statuses (Selecting, AwaitingPayment) — the ones actually reducing availability — are returned; pass StatusCode to filter to a specific status. Optionally filter by ServiceId and a From/To window on the hold start.
QueryBookingReservations Parameters:
NameParameterData TypeRequiredDescription
CompanyIdqueryGuid?NoThe company id, if empty will use the company id for the user you are logged in with.
ServiceIdqueryint?NoOnly holds for this service id.
FromqueryDateTime?NoOnly holds whose start (From) is on or after this datetime.
ToqueryDateTime?NoOnly holds whose start (From) is on or before this datetime.
StatusCodequeryint?NoFilter by BookingReservationStatus value. When omitted, the spot-holding statuses (Selecting=1, AwaitingPayment=2) are returned.
QueryBookingReservationsResponse Parameters:
NameParameterData TypeRequiredDescription
ResultsformList<AdminBookingReservationResult>YesThe matching reservation holds.
ResponseStatusformResponseStatusYes
AdminBookingReservationResult Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe internal reservation id (target for the release endpoint).
SessionKeyformGuidNoThe opaque session key that identifies the reservation.
ServiceIdformintNoThe reserved service id.
FromformDateTimeNoThe reservation start.
ToformDateTimeNoThe reservation end.
NumberOfBookedSpotsformintNoNumber of reserved spots.
ExpirationDatetimeformDateTimeNoWhen the hold expires (company-local time).
StatusCodeformintNoThe BookingReservationStatus value.
StatusNameformstringYesThe BookingReservationStatus name.
CustomerIdformGuid?NoThe customer id holding the reservation, if any.
CustomerNameformstringYesThe customer's full name, when a customer is attached.
CustomerEmailformstringYesThe customer email (falls back to the BookedBy email when no customer is attached).

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /admin/bookingreservations HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Results":[{"Id":0,"ServiceId":0,"NumberOfBookedSpots":0,"StatusCode":0,"StatusName":"String","CustomerId":"00000000-0000-0000-0000-000000000000","CustomerName":"String","CustomerEmail":"String"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}