{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-address-book-person-schema.json",
  "title": "AddressBookPerson",
  "description": "A person in the owner's address book, as the address book shows them. The stored record also carries an unsubscribe token, an email hash and delivery counters; none of the three appear here. The token is the recipient's own capability, the hash is a server-internal join key, and bounce/suppression are delivery state that belongs to the outbound surface.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aimeat-io-contacts-api-openapi.yml#/components/schemas/AddressBookPerson",
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "description": "`mail:{id}` while they have no account here, their GHII once they do."
    },
    "name": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "ghii": {
      "type": [
        "string",
        "null"
      ],
      "description": "The identity this person turned out to be, once they proved the address here."
    },
    "note": {
      "type": [
        "string",
        "null"
      ]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      }
    },
    "relation": {
      "type": [
        "string",
        "null"
      ]
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}