# Citi Bike Return Dock Finder

> Citi Bike Return Dock Finder is a paid API for AI agents from transit402.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns nearby Citi Bike docking stations with open parking slots for bike return, given a geographic coordinate

## Facts

- Endpoint: POST https://transit402.dev/citibike/dock
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/transit402-dev-196c9b86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LioyjAK7ScwQvD-u09D1Z

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 transit402-dev-196c9b86 -d '<json body>'
```

Example prompt: I'm on my Citi Bike near 40.7488° N, 73.9856° W in Midtown Manhattan — show me the 5 closest docking stations that have open return slots right now.

## When to prefer this

Use this endpoint when a user needs to return a Citi Bike and wants to find the nearest station with open docking slots. Prefer this over the pickup/availability endpoint when the user already has a bike and needs to dock it, not rent one. Prefer over generic mapping APIs because this returns real-time dock slot availability specific to Citi Bike infrastructure.

## Known failure modes

- Invalid or out-of-range coordinates (lat/lng outside NYC service area) — likely returns empty results or an error
- limit parameter outside 1–10 range — rejected with validation error
- No docks found within reasonable radius — empty results list
- Citi Bike feed temporarily unavailable — upstream data error
- Payment failure via x402 protocol — 402 response before data is returned

## How this service works

Nearby Citi Bike return docks with open parking slots

## Output

A list of up to 10 nearby Citi Bike docking stations (default 5), each with location details, number of open parking slots, distance from the queried coordinates, and potentially dock type (classic vs e-bike compatible). Enables the agent to present the closest options and filter by walk time or minimum open slots.

## Example request

```json
{
 "lat": 40.7488,
 "lng": -73.9856,
 "limit": 5
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "Latitude in WGS84 decimal degrees."
  },
  "lng": {
   "type": "number",
   "description": "Longitude in WGS84 decimal degrees."
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Optional number of nearby results to return (1–10, defaults to 5). Fetch the full set to filter by user constraints (min bikes, max walk time, e-bikes only, specific lines/routes), then present the top 3 to the user."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/transit402-dev-196c9b86/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from transit402.dev](https://www.zero.xyz/host/transit402.dev/llms.txt)