curl --request GET \
  --url https://api.example.com/v1/flights/{id}/returns \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.example.com/v1/flights/{id}/returns"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/flights/{id}/returns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "took_ms": 1420,
  "request": {
    "query": "coffee",
    "country": "us",
    "page": 1
  },
  "results": [
    {
      "position": 1,
      "segments": [
        {
          "from": {
            "id": "SIN",
            "name": "Singapore Changi Airport",
            "time": "2026-10-15 09:20"
          },
          "to": {
            "id": "SIN",
            "name": "Singapore Changi Airport",
            "time": "2026-10-15 09:20"
          },
          "departure": "2026-10-15 09:20",
          "arrival": "2026-10-15 17:35",
          "airline": "Singapore Airlines",
          "flight_number": "SQ 634",
          "duration": 435,
          "aircraft": "Boeing 787"
        }
      ],
      "id": "san1.QkFEQ0FGRTAxMjM0NTY3ODk",
      "recommended": true,
      "price": 698,
      "currency": "USD",
      "total_duration": 495,
      "layovers": [
        {
          "id": "HKG",
          "name": "Hong Kong International Airport",
          "duration": 180,
          "overnight": false
        }
      ],
      "carbon_grams": 421000,
      "next_day": true,
      "type": "Round trip"
    }
  ],
  "next_page": null,
  "price_insights": {
    "lowest_price": 457,
    "price_level": "typical"
  },
  "selected_outbound": {
    "segments": [
      {
        "from": {
          "id": "SIN",
          "name": "Singapore Changi Airport",
          "time": "2026-10-15 09:20"
        },
        "to": {
          "id": "SIN",
          "name": "Singapore Changi Airport",
          "time": "2026-10-15 09:20"
        },
        "departure": "2026-10-15 09:20",
        "arrival": "2026-10-15 17:35",
        "airline": "Singapore Airlines",
        "flight_number": "SQ 634",
        "duration": 435,
        "aircraft": "Boeing 787"
      }
    ]
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing parameter `query`.",
    "param": "query"
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing parameter `query`.",
    "param": "query"
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing parameter `query`.",
    "param": "query"
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing parameter `query`.",
    "param": "query"
  }
}