Documentation

Name Done is a lightning-fast autocomplete API for forms. Get up and running in minutes with a single API key.

Quick Start

Install the SDK, pass your API key, and start querying. Token management is handled automatically — you never need to think about JWTs.

Quick Start
1npm install @namedone/autocomplete
2
3import { createClient } from "@namedone/autocomplete"
4
5const nd = createClient("nd_...")
6
7// First names
8const { results } = await nd.firstNames("jo")
9// → [{ text: "John" }, { text: "Joseph" }, ...]
10
11// Formal names (title + name)
12const { results } = await nd.formalNames("mr j")
13// → [{ text: "Mr Jones" }, { text: "Mr Johnson" }, ...]
14
15// Postcodes (with coordinates)
16const { results } = await nd.postcodes("SW1A")
17// → [{ text: "SW1A 1AA", data: { lat: 51.5, lng: -0.1 } }, ...]

Authentication

Name Done uses a two-tier authentication model: a long-lived API key (nd_...) that you exchange for a short-lived JWT (5 minutes). The JWT is sent on every autocomplete request. The SDK handles this exchange automatically.

API KeyJWT (5 min)Autocomplete requests

Read the full authentication guide →

Using Name Done in a browser input? Native Autofill can cover your own suggestions. Stop browser autofill covering your field →

Data Attribution

The Name Done API returns data derived from open government sources. If you display school or postcode data from the API in your application, you must include attribution for the underlying data providers. The simplest way to comply is to link to namedone.com/data-sources from your website footer or about page.