{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blackbaud/main/json-schema/blackbaud-new-constituent-address-schema.json",
  "title": "NewConstituentAddress",
  "description": "CreateConstituentAddress",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/blackbaud-altru-constituent-api-openapi.yml#/components/schemas/NewConstituentAddress",
  "required": [
    "constituent_id",
    "country"
  ],
  "type": "object",
  "properties": {
    "constituent_id": {
      "type": "string",
      "description": "The constituent ID."
    },
    "address_type": {
      "type": "string",
      "description": "The type. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/addresstypecode/entries"
    },
    "address_block": {
      "maxLength": 150,
      "minLength": 0,
      "type": "string",
      "description": "The address."
    },
    "city": {
      "maxLength": 50,
      "minLength": 0,
      "type": "string",
      "description": "The city."
    },
    "state": {
      "type": "string",
      "description": "The state. This simple list can be queried at https://api.sky.blackbaud.com/alt-adnmg/simplelists/7fa91401-596c-4f7c-936d-6e41683121d7?parameters=countryid,{countryid}."
    },
    "postcode": {
      "maxLength": 12,
      "minLength": 0,
      "type": "string",
      "description": "The zip."
    },
    "country": {
      "type": "string",
      "description": "The country. This simple list can be queried at https://api.sky.blackbaud.com/alt-adnmg/simplelists/c9649672-353d-42e8-8c25-4d34bbabfbba."
    },
    "do_not_mail": {
      "type": "boolean",
      "description": "Indicates whether do not send mail to this address."
    },
    "cart": {
      "maxLength": 10,
      "minLength": 0,
      "type": "string",
      "description": "The cart."
    },
    "lot": {
      "maxLength": 5,
      "minLength": 0,
      "type": "string",
      "description": "The lot."
    },
    "dpc": {
      "maxLength": 8,
      "minLength": 0,
      "type": "string",
      "description": "The dpc."
    },
    "start_date": {
      "$ref": "#/$defs/MonthDay"
    },
    "end_date": {
      "$ref": "#/$defs/MonthDay"
    },
    "primary": {
      "type": "boolean",
      "description": "Indicates whether set as primary address."
    },
    "historical_start_date": {
      "type": "string",
      "description": "The start date. Uses the format YYYY-MM-DDThh:mm:ss. An example date: <i>1955-11-05T22:04:00</i>.",
      "format": "date-time"
    },
    "recent_move": {
      "type": "boolean",
      "description": "Indicates whether recently moved/changed from this address?."
    },
    "old_address": {
      "type": "string",
      "description": "The old address. This simple list can be queried at https://api.sky.blackbaud.com/alt-adnmg/simplelists/bc075172-8103-4ccb-8285-658180e603a1?parameters=constituent_id,{constituent_id}."
    },
    "spouse_name": {
      "maxLength": 154,
      "minLength": 0,
      "type": "string",
      "description": "The spouse name. Read-only in the SOAP API."
    },
    "update_matching_spouse_addresses": {
      "type": "boolean",
      "description": "Indicates whether update matching address information for spouse."
    },
    "omit_from_validation": {
      "type": "boolean",
      "description": "Indicates whether omit this address from validation."
    },
    "county": {
      "type": "string",
      "description": "The county. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/countycode/entries"
    },
    "congressional_district": {
      "type": "string",
      "description": "The congressional district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/congressionaldistrictcode/entries"
    },
    "state_house_district": {
      "type": "string",
      "description": "The state house district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/statehousedistrictcode/entries"
    },
    "state_senate_district": {
      "type": "string",
      "description": "The state senate district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/statesenatedistrictcode/entries"
    },
    "local_precinct": {
      "type": "string",
      "description": "The local precinct. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/localprecinctcode/entries"
    },
    "info_source": {
      "type": "string",
      "description": "The information source. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/infosourcecode/entries"
    },
    "region": {
      "type": "string",
      "description": "The region. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/regioncode/entries"
    },
    "last_validation_attempt_date": {
      "type": "string",
      "description": "The last attempt. Uses the format YYYY-MM-DDThh:mm:ss. An example date: <i>1955-11-05T22:04:00</i>.",
      "format": "date-time"
    },
    "validation_message": {
      "maxLength": 100,
      "minLength": 0,
      "type": "string",
      "description": "The validation message."
    },
    "certification_data": {
      "type": "integer",
      "description": "The certification data.",
      "format": "int32"
    },
    "zip_lookup_countries": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/NewConstituentAddressZipLookupCountries"
      },
      "description": "Zip lookup countries."
    },
    "household": {
      "type": "boolean",
      "description": "Indicates whether household. Read-only in the SOAP API."
    },
    "household_member": {
      "type": "boolean",
      "description": "Indicates whether household member. Read-only in the SOAP API."
    },
    "update_matching_household_addresses": {
      "type": "boolean",
      "description": "Indicates whether copy address information to household members."
    },
    "validation_countries": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/NewConstituentAddressValidationCountries"
      },
      "description": "Validation countries."
    },
    "do_not_mail_reason": {
      "type": "string",
      "description": "The reason. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/donotmailreasoncode/entries"
    },
    "info_source_comments": {
      "maxLength": 256,
      "minLength": 0,
      "type": "string",
      "description": "The comments."
    },
    "confidential": {
      "type": "boolean",
      "description": "Indicates whether this address is confidential."
    },
    "constituent_data_review_rollback_reason": {
      "type": "string",
      "description": "The reason. This simple list can be queried at https://api.sky.blackbaud.com/alt-adnmg/simplelists/484441bc-f0e6-4f5f-a6bf-49f02881dd13."
    },
    "forced_primary": {
      "type": "boolean",
      "description": "Indicates whether forced primary. Read-only in the SOAP API."
    },
    "can_edit_primary": {
      "type": "boolean",
      "description": "Indicates whether can edit primary. Read-only in the SOAP API."
    },
    "invalid_fields": {
      "maxLength": 256,
      "minLength": 0,
      "type": "string",
      "description": "The invalid fields. Read-only in the SOAP API."
    },
    "origin": {
      "type": "string",
      "description": "The origin. Available values are <i>user</i>, <i>web forms</i>"
    }
  },
  "additionalProperties": false,
  "x-display-name": "Address Add Form 2",
  "x-display-id": "Address Add Form 2",
  "$defs": {
    "MonthDay": {
      "type": "object",
      "properties": {
        "month": {
          "type": "integer",
          "description": "The month.",
          "format": "int32"
        },
        "day": {
          "type": "integer",
          "description": "The day.",
          "format": "int32"
        }
      },
      "description": "MonthDay",
      "x-display-name": "Month Day",
      "x-display-id": "Month Day"
    },
    "NewConstituentAddressValidationCountries": {
      "type": "object",
      "properties": {
        "country_id": {
          "type": "string",
          "description": "countryid"
        },
        "browsable": {
          "type": "boolean",
          "description": "browsable"
        }
      },
      "description": "NewConstituentAddressValidationCountries",
      "x-display-name": "validation_countries",
      "x-display-id": "validation_countries"
    },
    "NewConstituentAddressZipLookupCountries": {
      "type": "object",
      "properties": {
        "country_id": {
          "type": "string",
          "description": "countryid"
        },
        "country_name": {
          "type": "string",
          "description": "name"
        }
      },
      "description": "NewConstituentAddressZipLookupCountries",
      "x-display-name": "zip_lookup_countries",
      "x-display-id": "zip_lookup_countries"
    }
  }
}