{ "item": [ { "name": "get_cities_list", "description": "", "item": [ { "id": "f293ff1c-ce41-4fd5-96d0-001e862c649e", "name": "List known cities (optional helper)", "request": { "name": "List known cities (optional helper)", "description": { "content": "Returns the platform's known cities to help resolve a city for searching.", "type": "text/plain" }, "url": { "path": [ "get_cities_list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "a979c2f5-5f41-40c5-a871-88275ca9c6bf", "name": "Cities list.", "originalRequest": { "url": { "path": [ "get_cities_list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"country\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"country\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7ce23a6-6be0-4a43-91ef-eab7439acb36", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "get_cities_list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99be69b5-d821-4d4c-ba1a-2e2d4dbc9567", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "get_cities_list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "accommodation", "description": "", "item": [ { "name": "search", "description": "", "item": [ { "id": "38097d41-0211-4c38-a804-a577c1b200b5", "name": "Text search for cities, areas, landmarks and accommodations", "request": { "name": "Text search for cities, areas, landmarks and accommodations", "description": {}, "url": { "path": [ "accommodation", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Free-text search term, e.g. `Barcelona`.", "type": "text/plain" }, "key": "query", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "a2afd54e-36d9-4db4-b72a-ca0940ea18ac", "name": "Matching search results.", "originalRequest": { "url": { "path": [ "accommodation", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Free-text search term, e.g. `Barcelona`.", "type": "text/plain" }, "key": "query", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"data\": [\n {\n \"name\": \"\",\n \"sub_name\": \"\",\n \"search_by_id\": \"\",\n \"search_by_type\": 0,\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n {\n \"name\": \"\",\n \"sub_name\": \"\",\n \"search_by_id\": \"\",\n \"search_by_type\": 2,\n \"latitude\": \"\",\n \"longitude\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "441ff3fe-dbc2-4af7-9a04-a622ff1bd8c0", "name": "Malformed body / failed validation.", "originalRequest": { "url": { "path": [ "accommodation", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Free-text search term, e.g. `Barcelona`.", "type": "text/plain" }, "key": "query", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc608a0c-3ca0-406e-9ab0-9f6891019b61", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Free-text search term, e.g. `Barcelona`.", "type": "text/plain" }, "key": "query", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c799a7f4-0f95-4c97-a754-9e8920bde4e3", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Free-text search term, e.g. `Barcelona`.", "type": "text/plain" }, "key": "query", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "bookings", "description": "", "item": [ { "name": "checkout", "description": "", "item": [ { "id": "58649001-1ee1-427e-978f-cb2ecaf4cf49", "name": "Lock / re-validate the chosen option's price", "request": { "name": "Lock / re-validate the chosen option's price", "description": { "content": "Re-validates the selected option and returns an `invoice_id` to confirm against.", "type": "text/plain" }, "url": { "path": [ "accommodation", "bookings", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "4c33ae86-4d27-4788-a03e-ffd8f836cbf0", "name": "Locked price + invoice to confirm against.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"invoice_id\": \"\",\n \"booking_code\": \"\",\n \"nett_price\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"currency_code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a3d6084-6275-4105-859f-b4e6e1ed74ff", "name": "The quoted rate is no longer available — re-run availability/checkout.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8827a2bc-e29a-4345-9517-aacb3deb1d63", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8233040a-f30c-4c70-bcd6-1686a8e3ca0d", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "confirm_booking", "description": "", "item": [ { "id": "fe066205-ae8d-46b5-a6b0-31ada02c45b6", "name": "Confirm the booking (attributes it to your agency)", "request": { "name": "Confirm the booking (attributes it to your agency)", "description": { "content": "Creates the booking and attributes it to your agency in the CRM. Send a\nstable `idempotency_key` in the body **and** the `Idempotency-Key`\nheader (same value): a retry/timeout then replays the original response\ninstead of double-booking. The replayed response carries\n`Idempotency-Replayed: true`.\n", "type": "text/plain" }, "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c61818c5-717e-4410-b89c-1557c5bd6bc6", "name": "Booking confirmed.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "`true` when this is a replay of a prior identical request.", "type": "text/plain" }, "key": "Idempotency-Replayed", "value": "" } ], "body": "{\n \"booking_number\": \"\",\n \"is_confirmed\": \"\",\n \"is_cancelled\": \"\",\n \"total_price\": \"\",\n \"currency_code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "400a69e5-3803-41de-9d2f-3743818df50d", "name": "Malformed body / failed validation.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f69394b-d93e-4762-9615-46d1d9a85b2f", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7001b7cc-842a-4d4b-a68c-70b347a1dc7e", "name": "Payment not confirmed for the invoice.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e63d60cc-3246-456c-abb5-37166b2f83fe", "name": "Duplicate confirm / invoice already used (retry-safe — the original booking stands).", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6ba7f18-c13a-49ba-b20a-5c0e4e892932", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "688ddb9a-fa01-4315-be31-ed4d790158db", "name": "Vendor-side failure; the charge was refunded — safe to retry.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "confirm_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "disabled": false, "description": { "content": "Stable unique value (e.g. a UUID) per booking attempt. Remembered for 24h.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"vendor\": \"\",\n \"booking_code\": \"\",\n \"invoice_id\": \"\",\n \"idempotency_key\": \"\",\n \"payment_type\": \"\",\n \"currency_code\": \"\",\n \"guests_information\": [\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n },\n {\n \"room_no\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"is_lead_guest\": \"\",\n \"title\": \"\",\n \"age\": \"\",\n \"nationality\": \"\"\n }\n ],\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"nett_price\": \"\",\n \"base_price\": \"\",\n \"base_currency\": \"\",\n \"guests_room_distribution\": [\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"guest_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"board_plan_text\": \"\",\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ],\n \"agencies_internal_booking_ref\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "cancel_booking", "description": "", "item": [ { "id": "819f5163-4115-4f0b-97c4-c24c92757a8c", "name": "Cancel a booking", "request": { "name": "Cancel a booking", "description": { "content": "Cancels a booking, subject to the rate's cancellation policy / fees.", "type": "text/plain" }, "url": { "path": [ "accommodation", "bookings", "cancel_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "38cd6f43-13ef-4402-a298-7c42baca5c86", "name": "Cancellation accepted.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "cancel_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"message\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8da4d1e4-ed80-4bae-9f2e-8aa74927a439", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "cancel_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "345b0f42-8b73-43fa-9e32-a1f571167a77", "name": "Resource not found.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "cancel_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a8bcefe-f430-4b15-8925-bc70c20116c9", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "cancel_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "list_bookings", "description": "", "item": [ { "id": "94e0b807-d24b-4f40-9dac-8b468f78f4a7", "name": "List your agency's bookings (paginated)", "request": { "name": "List your agency's bookings (paginated)", "description": {}, "url": { "path": [ "accommodation", "bookings", "list_bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fee2d89c-c49e-4625-8159-8d11aaac962c", "name": "A page of bookings.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "list_bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"current_page\": \"\",\n \"total_pages\": \"\",\n \"no_of_items\": \"\",\n \"data\": [\n {\n \"booking_number\": \"\",\n \"accommodation_name\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"is_confirmed\": \"\",\n \"is_cancelled\": \"\",\n \"total_price\": \"\",\n \"currency_code\": \"\",\n \"agencies_internal_booking_ref\": \"\"\n },\n {\n \"booking_number\": \"\",\n \"accommodation_name\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"is_confirmed\": \"\",\n \"is_cancelled\": \"\",\n \"total_price\": \"\",\n \"currency_code\": \"\",\n \"agencies_internal_booking_ref\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3453b91e-f1c4-4b5d-81b6-b48c6c8ac366", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "list_bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d7803a0-48a9-41c7-a294-13118c43cda9", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "list_bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "get_booking", "description": "", "item": [ { "id": "eebb6d32-0933-41bc-9bc3-26e4ee04a9be", "name": "Resolve a stable booking_id (or booking_number) to its current state", "request": { "name": "Resolve a stable booking_id (or booking_number) to its current state", "description": { "content": "Returns the CURRENT active booking for a stable `booking_id` (which\nsurvives SBPO rebooking) or an integer `booking_number`, including a\n`rebooking` block when the booking was rebooked to a cheaper rate. The\npartner stores `booking_id` and uses this to map it to the live\n`booking_number` (e.g. before cancelling). See REBOOKING_FOR_PARTNERS.md.\n", "type": "text/plain" }, "url": { "path": [ "accommodation", "bookings", "get_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e9d98ea9-7215-4783-9864-4e0f331a7f50", "name": "Current booking state (+ rebooking block if rebooked).", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "get_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\",\n \"accommodation_name\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"is_confirmed\": \"\",\n \"is_cancelled\": \"\",\n \"total_price\": \"\",\n \"currency_code\": \"\",\n \"agencies_internal_booking_ref\": \"\",\n \"rebooking\": {\n \"rebooked\": \"\",\n \"times_rebooked\": \"\",\n \"original_booking_number\": \"\",\n \"gross_savings\": \"\",\n \"trekko_fee\": \"\",\n \"partner_savings\": \"\",\n \"credited_to\": \"credit_balance\",\n \"last_rebooked_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfe23500-b1c3-44af-a2ff-b09928b839ed", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "get_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4ded4ba-2ecc-4bc6-86ec-3f93ea92d3d9", "name": "Resource not found.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "get_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e252af3-3f19-4aa4-99d8-85d4e6cfd8e5", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodation", "bookings", "get_booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"booking_number\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "account", "description": "", "item": [ { "name": "balance", "description": "", "item": [ { "id": "b720f390-7532-4db2-a236-3a4f468320f1", "name": "Partner account balance (virtual wallet or credit balance)", "request": { "name": "Partner account balance (virtual wallet or credit balance)", "description": {}, "url": { "path": [ "accommodation", "account", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "e8bf4042-06b3-4dc4-9929-eb82b9f22e1e", "name": "Balance.", "originalRequest": { "url": { "path": [ "accommodation", "account", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"currency_code\": \"\",\n \"funding_type\": \"credit\",\n \"virtual_wallet\": \"\",\n \"credit_balance\": \"\",\n \"credit_limit\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68ef4ab4-03e4-48c1-ad65-10a731223738", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "account", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "savings", "description": "", "item": [ { "id": "d68a041b-c8af-414d-be28-ccea99393b20", "name": "Rebooking savings ledger (paginated, + lifetime totals)", "request": { "name": "Rebooking savings ledger (paginated, + lifetime totals)", "description": { "content": "One row per SBPO rebooking — the \"we saved you €X after booking\" data.", "type": "text/plain" }, "url": { "path": [ "accommodation", "account", "savings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8954160e-f6c4-4f03-80c1-96bae45f57f4", "name": "Savings ledger page.", "originalRequest": { "url": { "path": [ "accommodation", "account", "savings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"current_page\": \"\",\n \"total_pages\": \"\",\n \"total_partner_savings\": \"\",\n \"total_trekko_fee\": \"\",\n \"currency_code\": \"\",\n \"data\": [\n {\n \"booking_id\": \"\",\n \"rebooked_at\": \"\",\n \"gross_savings\": \"\",\n \"trekko_fee\": \"\",\n \"partner_savings\": \"\",\n \"credited_to\": \"\"\n },\n {\n \"booking_id\": \"\",\n \"rebooked_at\": \"\",\n \"gross_savings\": \"\",\n \"trekko_fee\": \"\",\n \"partner_savings\": \"\",\n \"credited_to\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46958050-d5c5-4b12-b307-fbe22ad1dea6", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "account", "savings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"page_no\": 1,\n \"items_per_page\": 20\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "webhooks", "description": "", "item": [ { "id": "5de821c3-c3ac-4367-9675-4379a9fc72fb", "name": "Register an outbound webhook endpoint (returns the signing secret once)", "request": { "name": "Register an outbound webhook endpoint (returns the signing secret once)", "description": { "content": "Register an HTTPS URL to receive signed events (e.g. `booking.rebooked`).\nThe `signing_secret` is returned ONCE. Each delivery carries a\n`Trekko-Signature: t=,v1=` header where\n`v1 = HMAC_SHA256(secret, \".\")`. URLs resolving to\nprivate/loopback/metadata addresses are rejected.\n", "type": "text/plain" }, "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\",\n \"events\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5e7dcffc-ccf1-4743-8cea-1e62b68a03c8", "name": "Endpoint registered; signing secret shown once.", "originalRequest": { "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\",\n \"events\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"url\": \"\",\n \"events\": \"\",\n \"signing_secret\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9b04b49-c3b8-4e5a-9ff6-cb7129ac6ce4", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\",\n \"events\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "be8ebb4b-8d2b-4414-9509-d3aece8019b5", "name": "List your webhook endpoints (never returns the secret)", "request": { "name": "List your webhook endpoints (never returns the secret)", "description": {}, "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "575f116e-be7e-4dee-8851-3cdbfa0fd667", "name": "Endpoints.", "originalRequest": { "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"url\": \"\",\n \"events\": \"\",\n \"is_active\": \"\"\n },\n {\n \"id\": \"\",\n \"url\": \"\",\n \"events\": \"\",\n \"is_active\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e523d4f2-2efe-430e-bf51-a030c1285362", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodation", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "accommodations", "description": "", "item": [ { "name": "get_accommodation_availability", "description": "", "item": [ { "id": "ba3ddcea-a4af-40b2-9226-e93095d8a278", "name": "Live availability + bookable rate plans for a stay", "request": { "name": "Live availability + bookable rate plans for a stay", "description": { "content": "Returns bookable rate plans (prices **include your markup**) for a hotel\nover a date range. Carry every field you receive (`vendor`,\n`rate_plan_code`, `booking_code`, price fields, cancellation policy) into\ncheckout and confirm. `204` means no availability for that query.\n", "type": "text/plain" }, "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "4d554c3d-8f52-4d00-acb8-6883db667ec1", "name": "Availability with one or more bookable options.", "originalRequest": { "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"accommodation_id\": \"\",\n \"name\": \"\",\n \"options\": [\n {\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"booking_code\": \"\",\n \"board_plan_text\": \"\",\n \"nett_price\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"currency_code\": \"\",\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ]\n },\n {\n \"vendor\": \"\",\n \"rate_plan_code\": \"\",\n \"booking_code\": \"\",\n \"board_plan_text\": \"\",\n \"nett_price\": \"\",\n \"minimum_price\": \"\",\n \"maximum_price\": \"\",\n \"currency_code\": \"\",\n \"cancellation_policy\": \"\",\n \"cancellation_policy_rules\": [\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n },\n {\n \"from\": \"\",\n \"amount\": \"\",\n \"currency\": \"\"\n }\n ],\n \"rooms_data\": [\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n },\n {\n \"room_no\": \"\",\n \"room_code\": \"\"\n }\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5a1f054-5d13-4d9e-aa59-b793cbf3bb6f", "name": "No availability for this query.", "originalRequest": { "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4cb3e4e0-ae57-4c44-86db-7ab99dbcbfe8", "name": "The quoted rate is no longer available — re-run availability/checkout.", "originalRequest": { "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17f016bd-65cf-41f9-aaab-cda4e6260392", "name": "Missing/bad/inactive key or wrong secret.", "originalRequest": { "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58017689-ec1f-49da-a404-3791aa62a033", "name": "Per-key rate limit exceeded.", "originalRequest": { "url": { "path": [ "accommodations", "get_accommodation_availability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Response language. One of `en`, `es`, `fr`, `de`, `it`, `pt`. (This can only be one of en,es,fr,de,it,pt)", "type": "text/plain" }, "key": "Accept-Language", "value": "en" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accommodation_id\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"guests\": [\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n },\n {\n \"room_no\": \"\",\n \"adults\": \"\",\n \"children_ages\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"nationality\": \"\",\n \"currency_code\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"internal_error\",\n \"message\": \"\",\n \"request_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ], "auth": { "type": "apikey", "apikey": [ { "type": "any", "value": "Authorization", "key": "key" }, { "type": "any", "value": "{{apiKey}}", "key": "value" }, { "type": "any", "value": "header", "key": "in" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.trekko.co/core" } ], "info": { "_postman_id": "659d2cb3-e3f8-4349-b127-8536f71a5d7e", "name": "Trekko Hotel API (Partner / Client)", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "B2B partner API for booking accommodation through Trekko using an **API key**\n(instead of the interactive web login). Every booking you confirm is\nattributed to **your agency** in Trekko's CRM, and prices already include\nyour configured **markup** (applied at egress on the Trekko side).\n\nThis document describes the **live** contract only (the 6 endpoints shipped\nin PR #47). The automated rebooking (SBPO) money-flow and webhook design is\ntracked separately in `REBOOKING_FOR_PARTNERS.md` and is **not** part of this\nlive spec yet — we keep the spec equal to what actually runs.\n\n### Conventions\n- All requests and responses are `application/json`.\n- **`Accept-Language` is required on every request** (`en`, `es`, `fr`, `de`,\n `it`, or `pt`); requests without a valid value are rejected.\n- Errors use a stable envelope (`error.code` is machine-readable and stable;\n `error.message` is human-readable and may change). Every response carries\n `X-Request-Id`.\n\n\nContact Support:\n Name: Trekko Developer Support", "type": "text/plain" } } }