Class for specifying information not addressed in this model by other attributes, e.g. state-specific information that does not "fit" in any other attribute. The information will thus be highly specific to the generating application, and consuming applications must "know" the meaning of the information to make use of it. For this reason, use of this class is discouraged as much as is possible.
The StringValue and FileValue attributes are both optional, however exactly one of them must be included.
Used in request and response messages.
ElectionAdministration optionally includes this class to specify how to contact the election administration.
Voter optionally includes this class to specify the method for contacting a voter regarding the voter's request. If the voter can be contacted in multiple ways, the application creating the data should order the occurrences of ContactMethod by priority.
The PhoneContactMethod class uses ContactMethod as a base class, and should be used with when the contact method is for a telephone and it is necessary to describe the capabilities of the telephone.
The Capability attribute is provided by the PhoneContactMethod class.
Used in request and response messages.
Describes an election event. Only the date of the election is required. Other attributes may be used to describe the election for which a ballot is requested or a voter participated.
Used in request and response messages.
BallotStyle, Election, Party and ReportingUnit optionally include this class for associating a jurisdiction's codes, i.e., identifiers, with political parties or geopolitical units such as counties, towns, precincts, etc. Multiple occurrences of ExternalIdentifier can be used to associate multiple codes, e.g., if there is a desire to associate multiple codes with an object such as state-specific codes as well as OCD-IDs (Open Civic Data Identifiers).
Used in request messages.
VoterId optionally uses this class for FileValue to specify a filename for voter identification purposes such as for a utility bill. AdditionalInfo also optionally includes FileValue.
File extends the xsd:base64Binary type to add the attributes for filename and (Multi-Purpose Internet Mail Extensions) MIME type, e.g., application/pdf for a file of type PDF.
The Image element uses this class as an supertype, thus Image can be used when the type of file is for an image, e.g., image/png.
Used in request messages.
Signature optionally includes this class to indicate that a file contains an image of a voter's signature. Image uses File as supertype, thus attributes of File can be included in Image.
Used in response messages.
ReportingUnit and ElectionAdministration optionally include this element to specify the address and directions to a voter's voting location. The LatLng element can be included to specify the latitude and longitude of the voting location.
Used in request messages.
Voter includes this class for specifying the name of a voter and, optionally, for specifying a previous name of the voter, using PreviousName instead of Name. RequestHelper also includes this class for specifying the name of a registration helper.
Multiple occurrences of the MiddleName attribute can be used as needed, e.g., for names with additional middle names or nicknames such as "John Andrew Winston (Jack) Smith".
All elements are optional, however at least FullName must be included if the other attributes are not.
Used in request messages.
BallotStyle optionally includes this attribute to specify the associated political party, such as for closed primaries.
Voter optionally includes this attribute to specify a voter's political party.
Used in request messages.
Implementation of BallotRequest which serves to request ballots for election events that the voter is qualified on a long term basis. Although "permanent", the request may be subject to renewal or cancellation procedures.
Used in request and response messages.
RequestHelper, and RequestProxy use this class to specify a telephone number as well as the capabilities of the telephone, e.g., sms, fax, etc.
PhoneContactMethod is subtype of ContactMethod. Thus, the elements that include ContactMethod could use PhoneContactMethod as applicable.
Used in response messages.
RequestSuccess and VoterRecord include this class so as to provide a list of geopolitical geography associated with the voter's registration, e.g., the voter's precinct, polling place, districts, etc. The Type attribute uses the ReportingUnitType enumeration to specify the type of geopolitical geography being defined. If the reporting unit type is not listed in enumeration ReportingUnitType, use other and include the reporting unit type (that is not listed in the enumeration) in OtherType.
The IsDistricted boolean is not strictly necessary, as it is possible to identify districts by their Type attribute. However, if the type of district is not listed in the ReportingUnitType enumeration and therefore OtherType is used, then IsDistricted is necessary. The IsDistricted boolean can also be used to signify that a ReportingUnit defined as a jurisdiction, e.g., a county, is also used as a district for, e.g., county-wide contests.
VoterRecordsRequest optionally includes this element to specify information about a request helper, i.e., a request assistant or witness involved in a voter's request.
RequestHelper includes the Name element to specify the registration helper's name and optionally includes the Signature element if a registration helper's signature is required.
Used in request messages.
VoterRecordsRequest optionally includes this class to specify information about a request proxy involved in a voter records request.
OriginTransactionId can be used to include an optional identifier of the originating external transaction from the proxy, e.g., used for the transaction ID generated by a DMV application enacting a voter registration request to a registration portal application (on behalf of a citizen obtaining a driver's license). This sub-element is not to be confused with TransactionId in VoterRecordsRequest, which is used to include a transaction ID of the voter records request, e.g., the transaction ID of the registration portal's voter records request.
Used in responses.
For indicating that the request failed. The Error attribute is used to indicate the type of error that occurred. The AdditionalDetails attribute can be used to provide more information as to the rejection.
Used in responses.
For indicating a successful response to a request. The Action attribute is used to indicate the action that occurred, which may differ from what was requested. For example, a request for a new voter registration may succeed, but if the voter was already registered, the response may indicate a registration update as opposed to a registration create.
The response also includes, optionally, other information useful to the voter, including a description of the voter’s polling place, districts (i.e., contests) associated with the polling place, or other geopolitical geographies such as the voter’s precinct.
Used in request messages.
Voter optionally includes this class for specifying information about a voter's signature on a registration request. If there is a need to include previous signature that uses a different name, e.g., a maiden name, Voter uses PreviousSignature instead of Signature.
RequestHelper optionally includes this class for specifying information about the helper's signature.
Source is used to specify the source of the voter's signature, for example, on file at a department of motor vehicles. FileValue is used to include an image of the voter's signature.
Voter optionally includes this class to describe a voter's classification per criteria on the voter's request form, e.g., united-states-citizen or eighteen-on-election-day.
VoterClassification includes assertions of the voter in response to the voter request form criteria. For example, an assertion of true may be used with a criterion of united-states-citizen. Assertions can be negative, such as providing an assertion of false for a criterion of felon, an assertion of unknown to indicate that the voter does not know whether they meet or do not meet the specific criteria on the form or an assertion of other, in which the assertion is specified by the value of OtherAssertion.
Used in request and response messages.
Used to include information about a voter's identification that may be required in a registration request. Voter includes VoterId.
AttestNoSuchId is used to attest that the voter has no ID of a specified type, thus it must be included with a value of true if attesting that the voter has no ID for that specified type. It can be included with a value of false to attest that the voter does have an ID of the specified type, in which case either StringValue or FileValue must be included; however, it is assumed to be false if not included. The StringValue and FileValue sub-elements are both optional, however at least one of them must be included.
A subtype of Voter representing a voter record stored in a Voter Registration Database (VRDB).
VoterRecord optionally contains additional information useful to the voter, including a description of the voter’s polling place, districts associated with the voter's precinct, or other geopolitical geographies such as the voter’s precinct.
Used in responses.
For indicating a successful response to a lookup request.
A lookup for a single voter may result in multiple VoterRecords being returned. This can occur if the voter has duplicate records in the VRDB, or if the criteria specified in the lookup request was broad.
The root element for request messages.
For defining items pertaining to the status and type of the voter records request and when it was generated. VoterRecordsRequest includes the Subject association to specify various information about the voter in question. It includes the BallotRequest association to handle a request for an ballot; this request may be part of an FPCA form registration or may be submitted independently.
The root element for response messages.
For defining items pertaining to the status of a response to a voter records request. is an abstract element with three xsi:types that get used according to the type of response:
• , used to indicate an acknowledgement only.
• , used to indicate a failure and the type of failure.
• , used to indication that a successful registration action occurred and the type of registration action, which may differ from the type of registration action requested.
optionally includes the sub-element associated with the voter records request.
value comes from list: {'no'|'yes'|'unknown'|'other'}
Documentation
Enumeration for assertions from a voter or a third party such as a department of motor vehicles (DMV) in response to questions on a registration form, used in the Assertion attribute of VoterClassification.
value comes from list: {'email'|'email-or-online'|'fax'|'mail'|'online'}
Documentation
Enumeration for methods for delivering a ballot to the voter, used in the BallotReceiptPreference attribute of
oterRegistration. The sub-element may be repeated multiple times with different values as applicable, e.g., to specify both mail and online.
Used in requests AND responses.
Enumeration for methods for contacting a voter or an election administration office, used in the Type attribute of ContactMethod.
value comes from list: {'ballot-batch'|'ballot-style-area'|'borough'|'city'|'city-council'|'combined-precinct'|'congressional'|'county'|'county-council'|'drop-box'|'judicial'|'municipality'|'polling-place'|'precinct'|'school'|'special'|'split-precinct'|'state'|'state-house'|'state-senate'|'town'|'township'|'utility'|'village'|'vote-center'|'ward'|'water'|'other'}
Documentation
Used in request and response messages.
Enumeration for the type of geopolitical unit, used in the Type sub-element in the ReportingUnit element.
value comes from list: {'armed-forces-recruitment-office'|'motor-vehicle-office'|'other-agency-designated-by-state'|'public-assistance-office'|'registration-drive-from-advocacy-group-or-political-party'|'state-funded-agency-serving-persons-with-disabilities'|'voter-via-election-registrars-office'|'voter-via-email'|'voter-via-fax'|'voter-via-internet'|'voter-via-mail'|'unknown'|'other'}
value comes from list: {'armed-forces-recruitment-office'|'motor-vehicle-office'|'other-agency-designated-by-state'|'public-assistance-office'|'registration-drive-from-advocacy-group-or-political-party'|'state-funded-agency-serving-persons-with-disabilities'|'other'}
Documentation
Used in request messages.
Enumeration for the registration proxy, e.g., the MVA/DMV , involved in the voter's registration request, used in the
Type attribute of RegistrationProxy.
value comes from list: {'address-updated'|'name-updated'|'registration-cancelled'|'registration-created'|'registration-updated'|'status-updated'|'other'}
Documentation
Used in response messages.
Enumeration for a response to a voter records request, indicating that the response to the request is successful and the action that occurred, used in the Action sub-element of RegistrationSuccess. The success action may not necessarily match the requested action.
value comes from list: {'activated-national-guard'|'active-duty'|'active-duty-spouse-or-dependent'|'citizen-abroad-intent-to-return'|'citizen-abroad-return-uncertain'|'citizen-abroad-never-resided'|'deceased'|'declared-incompetent'|'eighteen-on-election-day'|'felon'|'permanently-denied'|'protected-voter'|'restored-felon'|'united-states-citizen'|'other'}
Documentation
Used in request messages.
Enumeration for voter status classifications, used in the Type attribute of VoterClassification. Whether the voter status, e.g., eighteen-on-election-day, is true, false, or unknown depends on the value of the Assertion attribute.
value comes from list: {'drivers-license'|'local-voter-registration-id'|'ssn'|'ssn4'|'state-id'|'state-voter-registration-id'|'unspecified-document'|'unspecified-document-with-name-and-address'|'unspecified-document-with-photo-identification'|'unknown'|'other'}
Documentation
Used in request messages.
Enumeration for the type of voter ID, used in the Type attribute of VoterId.
The XML Instance Representation table above shows the schema component's content as an XML instance.
The minimum and maximum occurrence of elements and attributes are provided in square brackets, e.g. [0..1].
Model group information are shown in gray, e.g. Start Choice ... End Choice.
For type derivations, the elements and attributes that have been added to or changed from the base type's content are shown in bold.
If an element/attribute has a fixed value, the fixed value is shown in green, e.g. country="Australia".
Otherwise, the type of the element/attribute is displayed.
If the element/attribute's type is in the schema, a link is provided to it.
For local simple type definitions, the constraints are displayed in angle brackets, e.g. <<pattern = [1-9][0-9]{3}>>.
If a local element/attribute has documentation, it will be displayed in a window that pops up when the question mark inside the attribute or next to the element is clicked, e.g. <postcode>.
Abstract(Applies to complex type definitions and element declarations). An abstract element or complex type cannot used to validate an element instance. If there is a reference to an abstract element, only element declarations that can substitute the abstract element can be used to validate the instance. For references to abstract type definitions, only derived types can be used.
Collapse Whitespace PolicyReplace tab, line feed, and carriage return characters with space character (Unicode character 32). Then, collapse contiguous sequences of space characters into single space character, and remove leading and trailing space characters.
Disallowed Substitutions(Applies to element declarations). If substitution is specified, then substitution group members cannot be used in place of the given element declaration to validate element instances. If derivation methods, e.g. extension, restriction, are specified, then the given element declaration will not validate element instances that have types derived from the element declaration's type using the specified derivation methods. Normally, element instances can override their declaration's type by specifying an xsi:type attribute.
Nillable(Applies to element declarations). If an element declaration is nillable, instances can use the xsi:nil attribute. The xsi:nil attribute is the boolean attribute, nil, from the http://www.w3.org/2001/XMLSchema-instance namespace. If an element instance has an xsi:nil attribute set to true, it can be left empty, even though its element declaration may have required content.
Prohibited Derivations(Applies to type definitions). Derivation methods that cannot be used to create sub-types from a given type definition.
Prohibited Substitutions(Applies to complex type definitions). Prevents sub-types that have been derived using the specified derivation methods from validating element instances in place of the given type definition.
Replace Whitespace PolicyReplace tab, line feed, and carriage return characters with space character (Unicode character 32).
Substitution GroupElements that are members of a substitution group can be used wherever the head element of the substitution group is referenced.
Substitution Group Exclusions(Applies to element declarations). Prohibits element declarations from nominating themselves as being able to substitute a given element declaration, if they have types that are derived from the original element's type using the specified derivation methods.
Target NamespaceThe target namespace identifies the namespace that components in this schema belongs to. If no target namespace is provided, then the schema components do not belong to any namespace.