---
title: "Retrieve a suggested address pin"
method: POST
path: "/api/v1/addresses/retrieve"
tags: ["addresses"]
---

# Retrieve a suggested address pin

`POST /api/v1/addresses/retrieve`

## Request

- Base URL: `https://buckybuild.com`
- URL: `https://buckybuild.com/api/v1/addresses/retrieve`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - none

Proxies Mapbox Search Box `retrieve` for a `mapbox_id` from `POST /api/v1/addresses/suggest`. Returns `{ address, lat, lng }` and ends the Mapbox billing session for `sessionToken`; callers should rotate the token afterward. Anonymous callers are allowed. Developer API keys with `site:read` are accepted. Uses the `PUBLIC_READ` route bucket behind the `PUBLIC_API` middleware backstop.

## Response `200`

Successful response.

## Other responses

- `400`: Validation or client error.
- `401`: Authentication required.
- `403`: Insufficient permissions.
- `404`: No such resource, or no such route under this version prefix.
- `429`: Rate limit exceeded (`code: RATE_LIMIT_EXCEEDED`, `retryable: true`). Honour `Retry-After`.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/buckybuild/apis/bucky-public-api.md) · [All operations](https://skmtc.dev/buckybuild/apis/bucky-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buckybuild/apis/bucky-public-api/revisions/30e442927a24?raw)