Blackbaud · Schema

NewConstituentAddress

CreateConstituentAddress

Non-ProfitFundraisingDonor ManagementCRMFund AccountingEducationGrantmakingPaymentsPhilanthropySocial Impact

Properties

Name Type Description
constituent_id string The constituent ID.
address_type string The type. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/addresstypecode/entries
address_block string The address.
city string The city.
state string 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 string The zip.
country string 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 boolean Indicates whether do not send mail to this address.
cart string The cart.
lot string The lot.
dpc string The dpc.
start_date object
end_date object
primary boolean Indicates whether set as primary address.
historical_start_date string The start date. Uses the format YYYY-MM-DDThh:mm:ss. An example date: 1955-11-05T22:04:00.
recent_move boolean Indicates whether recently moved/changed from this address?.
old_address string 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 string The spouse name. Read-only in the SOAP API.
update_matching_spouse_addresses boolean Indicates whether update matching address information for spouse.
omit_from_validation boolean Indicates whether omit this address from validation.
county string The county. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/countycode/entries
congressional_district string The congressional district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/congressionaldistrictcode/entries
state_house_district string The state house district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/statehousedistrictcode/entries
state_senate_district string The state senate district. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/statesenatedistrictcode/entries
local_precinct string The local precinct. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/localprecinctcode/entries
info_source string The information source. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/infosourcecode/entries
region string The region. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/regioncode/entries
last_validation_attempt_date string The last attempt. Uses the format YYYY-MM-DDThh:mm:ss. An example date: 1955-11-05T22:04:00.
validation_message string The validation message.
certification_data integer The certification data.
zip_lookup_countries array Zip lookup countries.
household boolean Indicates whether household. Read-only in the SOAP API.
household_member boolean Indicates whether household member. Read-only in the SOAP API.
update_matching_household_addresses boolean Indicates whether copy address information to household members.
validation_countries array Validation countries.
do_not_mail_reason string The reason. This code table can be queried at https://api.sky.blackbaud.com/alt-adnmg/codetables/donotmailreasoncode/entries
info_source_comments string The comments.
confidential boolean Indicates whether this address is confidential.
constituent_data_review_rollback_reason string The reason. This simple list can be queried at https://api.sky.blackbaud.com/alt-adnmg/simplelists/484441bc-f0e6-4f5f-a6bf-49f02881dd13.
forced_primary boolean Indicates whether forced primary. Read-only in the SOAP API.
can_edit_primary boolean Indicates whether can edit primary. Read-only in the SOAP API.
invalid_fields string The invalid fields. Read-only in the SOAP API.
origin string The origin. Available values are user, web forms
View JSON Schema on GitHub

JSON Schema

blackbaud-new-constituent-address-schema.json Raw ↑
{
  "$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"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/blackbaud-new-constituent-address"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.