Titles

Autocomplete personal titles and honorifics by prefix. Returns the most common titles matching the query, sorted by popularity.

Try it

Endpoint

SDK Usage

1import { createClient } from "@namedone/autocomplete"
2​
3const nd = createClient("nd_...")
4const { results } = await nd.titles("m")

curl

1# Exchange your API key for a token
2curl -X POST https://token.namedone.com/v1 \
3  -H "Content-Type: application/json" \
4  -d '{"apiKey":"nd_..."}'
5​
6# Query the titles endpoint
7curl "https://autocomplete.namedone.com/v1/title/m?token=<jwt>"

Response Format

{
  "results": [
    {
      "id": "title-0",
      "text": "Mr",
      "type": "title"
    }
  ],
  "query": "m"
}

API Query Parameters

Sent as query string parameters on the HTTP request to the API.

SDK Options

Passed to the SDK methods (e.g. firstNames(query, opts)). These are processed client-side and never sent to the API.

Examples

{
  "results": [
    {
      "id": "title-0",
      "text": "Mr",
      "type": "title"
    },
    {
      "id": "title-1",
      "text": "Mrs",
      "type": "title"
    },
    {
      "id": "title-2",
      "text": "Miss",
      "type": "title"
    },
    {
      "id": "title-3",
      "text": "Ms",
      "type": "title"
    },
    {
      "id": "title-4",
      "text": "Mx",
      "type": "title"
    },
    {
      "id": "title-5",
      "text": "Master",
      "type": "title"
    }
  ],
  "query": "m"
}

{
  "results": [
    {
      "id": "title-0",
      "text": "Dr",
      "type": "title"
    }
  ],
  "query": "dr"
}

Notes

• Titles are a curated list of ~75 common UK personal titles and honorifics, ranked by approximate popularity.
• The full list is embedded directly in the CloudFront Function — no DynamoDB or Lambda is involved, so responses are instant.
• Includes academic, religious, military, noble, and parliamentary titles.
• Includes Mx, a gender-neutral title that does not reveal gender or marital status.