{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kawaa-com/json-schema/kawaa-com-find-request-schema.json",
  "title": "FindRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kawaa-com-search-api-openapi.yml#/components/schemas/FindRequest",
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "maxLength": 64,
      "description": "Must contain at least one letter AFTER normalization, which spells the name in a-z: accents are dropped and letters such as `ø`, `æ`, `ß`, `ł` and `þ` are written `o`, `ae`, `ss`, `l` and `th`; then only `a-z` is kept. `José`, `Ñuñez` and `Søren` are fine, `李`, `2024` and `!!` are not. A name that normalizes to nothing generates no candidate addresses, so the API answers `400 first_name and last_name must contain letters (a-z)` and charges nothing. A name with a letter that has no single a-z spelling (such as `ə` or `ʒ`) next to letters that do is also a 400 that charges nothing, and so is one that spells to more than 64 letters. Deliberately not a `pattern` here: the check runs on the normalized form, and a regex over the raw string would refuse names this API accepts."
    },
    "last_name": {
      "type": "string",
      "maxLength": 64,
      "description": "Must contain at least one letter AFTER normalization, which spells the name in a-z: accents are dropped and letters such as `ø`, `æ`, `ß`, `ł` and `þ` are written `o`, `ae`, `ss`, `l` and `th`; then only `a-z` is kept. `José`, `Ñuñez` and `Søren` are fine, `李`, `2024` and `!!` are not. A name that normalizes to nothing generates no candidate addresses, so the API answers `400 first_name and last_name must contain letters (a-z)` and charges nothing. A name with a letter that has no single a-z spelling (such as `ə` or `ʒ`) next to letters that do is also a 400 that charges nothing, and so is one that spells to more than 64 letters. Deliberately not a `pattern` here: the check runs on the normalized form, and a regex over the raw string would refuse names this API accepts."
    },
    "domain": {
      "type": "string",
      "description": "The company's mail domain, as a bare name. A special-use name (`.example`, `.test`, `.invalid`, `.localhost`, `.local`, `.onion`, `.alt`, `.internal`, `.corp`, `.home`, `.mail`, `home.arpa` and the other special-use `.arpa` names) and RFC 2606's `example.com` / `.net` / `.org` with any name under them are a 400 before the charge: no mailbox can exist there. So are a domain that cannot receive mail (no such domain, a null MX, or neither an MX nor an address record) and a public mailbox provider such as gmail.com."
    }
  },
  "required": [
    "first_name",
    "last_name",
    "domain"
  ],
  "additionalProperties": false
}