> ## Documentation Index
> Fetch the complete documentation index at: https://paperplane-justin-winter-s-projects.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nearest mailable address for a coordinate

> Backs the one-tap "use my location" control in the send flow.



## OpenAPI

````yaml /openapi.json get /v1/address/reverse
openapi: 3.1.0
info:
  title: paperplane API
  version: 1.0.0
  summary: Send real physical mail from code.
  description: >-
    Upload a PDF or paste text; we print it and hand it to USPS the next
    business day. No account required — pay per letter with a Stripe link or a
    prepaid credit code, and use `sandbox: true` to exercise the whole flow for
    free.


    Every failure returns the same envelope: `status`, a stable machine-readable
    `code`, a human `reason`, and a `next` array of concrete recovery steps.


    This document is generated from the same zod schemas the server validates
    with, so it cannot describe an endpoint that does not exist.
  contact:
    name: paperplane support
    url: https://sendpaperplane.com/contact
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
  termsOfService: https://sendpaperplane.com/terms
servers:
  - url: https://sendpaperplane.com
    description: Production
security: []
tags:
  - name: Mail
    description: Quote, send, track, and cancel letters.
  - name: Credits
    description: Prepaid balances that pay for letters without a card.
  - name: Reviews
    description: Post-delivery feedback. Identity is derived from the order, not supplied.
  - name: Addresses
    description: >-
      Typeahead and reverse geocoding. Convenience only; USPS verification is
      authoritative.
  - name: Meta
    description: Machine-readable description of this API.
paths:
  /v1/address/reverse:
    get:
      tags:
        - Addresses
      summary: Nearest mailable address for a coordinate
      description: Backs the one-tap "use my location" control in the send flow.
      operationId: reverseGeocode
      parameters:
        - name: lat
          in: query
          required: true
          description: Latitude, -90 to 90.
          schema:
            type: number
            minimum: -90
            maximum: 90
        - name: lon
          in: query
          required: true
          description: Longitude, -180 to 180.
          schema:
            type: number
            minimum: -180
            maximum: 180
      responses:
        '200':
          description: Nearest address, or null when nothing matched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReverseGeocodeResponse'
              example:
                enabled: true
                address:
                  label: 742 Evergreen Terrace, Springfield, IL 62704
                  line1: 742 Evergreen Terrace
                  city: Springfield
                  state: IL
                  zip: '62704'
                  lat: 39.78
                  lon: -89.65
        '400':
          description: >-
            Coordinates missing or out of range. Returns a null address rather
            than an error envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReverseGeocodeResponse'
              example:
                enabled: true
                address: null
components:
  schemas:
    ReverseGeocodeResponse:
      type: object
      properties:
        enabled:
          type: boolean
        address:
          anyOf:
            - $ref: '#/components/schemas/AddressSuggestion'
            - type: 'null'
      required:
        - enabled
        - address
    AddressSuggestion:
      type: object
      properties:
        label:
          type: string
        line1:
          type: string
        city:
          type: string
        state:
          type: string
        zip:
          type: string
        lat:
          type: number
        lon:
          type: number
      required:
        - label
        - line1
        - city
        - state
        - zip
        - lat
        - lon

````