# HalfwayAPI Meet-Halfway

> HalfwayAPI Meet-Halfway is a paid API for AI agents from halfwayapi.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-12).

Finds a fair halfway meeting point between two locations and returns ranked venue suggestions by equal travel time for a given travel mode.

## Facts

- Endpoint: POST https://halfwayapi.com/v1/meet-halfway?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halfwayapi-meet-halfway-7b7b0b80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4nnIqRCchtANEGe5oKPnA

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 halfwayapi-meet-halfway-7b7b0b80 -d '<json body>'
```

Example prompt: Can you find a fair halfway meeting spot between 123 Main St, Brooklyn NY and 456 Park Ave, Manhattan NY? We'll be driving and want a cafe.

## When to prefer this

Use this endpoint when you need to find a neutral, geographically fair meeting venue between exactly two parties coming from different locations. It is ideal for coordinating in-person meetups, business meetings, or casual hangouts where fairness of travel burden matters. Prefer this over generic map search when ranked-by-equal-travel-time is the key requirement and no API key setup is desired.

## Known failure modes

- Origins resolve to locations more than 250 km or less than 50 meters apart — returns error
- Unrecognizable or ambiguous place names that cannot be geocoded — returns geocoding error
- No matching venues of the requested type found near the midpoint — returns empty results
- Invalid travel mode or venue type enum value — returns validation error

## How this service works

Find a fair halfway meeting point between two addresses or place names. Returns three reachable cafes, restaurants, coworking spaces, parks, or EV chargers ranked by equal travel time for driving, walking, or bicycling. No API key or account required.

## Output

Returns up to three ranked venue candidates (cafe, restaurant, coworking space, park, or EV charger) near the geographic halfway point, ordered by how equalized the travel times are from each origin, including venue names, addresses, and estimated travel times for each party.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "drive",
    "walk",
    "bicycle"
   ],
   "type": "string",
   "description": "Travel mode used to compare each origin's trip to every candidate."
  },
  "origins": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 240,
    "minLength": 1
   },
   "maxItems": 2,
   "minItems": 2,
   "description": "Two distinct addresses or place descriptions to meet between, resolving 50 meters to 250 kilometers apart."
  },
  "venueType": {
   "enum": [
    "cafe",
    "restaurant",
    "coworking",
    "park",
    "ev_charger"
   ],
   "type": "string",
   "description": "Type of halfway meeting place to return."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halfwayapi-meet-halfway-7b7b0b80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from halfwayapi.com](https://www.zero.xyz/host/halfwayapi.com/llms.txt)