{"uid":"cap_LioyjAK7ScwQvD-u09D1Z","slug":"transit402-dev-196c9b86","name":"Citi Bike Return Dock Finder","description":"Nearby Citi Bike return docks with open parking slots","url":"https://transit402.dev/citibike/dock","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{}},"example":{"request":{"lat":40.7488,"lng":-73.9856,"limit":5},"response":{"results":[{"lat":40.74765947,"lng":-73.98490707,"name":"E 33 St & 5 Ave","walk_minutes":3,"distance_feet":608,"bikes_available":0,"docks_available":51},{"lat":40.74901271,"lng":-73.98848395,"name":"6 Ave & W 33 St","walk_minutes":4,"distance_feet":875,"bikes_available":0,"docks_available":72},{"lat":40.74848023448579,"lng":-73.98255586624146,"name":"E 35 St & Madison Ave","walk_minutes":4,"distance_feet":958,"bikes_available":1,"docks_available":45},{"lat":40.74964,"lng":-73.98805,"name":"6 Ave & W 34 St","walk_minutes":4,"distance_feet":984,"bikes_available":1,"docks_available":58},{"lat":40.75038009,"lng":-73.98338988,"name":"W 37 St & 5 Ave","walk_minutes":5,"distance_feet":1187,"bikes_available":3,"docks_available":52}]}},"exampleRequest":{"lat":40.7488,"lng":-73.9856,"limit":5},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UgFMlboU89P5Ohlwz8oDD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns nearby Citi Bike docking stations with open parking slots for bike return, given a geographic coordinate","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Commuter finds nearest bike return","prompt":"I just finished my ride and I'm at 40.7505° N, 73.9972° W near Grand Central — where's the closest Citi Bike station with an open dock I can return to?"},{"title":"Tourist plans evening bike route","prompt":"We're biking around Central Park and want to end our trip near Times Square. Can you find me Citi Bike docks with available slots within walking distance of 40.7580° N, 73.9855° W?"},{"title":"Delivery agent completes last pickup","prompt":"I'm at 40.7128° N, 73.9352° W in Lower Manhattan and need to return my Citi Bike before heading home — show me the nearest stations with open return slots so I can dock quickly."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:55.048Z","isFirstParty":false}