OneOffVerifyNameResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/akahu/main/json-schema/akahu-one-off-verify-name-result-schema.json",
  "title": "OneOffVerifyNameResult",
  "x-generated": "2026-10-26",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/akahu-identity-api-openapi.yml#/components/schemas/OneOffVerifyNameResult",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "enum": [
            true
          ]
        },
        "item": {
          "type": "object",
          "properties": {
            "sources": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/OneOffVerifyNameSource"
              }
            },
            "name": {
              "$ref": "#/$defs/VerifyNameData"
            }
          },
          "required": [
            "sources",
            "name"
          ]
        }
      },
      "required": [
        "success",
        "item"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "message": {
          "type": "string"
        }
      },
      "required": [
        "success"
      ]
    }
  ],
  "$defs": {
    "OneOffIdentityAccount": {
      "type": "object",
      "description": "Identity Account",
      "properties": {
        "bank": {
          "type": "string",
          "description": "Display name of the bank"
        },
        "account_number": {
          "type": "string",
          "description": "Unique bank account identifer"
        },
        "holder": {
          "type": "string",
          "description": "Names of the owner of the account"
        },
        "has_unlisted_holders": {
          "type": "boolean",
          "description": "Indicates if the account has other holders that are not listed in the holder field. This only applies to official open banking connections where the institution indicates a joint account, but only provides the authorising party's name."
        }
      }
    },
    "OneOffIdentityParty": {
      "type": "object",
      "properties": {
        "given_name": {
          "type": "string"
        },
        "middle_name": {
          "type": "string"
        },
        "family_name": {
          "type": "string"
        },
        "initials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "prefix": {
          "type": "string"
        },
        "gender": {
          "type": "string",
          "enum": [
            "MALE",
            "FEMALE",
            "UNKNOWN"
          ]
        }
      },
      "description": "The Party data that this name was verified against"
    },
    "OneOffVerifyNameHolderSource": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "HOLDER_NAME"
          ],
          "description": "The name was matched against an Account Holder"
        },
        "meta": {
          "allOf": [
            {
              "$ref": "#/$defs/OneOffIdentityAccount"
            },
            {
              "description": "The Account data that this name was verified against"
            }
          ]
        },
        "match_result": {
          "$ref": "#/$defs/VerifyNameMatchType"
        },
        "verification": {
          "$ref": "#/$defs/VerifyNameMatchedComponents"
        }
      },
      "required": [
        "type",
        "meta",
        "match_result",
        "verification"
      ]
    },
    "OneOffVerifyNamePartySource": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "PARTY_NAME"
          ],
          "description": "The name was matched against a Party"
        },
        "meta": {
          "$ref": "#/$defs/OneOffIdentityParty"
        },
        "match_result": {
          "$ref": "#/$defs/VerifyNameMatchType"
        },
        "verification": {
          "$ref": "#/$defs/VerifyNameMatchedComponents"
        }
      },
      "required": [
        "type",
        "meta",
        "match_result",
        "verification"
      ]
    },
    "OneOffVerifyNameSource": {
      "oneOf": [
        {
          "$ref": "#/$defs/OneOffVerifyNamePartySource"
        },
        {
          "$ref": "#/$defs/OneOffVerifyNameHolderSource"
        }
      ]
    },
    "VerifyNameData": {
      "type": "object",
      "properties": {
        "given_name": {
          "type": "string",
          "description": "The given name/first name to match against, if available"
        },
        "middle_name": {
          "type": "string",
          "description": "The middle name to match against, if available"
        },
        "family_name": {
          "type": "string",
          "description": "The family name/surname to match against"
        },
        "initials": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "An array of initials to match against, if available"
        }
      },
      "required": [
        "family_name"
      ]
    },
    "VerifyNameMatchType": {
      "type": "string",
      "enum": [
        "MATCH",
        "PARTIAL_MATCH"
      ],
      "description": "What is the quality of the Match?\n - `MATCH` → All name components matched\n - `PARTIAL_MATCH` → Some of the name components matched, but not all"
    },
    "VerifyNameMatchedComponents": {
      "type": "object",
      "properties": {
        "given_name": {
          "type": "boolean",
          "description": "Did the given name match?"
        },
        "middle_name": {
          "type": "boolean",
          "description": "Did the middle name match?"
        },
        "family_name": {
          "type": "boolean",
          "description": "Did the family name match?"
        },
        "middle_initial": {
          "type": "boolean",
          "description": "Did the middle initial match? (E.g. [B, J] matching Homer J Simpson)"
        },
        "given_initial": {
          "type": "boolean",
          "description": "Did the given initial match? (E.g. [H, A] matching Homer J Simpson)"
        }
      },
      "required": [
        "given_name",
        "middle_name",
        "family_name",
        "middle_initial",
        "given_initial"
      ],
      "description": "A collection of flags indicating which name components matched"
    }
  }
}