# Weekend Getaway Decision Brief

> Weekend Getaway Decision Brief is a paid API for AI agents from travel-agent.forgemesh.io, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-16).

Generates a comprehensive weekend getaway planning brief with weather context, local leads, transit strategy, lodging posture, optional currency context, and next-step actions before booking.

## Facts

- Endpoint: GET https://travel-agent.forgemesh.io/api/weekend-getaway
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weekend-getaway-decision-brief-9b8decdf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zDQvq9GcpSMNMUH5bPKgP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability weekend-getaway-decision-brief-9b8decdf
```

Example prompt: Give me a weekend getaway decision brief for a trip from Austin to Santa Fe, departing Friday June 13 and returning Sunday June 15, budget around $600, nature trip style, boutique lodging, driving only, max 5 hours travel — and include currency context since I'm unfamiliar with local tipping norms.

## When to prefer this

Choose this endpoint when a user wants a pre-booking decision brief for a weekend trip rather than a full multi-day itinerary generator or a raw weather lookup. It is ideal when the agent needs to synthesize weather awareness, transit options, lodging posture, and local context into a single actionable summary to help a user decide whether and how to take a weekend trip before any bookings are made.

## Known failure modes

- Missing required destination or coordinates returns a 400 error
- Invalid or past date ranges may yield unhelpful or empty weather context
- Unsupported destination regions may result in sparse local context leads
- Network or upstream weather data failures return 5xx errors
- Overly broad or conflicting parameters (e.g. max 1 hour travel but destination 10 hours away) may result in low-confidence output

## How this service works

Returns a day-by-day weekend shape (arrival, main day), a lodging posture recommendation, and transit strategy, with confidence caveats. Use to draft a 2-3 day trip between an origin and destination.

## Output

Returns a structured decision brief covering weather suitability and outdoor fit for the destination dates, curated local context leads, a transit strategy with recommended transportation modes, a lodging posture recommendation aligned to budget and style, optional currency or tipping context, and a set of concrete next actions to take before booking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "string"
      },
      "lon": {
       "type": "string"
      },
      "budget": {
       "type": "string"
      },
      "origin": {
       "type": "string"
      },
      "end_date": {
       "type": "string"
      },
      "start_date": {
       "type": "string"
      },
      "trip_style": {
       "type": "string"
      },
      "destination": {
       "type": "string"
      },
      "lodging_style": {
       "type": "string"
      },
      "destination_currency": {
       "type": "string"
      },
      "transportation_modes": {
       "type": "string"
      },
      "max_distance_or_travel_time": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "category": "weekend_getaway",
   "confidence": "medium",
   "why_not_high": [
    "This endpoint does not verify live booking inventory, prices, fees, permits, cancellation rules, or crowding."
   ],
   "weekend_shape": {
    "arrival": "...",
    "main_day": "..."
   },
   "lodging_posture": {
    "consider": "..."
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/weekend-getaway-decision-brief-9b8decdf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from travel-agent.forgemesh.io](https://www.zero.xyz/host/travel-agent.forgemesh.io/llms.txt)