{"uid":"cap_IVEhCeMVTpRcR9U7F9HuB","slug":"mapbox-geocode-reverse-1d1873b6","name":"Mapbox Reverse Geocode","description":"Convert geographic coordinates (longitude, latitude) to an address or place name.","url":"https://mapbox.mpp.paywithlocus.com/mapbox/geocode-reverse?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["longitude","latitude"],"properties":{"limit":{"type":"number","description":"Maximum number of results (1-5, default 1)"},"types":{"type":"string","description":"Filter by feature type"},"country":{"type":"string","description":"Comma-separated ISO 3166-1 alpha-2 country codes"},"language":{"type":"string","description":"IETF language tag for results"},"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"worldview":{"type":"string","description":"Worldview code"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"limit":1,"language":"en","latitude":40.7484,"longitude":-73.9967},"response":{"data":{"type":"FeatureCollection","features":[{"id":"dXJuOm1ieGFkcjpiYWY4YTg5MC1jMTAwLTRlZmEtYjc2MS00YTYyNzAzMWU2ZDg","type":"Feature","geometry":{"type":"Point","coordinates":[-73.99669,40.74853]},"properties":{"name":"300 West 28th Street","context":{"place":{"name":"New York City","mapbox_id":"dXJuOm1ieHBsYzpEZTVJN0E","wikidata_id":"Q60","translations":{"en":{"name":"New York City","language":"en"}}},"region":{"name":"New York","mapbox_id":"dXJuOm1ieHBsYzpBYVRz","region_code":"NY","wikidata_id":"Q1384","translations":{"en":{"name":"New York","language":"en"}},"region_code_full":"US-NY"},"street":{"name":"West 28th Street","mapbox_id":"dXJuOm1ieGFkci1zdHI6YmFmOGE4OTAtYzEwMC00ZWZhLWI3NjEtNGE2MjcwMzFlNmQ4"},"address":{"name":"300 West 28th Street","mapbox_id":"dXJuOm1ieGFkcjpiYWY4YTg5MC1jMTAwLTRlZmEtYjc2MS00YTYyNzAzMWU2ZDg","street_name":"West 28th Street","address_number":"300"},"country":{"name":"United States","mapbox_id":"dXJuOm1ieHBsYzpJdXc","wikidata_id":"Q30","country_code":"US","translations":{"en":{"name":"United States","language":"en"}},"country_code_alpha_3":"USA"},"district":{"name":"New York County","mapbox_id":"dXJuOm1ieHBsYzpBUU5tN0E","wikidata_id":"Q500416","translations":{"en":{"name":"New York County","language":"en"}}},"locality":{"name":"Manhattan","mapbox_id":"dXJuOm1ieHBsYzpGREtLN0E","wikidata_id":"Q11299","translations":{"en":{"name":"Manhattan","language":"en"}}},"postcode":{"name":"10001","mapbox_id":"postcode.7469603780890166"},"neighborhood":{"name":"Chelsea","mapbox_id":"dXJuOm1ieHBsYzpCb1hzN0E","wikidata_id":"Q1069129","translations":{"en":{"name":"Chelsea","language":"en"}}}},"mapbox_id":"dXJuOm1ieGFkcjpiYWY4YTg5MC1jMTAwLTRlZmEtYjc2MS00YTYyNzAzMWU2ZDg","coordinates":{"accuracy":"rooftop","latitude":40.74853,"longitude":-73.99669,"routable_points":[{"name":"default","latitude":40.748638,"longitude":-73.996563}]},"feature_type":"address","full_address":"300 West 28th Street, New York City, New York 10001, United States","name_preferred":"300 West 28th Street","place_formatted":"New York City, New York 10001, United States"}}],"attribution":"NOTICE: © 2026 Mapbox and its suppliers. All rights reserved. Use of this data is subject to the Mapbox Terms of Service (https://www.mapbox.com/about/maps/). This response and the information it contains may not be retained."},"success":true}},"exampleRequest":{"limit":1,"language":"en","latitude":40.7484,"longitude":-73.9967},"tags":["maps","geocoding","directions","routing","geospatial","data"],"displayCostAmount":"0.00375","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.00375/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.00375","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.00375","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2TbQZ4qIBRCPMD1L4jEXS","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.00375","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Mapbox","brandSlug":"mapbox","brandBaseUrl":"https://www.mapbox.com","brandDocsUrl":"https://docs.mapbox.com/api/","whatItDoes":"Converts geographic coordinates (latitude/longitude) into a human-readable address and place context using Mapbox","exampleAgentPrompt":"What street address and neighborhood corresponds to coordinates 40.7484° N, 73.9967° W? Give me 1 result in English.","exampleUseCases":null,"resultDescription":"Returns a GeoJSON FeatureCollection with address features including street name and number, city/place, region with state code, country with ISO code, district, and exact coordinates — all structured in a rich context hierarchy per result.","failureModes":["Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns 422 validation error","Coordinates in remote ocean or uninhabited area may return no features or sparse context","limit outside range 1-5 returns validation error","Invalid country code or language tag may be ignored or cause error","Payment failure results in 402 response"],"whenToPreferThis":"Use this endpoint when you have GPS coordinates and need a human-readable address or place name — ideal for displaying location context in apps, enriching location data with address metadata, or resolving device GPS output to meaningful place names. Prefer over forward geocoding when you already have coordinates and need the address, not the other way around.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:40:40.236Z","isFirstParty":false,"canonicalSlug":"mapbox-geocode-reverse-1d1873b6"}