Recuperar información de las reservas
Última modificación: 13/05/2025
Información de las reservas
Se obtienen la información de la reserva solicitada mediante su identificador. Se podrá indicar con el parametro “findOcurrences” si se quiere recuperar también la recurrencia en caso de que exista.
Por defecto el parámetro “findOcurrences” vendrá a false y en caso de que se quiera recuperar las ocurrencias de una reserva sin recurrencia este parámetro no se devolverá, cosa que si se hará con los demás datos de la reserva siempre y cuando se cumplan las siguientes condiciones:
- Si la reserva esta cancelada, expirada o ha finalizado se devolverá una excepción indicando que no se ha podido encontrar dicha reserva.
- Si la fecha de fin de reserva es anterior a la fecha actual, también retornará la excepción anterior (no se ha podido encontrar la reserva).
- Para diferenciar si una reserva es de un puesto o de un espacio, comedor o parking, se diferenciará por el campo resource.subcategory.category.
Request
HTTP request
GET /api/v2/user/bookings/{bookingId}?findOcurrences=true
Params
| Param | Value | Required |
|---|---|---|
| findOcurrences | true / false | false |
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… | true |
| app-version | versión app | true |
Response
Se devuelve un código 200 con la información de la reserva en el cuerpo de la respuesta. Se adjuntan dos ejemplos en formato Json de diferentes categorías de recursos.
ESPACIO
{
"booking": {
"id": "9ee93b79-801d-4341-b15b-3b42f8ae0c85",
"recurrentId": "c99d971b-f1b9-49ba-9e1a-71f61a35ab5d",
"startDate": 1746011700000,
"endDate": 1746015300000,
"duration": 3600000,
"status": "PENDING",
"accessControlType": "ORGANIZER",
"creator": {
"id": "7c008797-7ce7-4b6b-9907-8692f855f538",
"name": "Alex",
"surname": "Jupiter",
"alias": "96e9df13309d4720bcc2a9cffbdba213",
"upn": "alex@bookker.es",
"email": "alexander.fernandez@bookkercorp.com",
"phone": "666555444",
"landLine": "900800700",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "3e304417-61d7-4527-b016-8e2572893ecb"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T10:19:49.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-30T07:50:33.000+00:00",
"workingCalendarId": "80ef3925-296a-4dab-93b7-550f43e36a69",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "3e304417-61d7-4527-b016-8e2572893ecb",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"organizer": {
"id": "7c008797-7ce7-4b6b-9907-8692f855f538",
"name": "Alex",
"surname": "Jupiter",
"alias": "96e9df13309d4720bcc2a9cffbdba213",
"upn": "alex@bookker.es",
"email": "alexander.fernandez@bookkercorp.com",
"phone": "666555444",
"landLine": "900800700",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "3e304417-61d7-4527-b016-8e2572893ecb"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T10:19:49.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-30T07:50:33.000+00:00",
"workingCalendarId": "80ef3925-296a-4dab-93b7-550f43e36a69",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "3e304417-61d7-4527-b016-8e2572893ecb",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"resource": {
"id": "02d5eb35-3860-4a1a-b6fd-fc269b8eedbf",
"name": "Snorlax 143",
"posterCode": "B-P1-REST-143",
"approachable": false,
"floor": {
"id": "14ab4017-1261-46ff-af05-eadf5d3d69e8",
"name": "Planta 1",
"floorNumber": 1,
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/floors/40d25abc74f043f4afff218f02d2e024.png",
"building": {
"id": "758a81f3-f171-404b-b48c-c922828aed49",
"name": "Jupiter Building",
"address": {
"country": "ES",
"city": "Madrid",
"address": "Avenida Gran Vía, 85"
},
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"timezone": "Europe/Madrid",
"status": "ACTIVATED",
"visible": true,
"currency": "EUR"
},
"status": "ACTIVATED",
"type": "OFFICE",
"visible": true,
"buildingId": "758a81f3-f171-404b-b48c-c922828aed49"
},
"subcategory": {
"id": "467e845c-b5b2-4f2d-bc9a-ed1f6fd2dae5",
"name": "Sala De Descanso",
"category": "SPACE",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"deleteHistorial": false,
"hideBookings": false,
"canBeSearched": true,
"shifts": false,
"shiftsDailyBooking": false,
"simultaneousBookingsType": "SAME_CATEGORY_AND_SUBCATEGORY",
"priority": 0
},
"resourceRule": {
"id": "b7d1b637-e263-4616-ad56-ba59bf25e8fd",
"advanceCheckIn": 900000,
"expirationMargin": 14400000,
"startTime": 25200000,
"endTime": 83700000,
"maximumDuration": 116100000,
"maximumAdvance": 35,
"accessControlType": "ORGANIZER",
"requiresApproval": false,
"allDayBookings": false,
"allDayBookingsCheckInMS": 57600000,
"fixedResourcesAccessControlType": "OPTIONAL",
"maxSpaceBooking": {
"time": 86400000,
"maxSpaceBookingType": "DAILY"
},
"maximumCessionRecovery": 864000000
},
"visible": true,
"status": "ACTIVATED",
"group": {
"id": "240ae656-b546-40e0-9779-85a3cc586a84"
},
"capacity": 1,
"building": {
"id": "758a81f3-f171-404b-b48c-c922828aed49",
"name": "Jupiter Building",
"address": {
"country": "ES",
"city": "Madrid",
"address": "Avenida Gran Vía, 85"
},
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"timezone": "Europe/Madrid",
"status": "ACTIVATED",
"visible": true,
"currency": "EUR"
}
},
"buildingAccessStatus": "PENDING",
"createdDate": 1745924163000,
"subject": "Test Booking Info Alex",
"body": {
"content": "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>test</p></body></html>",
"bodyType": "HTML"
},
"importance": "NORMAL",
"resourceType": "SPACE",
"internalAttendees": [
{
"id": "2205f578-85a0-41e6-a283-b3eede631c7e",
"type": "REQUIRED",
"status": "NEEDS_ACTION",
"bookingId": "9ee93b79-801d-4341-b15b-3b42f8ae0c85",
"user": {
"id": "789d3337-8e06-45f0-a4c9-0f68d3473748",
"name": "Sergio",
"surname": "Júpiter",
"alias": "acafaed219ce4de1be52203b8c13cf4d",
"upn": "s@bookker.es",
"email": "sergio.batuecas@bookkercorp.com",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c53bfed2-336e-4b54-9359-e3eb02a14a59"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "988b70fc-9012-4be5-95ab-05450c10eaa0"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T11:50:48.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-24T09:15:30.000+00:00",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "988b70fc-9012-4be5-95ab-05450c10eaa0",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c53bfed2-336e-4b54-9359-e3eb02a14a59"
}
},
{
"id": "92b217c5-d969-4196-a2fb-48d6226b469c",
"type": "ORGANIZER",
"status": "ACCEPTED",
"bookingId": "9ee93b79-801d-4341-b15b-3b42f8ae0c85",
"user": {
"id": "7c008797-7ce7-4b6b-9907-8692f855f538",
"name": "Alex",
"surname": "Jupiter",
"alias": "96e9df13309d4720bcc2a9cffbdba213",
"upn": "alex@bookker.es",
"email": "alexander.fernandez@bookkercorp.com",
"phone": "666555444",
"landLine": "900800700",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "3e304417-61d7-4527-b016-8e2572893ecb"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T10:19:49.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-30T07:50:33.000+00:00",
"workingCalendarId": "80ef3925-296a-4dab-93b7-550f43e36a69",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "3e304417-61d7-4527-b016-8e2572893ecb",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c796bc2d-e000-4d07-b5da-4d334d66a770"
}
}
],
"externalAttendees": [
{
"id": "77edf058-7fe3-44ce-941e-91fd261cdb38",
"type": "REQUIRED",
"status": "NEEDS_ACTION",
"bookingId": "9ee93b79-801d-4341-b15b-3b42f8ae0c85",
"email": "testingexternal00007@gmail.com"
}
]
},
"ocurrences": [
{
"id": "9ee93b79-801d-4341-b15b-3b42f8ae0c85",
"startDate": 1746011700000
},
{
"id": "dfc55465-63e5-44d1-b78c-1e3d26e12934",
"startDate": 1746098100000
}
]
}
PARKING
{
"booking": {
"id": "33c5bf21-3c75-4896-bb6d-a8731f6d395c",
"recurrentId": "bf5cc16f-93da-4a57-9db4-5f6cf2354c7b",
"startDate": 1746000000000,
"endDate": 1746000900000,
"duration": 900000,
"status": "PENDING",
"accessControlType": "ORGANIZER",
"creator": {
"id": "7c008797-7ce7-4b6b-9907-8692f855f538",
"name": "Alex",
"surname": "Jupiter",
"alias": "96e9df13309d4720bcc2a9cffbdba213",
"upn": "alex@bookker.es",
"email": "alexander.fernandez@bookkercorp.com",
"phone": "666555444",
"landLine": "900800700",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "3e304417-61d7-4527-b016-8e2572893ecb"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T10:19:49.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-30T07:50:33.000+00:00",
"workingCalendarId": "80ef3925-296a-4dab-93b7-550f43e36a69",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "3e304417-61d7-4527-b016-8e2572893ecb",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"organizer": {
"id": "7c008797-7ce7-4b6b-9907-8692f855f538",
"name": "Alex",
"surname": "Jupiter",
"alias": "96e9df13309d4720bcc2a9cffbdba213",
"upn": "alex@bookker.es",
"email": "alexander.fernandez@bookkercorp.com",
"phone": "666555444",
"landLine": "900800700",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"webRole": {
"id": "3e304417-61d7-4527-b016-8e2572893ecb"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es",
"acceptedBookkerPolicy": true,
"acceptedBookkerPolicyDate": "2023-10-11T10:19:49.000+00:00",
"acceptedCustomPolicy": true,
"acceptedCustomPolicyDate": "2024-09-30T07:50:33.000+00:00",
"workingCalendarId": "80ef3925-296a-4dab-93b7-550f43e36a69",
"timeZone": "Europe/Madrid",
"status": "ACTIVATED",
"dataSource": "UNKNOWN",
"ocrType": "TESSERACT",
"webRoleId": "3e304417-61d7-4527-b016-8e2572893ecb",
"mobileRoleId": "1dfde059-da65-49c9-8db3-dccc4f3292e4",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"userRuleId": "c796bc2d-e000-4d07-b5da-4d334d66a770"
},
"resource": {
"id": "d1013e0b-8565-4e1b-85be-42abeacf108a",
"name": "Parking 341",
"posterCode": "B-S1-PARK-341",
"approachable": false,
"floor": {
"id": "b60c8462-0c40-4f61-b9ce-1e1179f49da1",
"name": "Sótano 1",
"floorNumber": -1,
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/floors/9f14e8a8597b44fd9ecfb17695d9ddf2.png",
"building": {
"id": "758a81f3-f171-404b-b48c-c922828aed49",
"name": "Jupiter Building",
"address": {
"country": "ES",
"city": "Madrid",
"address": "Avenida Gran Vía, 85"
},
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"timezone": "Europe/Madrid",
"status": "ACTIVATED",
"visible": true,
"currency": "EUR"
},
"status": "ACTIVATED",
"type": "PARKING",
"visible": true,
"buildingId": "758a81f3-f171-404b-b48c-c922828aed49"
},
"subcategory": {
"id": "6e0a5df1-2de7-40f3-8590-2f8e7bc45ef8",
"name": "Plaza De Parking",
"category": "PARKING",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"deleteHistorial": false,
"hideBookings": false,
"canBeSearched": true,
"shifts": false,
"shiftsDailyBooking": false,
"simultaneousBookingsType": "SAME_CATEGORY_DIFFERENT_SUBCATEGORY",
"priority": 0
},
"visible": true,
"status": "ACTIVATED",
"group": {
"id": "e97b9a4d-2fb5-48c4-ab90-3fd6dd9dfd3e"
},
"covered": true,
"parkingSlotSize": "BIG",
"electricCharger": true,
"electricChargerExternalUrl": "Testing_Electric_Charger_URL",
"building": {
"id": "758a81f3-f171-404b-b48c-c922828aed49",
"name": "Jupiter Building",
"address": {
"country": "ES",
"city": "Madrid",
"address": "Avenida Gran Vía, 85"
},
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"timezone": "Europe/Madrid",
"status": "ACTIVATED",
"visible": true,
"currency": "EUR"
}
},
"buildingAccessStatus": "PENDING",
"createdDate": 1745924342000,
"resourceType": "PARKING",
"vehicle": {
"id": "33456b74-9bd2-4886-8256-f12b0c0bcbb3",
"licensePlate": "9999AAA",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"brand": "MTEST",
"model": "TS",
"color": "VERDE",
"type": "MOTORCYCLE"
}
},
"ocurrences": [
{
"id": "33c5bf21-3c75-4896-bb6d-a8731f6d395c",
"startDate": 1746000000000
},
{
"id": "377332b8-1822-4d5c-a917-de7f84ea4c2c",
"startDate": 1746086400000
},
{
"id": "b84d89db-7389-4eda-8b33-5fda88b0088b",
"startDate": 1746172800000
}
]
}