# Flipvo Tollbooth Matrix

> Flipvo Tollbooth Matrix is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Computes a many-to-many driving time and distance matrix for up to 100 origin × destination location pairs in a single call.

## Facts

- Endpoint: POST https://api.flipvo.com/v1/matrix?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flipvo-tollbooth-matrix-a975fbb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YfUj9dKRi0a81wGRpsyQH

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 flipvo-tollbooth-matrix-a975fbb9 -d '<json body>'
```

Example prompt: Give me the driving times and distances for all combinations of these 3 distribution centers — Atlanta, Charlotte, and Nashville — to these 4 delivery stops: Memphis, Birmingham, Louisville, and Knoxville.

## When to prefer this

Choose this endpoint when you need driving times or distances for multiple origin–destination combinations simultaneously, rather than making repeated single-pair calls. It is ideal for logistics optimization, territory assignment, coverage analysis, or any scenario requiring a full time/distance matrix. Use the 'near' parameter to disambiguate location names in a specific region. Prefer this over the single-pair endpoint whenever you have more than one origin or destination.

## Known failure modes

- Invalid or unresolvable location strings return errors or null entries for those pairs
- Exceeding 100 origin×destination elements results in a validation error
- Ambiguous location names without a 'near' hint may resolve to wrong places
- Payment failure or invalid wallet returns 402 error before computation
- Network timeouts for large matrices with many geocoding lookups

## How this service works

Many-to-many driving time/distance matrix, up to 100 origin x destination elements per call.

## Output

A matrix of real-road driving times and distances for every combination of the provided origin and destination location strings, covering up to 100 total origin×destination elements per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "near": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Near",
   "default": null
  },
  "origins": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Origins",
   "maxItems": 100,
   "minItems": 1
  },
  "destinations": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Destinations",
   "maxItems": 100,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flipvo-tollbooth-matrix-a975fbb9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.flipvo.com](https://www.zero.xyz/host/api.flipvo.com/llms.txt)