{
  "info": {
    "name": "Tratok Labs Developer API",
    "description": "Public API for the Tratok hospitality ecosystem. Set the `id` and `secret` collection variables to your App ID and API key (issued from https://developer.tratok.net/account.php once your app is approved).",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "tratok-developer-api"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://developer.tratok.net",
      "type": "string"
    },
    {
      "key": "id",
      "value": "YOUR_APP_ID",
      "type": "string"
    },
    {
      "key": "secret",
      "value": "YOUR_SECRET",
      "type": "string"
    },
    {
      "key": "accessToken",
      "value": "MEMBER_ACCESS_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Accommodation",
      "item": [
        {
          "name": "hotelsInCountry",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "hotelsInCountry"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "country",
                  "value": "United Arab Emirates"
                }
              ]
            },
            "description": "Returns all hotels in the specified country."
          }
        },
        {
          "name": "hotelsInCity",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "hotelsInCity"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "city",
                  "value": "Dubai"
                }
              ]
            },
            "description": "Returns all hotels in the specified city."
          }
        },
        {
          "name": "getHotelInformation",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getHotelInformation"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "hotelId",
                  "value": "12345"
                }
              ]
            },
            "description": "Returns comprehensive details for a single hotel."
          }
        },
        {
          "name": "getHotelGallery",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getHotelGallery"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "hotelId",
                  "value": "12345"
                }
              ]
            },
            "description": "Returns image gallery URLs for a single hotel."
          }
        }
      ]
    },
    {
      "name": "Car Rental",
      "item": [
        {
          "name": "getListOfCarCities",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getListOfCarCities"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                }
              ]
            },
            "description": "Lists every city that has rental locations."
          }
        },
        {
          "name": "getListOfAllCarVenuesInCity",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getListOfAllCarVenuesInCity"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "city",
                  "value": "Dubai"
                }
              ]
            },
            "description": "Lists every rental venue in the given city."
          }
        },
        {
          "name": "getListOfCarsAtVenue",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getListOfCarsAtVenue"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "locationId",
                  "value": "DXB-001"
                }
              ]
            },
            "description": "Returns the car classes available at a specific rental venue."
          }
        }
      ]
    },
    {
      "name": "Translation",
      "item": [
        {
          "name": "supportedLanguages",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "supportedLanguages"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                }
              ]
            },
            "description": "Returns the list of languages supported by the translation engine."
          }
        },
        {
          "name": "detectLanguage",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "detectLanguage"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "text",
                  "value": "Hola, mundo"
                }
              ]
            },
            "description": "Detects the language of the given text and returns a confidence score."
          }
        },
        {
          "name": "translate",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "translate"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "text",
                  "value": "Hello, world"
                },
                {
                  "key": "sourceLanguage",
                  "value": "en"
                },
                {
                  "key": "targetLanguage",
                  "value": "fr"
                }
              ]
            },
            "description": "Translates text from a source language to a target language."
          }
        }
      ]
    },
    {
      "name": "Tara AI",
      "description": "Tratok's built-in AI assistant. Per-end-user conversation memory via conversationId. Billed per token: 1 TRAT per 1,000 input tokens, 4 TRAT per 1,000 output tokens. Tara is NOT included in the 1,000/month free tier: every call is paid in TRAT.",
      "item": [
        {
          "name": "taraChat",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "taraChat"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "message",
                  "value": "What hotels do you have in Dubai?"
                },
                {
                  "key": "conversationId",
                  "value": "user-42-session-abc"
                }
              ]
            },
            "description": "Send a message to Tara. Pass a stable conversationId to give an end-user a persistent thread."
          }
        },
        {
          "name": "taraReset",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "taraReset"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "conversationId",
                  "value": "user-42-session-abc"
                }
              ]
            },
            "description": "Clear the stored conversation history for a given conversationId."
          }
        }
      ]
    },
    {
      "name": "Cruises",
      "item": [
        {
          "name": "getCruiseRegions",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getCruiseRegions"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                }
              ]
            },
            "description": "Cruise regions with their number of upcoming sailings."
          }
        },
        {
          "name": "getCruiseLines",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getCruiseLines"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                }
              ]
            },
            "description": "Cruise lines with their number of upcoming sailings."
          }
        },
        {
          "name": "searchCruises",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "searchCruises"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "region",
                  "value": "caribbean"
                },
                {
                  "key": "nightsMin",
                  "value": "7"
                },
                {
                  "key": "sort",
                  "value": "price_low"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Upcoming voyages by text, region, line, port, month, nights and price."
          }
        },
        {
          "name": "getCruise",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getCruise"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "cruiseId",
                  "value": "3842"
                }
              ]
            },
            "description": "One sailing with its ship, itinerary, fares and other departures."
          }
        }
      ]
    },
    {
      "name": "Inventory and Booking",
      "item": [
        {
          "name": "searchStays",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "searchStays"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "city",
                  "value": "Dubai"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Search live Tratok stays by text, city, country or distance."
          }
        },
        {
          "name": "searchActivities",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "searchActivities"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "city",
                  "value": "Dubai"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Search live Tratok activities."
          }
        },
        {
          "name": "searchRestaurants",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "searchRestaurants"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "city",
                  "value": "Dubai"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Search live Tratok restaurants."
          }
        },
        {
          "name": "getListing",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getListing"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "vertical",
                  "value": "stays"
                },
                {
                  "key": "listingId",
                  "value": "1234"
                }
              ]
            },
            "description": "One listing with its rooms, packages and photos."
          }
        },
        {
          "name": "getQuote",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getQuote"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "accessToken",
                  "value": "{{accessToken}}"
                },
                {
                  "key": "vertical",
                  "value": "stays"
                },
                {
                  "key": "listingId",
                  "value": "1234"
                },
                {
                  "key": "roomId",
                  "value": "1"
                },
                {
                  "key": "checkIn",
                  "value": "2026-11-20"
                },
                {
                  "key": "checkOut",
                  "value": "2026-11-23"
                },
                {
                  "key": "guests",
                  "value": "2"
                }
              ]
            },
            "description": "A five-minute price in TRAT for the signed-in member (book scope)."
          }
        },
        {
          "name": "bookListing",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "bookListing"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "accessToken",
                  "value": "{{accessToken}}"
                },
                {
                  "key": "vertical",
                  "value": "stays"
                },
                {
                  "key": "listingId",
                  "value": "1234"
                },
                {
                  "key": "roomId",
                  "value": "1"
                },
                {
                  "key": "checkIn",
                  "value": "2026-11-20"
                },
                {
                  "key": "checkOut",
                  "value": "2026-11-23"
                },
                {
                  "key": "guests",
                  "value": "2"
                },
                {
                  "key": "quoteId",
                  "value": "QUOTE_ID"
                },
                {
                  "key": "idempotencyKey",
                  "value": "order-0001"
                }
              ]
            },
            "description": "Book the quote within five minutes; the member pays from their own Tratok balance. Use a unique idempotencyKey per attempt."
          }
        },
        {
          "name": "myBookings",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "myBookings"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "accessToken",
                  "value": "{{accessToken}}"
                },
                {
                  "key": "tab",
                  "value": "upcoming"
                }
              ]
            },
            "description": "The member's bookings made through your app: upcoming, past or cancelled."
          }
        },
        {
          "name": "getBooking",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "getBooking"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "accessToken",
                  "value": "{{accessToken}}"
                },
                {
                  "key": "bookingId",
                  "value": "1"
                }
              ]
            },
            "description": "One booking made through your app."
          }
        },
        {
          "name": "cancelBooking",
          "request": {
            "method": "POST",
            "url": {
              "raw": "{{baseUrl}}/data.php",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "data.php"
              ]
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "request",
                  "value": "cancelBooking"
                },
                {
                  "key": "id",
                  "value": "{{id}}"
                },
                {
                  "key": "secret",
                  "value": "{{secret}}"
                },
                {
                  "key": "accessToken",
                  "value": "{{accessToken}}"
                },
                {
                  "key": "bookingId",
                  "value": "1"
                }
              ]
            },
            "description": "Cancel under the listing's cancellation policy."
          }
        }
      ]
    }
  ]
}