OnceAskGet started

CURRENT MAILING ADDRESS API

A mailing address API built around people, permission, and freshness.

Address-validation APIs tell you whether a string looks deliverable. OnceAsk solves a different problem: whether the person your user means has a current, permissioned destination you can safely use now.

Addresses change.OnceAsk is a recipient-aware address layer, not a geocoder or postal-format validator.

Resolve a known recipient

Call the delivery resolver with a contact ID or person query. OnceAsk returns a structured status so your application knows whether it can proceed, needs clarification, or should request recipient confirmation.

  • Person-first lookup
  • Structured resolution statuses
  • Least-privilege delivery scope

Handle missing and stale addresses safely

Instead of falling back to an old CRM or contact-card address, your application can trigger a permission request and let the recipient confirm their current destination.

  • request_delivery_permission
  • Current-address confirmation
  • No silent address guessing

Support agents and traditional software

The same resolution contract is available through REST and MCP, so a conventional application and an AI assistant can share a consistent current-address workflow.

  • REST API
  • Remote MCP server
  • OAuth and API-key authentication

HOW IT WORKS

Ask once. Keep the result useful.

1

Identify the person

Start from the contact or person the user already knows rather than a raw postal address string.

2

Resolve the delivery state

Receive a deterministic status such as authorized, permission_required, address_update_required, ambiguous, or not_found.

3

Act on the safe next step

Proceed with authorized fulfillment or route the recipient through confirmation before retrying.

BUILT FOR PEOPLE + AI

Addresses should be live data, not a stale field in a contact card.

OnceAsk gives people one current address to maintain and gives compatible assistants a permissioned way to resolve or request the delivery information they need.

Explore MCP

QUESTIONS

What to know

Is OnceAsk an address validation API?

No. Postal validation checks formatting or deliverability of an address string. OnceAsk focuses on whether a known recipient has a current, permissioned delivery destination and what to do when they do not.

Can an AI agent use the mailing address API?

Yes. OnceAsk supports both REST APIs and a remote MCP server. The MCP surface is designed specifically for compatible AI-agent workflows.

Does the API have to return a street address?

No. The preferred agent-facing flow can issue an opaque short-lived delivery token and fulfill through supported providers without returning the recipient's raw street address to the model.

RELATED

More ways to use OnceAsk

Collect it once. Keep it current.

Build an address book that is still useful the next time you need it.

Create your OnceAsk