Trips API¶

Endpoint¶

GET https://integrations.app.traveln.ai/api/v1/trips/{uuid}/

Retrieve a single trip by its unique identifier.

Authentication: Authorization: Api-Key <sso_hmac_secret>

Usage model: server-to-server only

Path parameters¶

Parameter	Type	Required	Description
`uuid`	string	Yes	Trip identifier

Example requests¶

cURLNode.jsPython

curl "https://integrations.app.traveln.ai/api/v1/trips/UUID_VALUE/" \
  -H "Authorization: Api-Key <sso_hmac_secret>" \
  -H "Accept: application/json"

const res = await fetch("https://integrations.app.traveln.ai/api/v1/trips/UUID_VALUE/", {
  headers: {
    Authorization: "Api-Key <sso_hmac_secret>",
    Accept: "application/json",
  },
})
const payload = await res.json()
console.log(payload)

import requests

res = requests.get(
    "https://integrations.app.traveln.ai/api/v1/trips/UUID_VALUE/",
    headers={
        "Authorization": "Api-Key <sso_hmac_secret>",
        "Accept": "application/json",
    },
    timeout=30,
)
payload = res.json()
print(payload)

Example response¶

{
  "success": true,
  "message": "Trip retrieved.",
  "data": {
    "id": "da97442d-209e-48f0-ad31-a96d31932c39",
    "title": "Entertainment Extravaganza in Dubai",
    "description": "This trip blends adventure, dining, and scenic experiences in Dubai.",
    "start_date": "2026-06-03T00:00:00Z",
    "end_date": "2026-06-05T23:59:59Z",
    "days": 3,
    "nights": 2,
    "chat_id": "72a4ad21-9235-42e2-8038-db21d177d5ee",
    "generated_by_ai": true,
    "cities": [
      {
        "id": "de59cb1a-092f-4c03-ab75-43c63d247a38",
        "name": "Dubai",
        "country": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9"
      }
    ],
    "countries": [
      {
        "id": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9",
        "code": "ae",
        "name": "United Arab Emirates"
      }
    ],
    "dates": [
      {
        "date": "2026-06-05",
        "description": "Experience the thrill of hot air ballooning, camel rides, and a dhow cruise.",
        "attractions": []
      }
    ],
    "accommodation": {
      "id": "1f7a0408-25be-4cfa-a59f-b826257d0e2f",
      "name": "Damac Maison Aykon City Dubai",
      "source": "HOTELBEDS"
    }
  },
  "error": null
}

Error responses¶

401 Unauthorized: missing or invalid integrations API secret.
404 Not Found: trip not found upstream.
502 Bad Gateway: upstream API could not be reached.
503 Service Unavailable: tenant backend API key is not configured.
Upstream 4xx and 5xx: returned with the same HTTP status and wrapped in the integrations error envelope.