General Information - Boat Registration Transactions (BQ/BR)
This section provides an overview and details regarding the Boat Registration Query by Boat Registration Number, Boat Hull Number, or Name and Date of Birth to a state (BQ), and the corresponding Boat Registration Response (BR).
To send a Boat Registration Query (BQ), a user must enter the Boat Registration (or Document) Number, Boat Hull Number, or Name and Date of Birth Positive Boat Registration Responses (BR) may contain the registration information listed in the list below, "Boat Registration Responses".
A Boat Registration Query (BQ) can be sent to the destination of CG (Coast Guard) using the boat's Coast Guard Number.
Other possible responses to a query are:
- NOT ON FILE
- TEMPORARILY UNAVAILABLE
- USER DOES NOT RESPOND TO MESSAGE TYPE BQ NLETS WILL NOT FORWARD TO XX (where XX = two character user code)
Query Requirements
- Each Registration Query (BQ) can be sent to up to five state codes and/or regions.
- A destination code of "Z1" will result in the query being directed to all states and Puerto Rico.
- The formats presented in this section assume that the response to a boat registration inquiry is via on-line direct interface database. A state that is unable to meet this format may return the information in a different format providing it is possible to be translated by an out of state recipient.
- Queries going to Coast Guard (CG) should be sent using the boat's Coast Guard Number.
Query Notes
- If a state wishes to request registration information it should, without exception, utilize the Nlets query formats. Usage should not be contingent on whether a destination state has an automated database on-line.
- Information within each inquiry provides the destination point with all information necessary to reply.
- Administrative Messages should not be used in place of Nlets boat registration query formats unless there is additional information required that was not included in the reply.
Query Help
To obtain explanatory or supplementary information on a state's boat registration files, a user may send an Administrative Message (AM) to
xxBOAT000 (where xx = 2 character state code)
A user also may determine who is providing automated responses to BQ inquiries and who has HELP files by sending an AM to
"xxBASHELP" (where xx= 2-character state code)
More information on help files can be located in Help File Transactions.
Technical Notes
This section provides guidance for data codes and query and response field requirements.
Data Codes
- Codes used as input and/or output in the boat registration query/response generally match NCIC formats and content. Please refer to Part II of your NCIC Manual for code translation and instruction.
- If a state cannot conform to the NCIC codes with regard to boat make and boat model, an easily understandable notation may be substituted.
Boat Registration Query/Response Field Requirements
The table that follows describes requirements for Boat Registration Queries (BQ) and Responses (BR).
XML Tag:
Legacy
Prefix:
Field
Size:
Data
Requirements:
Translation:
<nc:Vessel>
<nc:VesselRegistrationIdentification>
<nc:IdentificationID/>
</nc:VesselRegistrationIdentification>
</nc:Vessel><nc:Vessel>
<nc:VesselHullIdentification>
<nc:IdentificationID/>
</nc:VesselHullIdentification>
</nc:Vessel><nc:Vessel>
<nc:ItemOwner>
<nc:EntityPerson>
<nc:PersonName>
<nc:PersonFullName/>
<nc:PersonGivenName/>
<nc:PersonMiddleName/>
<nc:PersonSurName/>
</nc:PersonName>
</nc:EntityPerson>
</nc:ItemOwner>
</nc:Vessel><nc:Vessel>
<nc:ItemOwner>
<nc:EntityPerson>
<nc:PersonBirthDate>
<nc:Date/>
</nc:PersonBirthDate>
</nc:EntityPerson>
</nc:ItemOwner>
</nc:Vessel><nc:Vessel>
<nc:VesselRegistrationIdentification>
<nc:IdentificationID/>
<nc:IdentificationCategoryText>Coast Guard</nc:IdentificationCategoryText>
</nc:VesselRegistrationIdentification>
</nc:Vessel>
Note: The formats presented in this section assume that the response to a boat registration inquiry is via on-line direct
interface database. A state that is unable to meet this format may return the information in a different format providing
it is possible to translate it by an out-of-state recipient.
Top
GJXDM (DEPRECATED)
GJXDM has been deprecated. Please contact Nlets for additional assistance with GJXDM.
Top
NIEM
Boat Registration NIEM Specifications
This section describes the format and provides examples for Boat Registration queries and responses (BQ/BR).
Nlets now provides a standardized response format for this message type. The standardized format for this message is anticipated to be supported on the Nlets production system by July of 2016. Please contact Kate Silhol at ksilhol@nlets.org for additional information regarding implementation.
All Nlets NIEM messages must be based on the Nlets NIEM Message Structure and include the standard Nlets XML Header as detailed in Message Structure. The NIEM header and hierarchy of the elements in this section have been omitted to avoid redundancy. The associated schemas and instances should be consulted to determine the correct XPaths of the elements.
Element Dictionary
Transaction types detailed below include: Query by Hull Number (BQ), Query by Coast Guard Registration Number (BQ), Query by Name, DOB (BQ) , Full Vessel Data Response (BR), Vessel List Response (BR) and Standardized Vessel Data Response (BR).
Query Formats
Query by Registration Number (BQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vessel
A mode of transportation capable of transport by water.
This element will contain query data about the boat.
nc:VesselRegistrationIdentification
An identification assigned to a vessel by the coast guard or another vessel licensing organization.
nc:IdentificationID
A value that identifies something.
This element will contain the registration number for query.
Query by Boat Hull Number (BQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vessel
A mode of transportation capable of transport by water.
This element will contain query data about the boat.
nc:VesselHullIdentification
An identification found on the main body or frame of a vessel.
nc:IdentificationID
A value that identifies something.
This element will contain the hull number for query.
Query by Name, DOB (BQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vessel
A mode of transportation capable of transport by water.
This element will contain query data about the boat.
ItemOwner
EntityPerson
PersonName
A combination of names and/or titles by which a person is known.
PersonFullName
A complete name of a person.
This required element must contain the full name of the person in the format LAST,FIRST MIDDLE.
PersonBirthDate
A date a person was born.
Date
A full date.
This element contains the DOB for the person being queried on. This data in this element must be in xsd:date
format, that is: yyyy-mm-dd.
Query by Coast Guard Registration Number (BQ to CG)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vessel
A mode of transportation capable of transport by water.
This element will contain query data about the boat.
nc:VesselRegistrationIdentification
An identification assigned to a vessel by the coast guard or another vessel licensing organization.
nc:IdentificationID
A value that identifies something.
This element will contain the registration number for query.
nc:IdentificationCategoryText
A value that identifies the Category of the Identification.
This element will contain the string "Coast Guard".
Response Formats
Vessel Data Response (BR)
n2:NLETSResponseData
n2:ResponseText
This element will contain the free text response. Nlets recommends the use of a CDATA section
to ensure that the response does not contain any characters illegal in XML.
Standardized Vessel Data Response (BR)
n2-br:BoatRegistration
nc:Vessel
A mode of transportation capable of transport by water.
nc:ItemMakeName
A name of the manufacturer that produced an item.
nc:ItemModelName
A name of a specific design or kind of item made by a manufacturer.
nc:ConveyanceColorPrimaryText
A single, upper-most, front-most, or majority color of a conveyance.
nc:ConveyanceColorSecondaryText
A lower-most or rear-most color of a two-tone conveyance or a lesser color of a multi-colored conveyance.
nc:ConveyanceEngineQuantity
A number of engines on a conveyance.
nc:VehicleUseText
A manner or way in which a vehicle is used.
m:VesselCategoryText
A kind of vessel based upon the purpose for which the vessel was designed or built.
nc:VesselHullIdentification
An identification found on the main body or frame of a vessel. Actual value should go in the subelement nc:IdentificationType.
nc:VesselHullMaterialText
A substance used as the primary construction material of the main body or frame of a vessel.
nc:VesselHullShapeText
A shape of the main body or frame of a vessel.
nc:VesselPropulsionText
A mode by which a vessel is designed to move through the water.
m:VesselAugmentation
Additional information about a vessel.
m:VesselBuildDate
A date (or year) a vessel was built. Actual value should go in the subelement nc:Date.
m:VesselName
A name of a vessel.
m:VesselOfficialCoastGuardNumberText
An Official United States Coast Guard Number (USCG Official Number) of a vessel.
m:VesselBeamMeasure
A measure of the beam (breadth) of a vessel.
nc:MeasureValueText
A textual description of a measurement value.
m:VesselClassText
A class or category of a vessel.
m:VesselCruiseSpeedMeasure
A measure of the cruise speed of a vessel. Actual value should go in the subelement nc:MeasureValueText.
m:VesselDeadWeightMeasure
A measure of the total carrying capacity of a vessel. Actual value should go in the subelement nc:MeasureValueText.
m:VesselDisplacementMeasure
A weight of a vessel when empty. Actual value should go in the subelement nc:MeasureValueText.
m:VesselDraftMeasure
A measure of the draft of a vessel when fully loaded. Actual value should go in the subelement nc:MeasureValueText.
m:VesselDraftUnloadedMeasure
A measure of the draft of a vessel when unloaded. Actual value should go in the subelement nc:MeasureValueText.
m:VesselEngineCategoryDescriptionText
A description of the kind of engines on a vessel.
m:VesselFuelCategoryText
A kind of fuel a vessel uses.
m:VesselGrossTonnageValue
A gross tonnage (GT) of a vessel, described as a unitless index related to the overall internal volume of a vessel.
m:VesselHomePort
A home port of a vessel.
m:PortName
A name of a port.
nc:LocationCityName
A name of a city or town.
nc:LocationStateName
A name of a state, commonwealth, province, or other such geopolitical subdivision of a country.
m:VesselHullCategoryText
A kind of a hull of a vessel.
m:VesselHullColorText
A primary color of a hull of a vessel.
m:VesselMastHeightMeasure
A measure of the height of the tallest (highest) mast of a vessel. Actual value should go in the subelement nc:MeasureValueText.
m:VesselMaximumCrewQuantity
A maximum number of crew members that can be aboard a vessel. Actual value should go in the subelement nc:MeasureValueText.
m:VesselMaximumRangeMeasure
A measure of the maximum range of a vessel.
m:VesselMaximumStaticDraftMeasure
A measure of the draft of a vessel when fully loaded. Actual value should go in the subelement nc:MeasureValueText.
m:VesselMaximumSpeedMeasure
A measure of the maximum speed of a vessel.
m:VesselMaximumPassengerQuantity
A maximum number of passengers that are legally or safely permitted to be aboard a vessel.
m:VesselOverallLengthMeasure
A measure of the overall length of a vessel. Actual value should go in the subelement nc:MeasureValueText.
m:VesselShaftQuantity
A number of shafts on a vessel.
n2-br:ConveyanceAugmentation
j:Engine
An engine.
nc:ItemMakeName
A name of the manufacturer that produced an item.
nc:ItemModelName
A name of a specific design or kind of item made by a manufacturer.
j:EngineCylinderQuantity
A count of the cylinders contained in an engine.
j:EngineID
An identifier stamped on an engine by a manufacturer.
nc:ConveyanceFuelCategoryText
A kind of fuel or motive power used to propel a conveyance.
j:EngineDisplacementMeasure
A measure of the displacement of a conveyance engine. Actual value should go in the subelement nc:MeasureType.
j:EngineHorsepowerQuantity
A measure count of the horsepower of a conveyance engine. Actual value should go in the subelement nc:QuantityType.
nc:ItemColorDescriptionText
A description of the overall color of an item.
j:ConveyanceRegistration
A registration of a conveyance with an authority.
j:RegistrationIdentification
An identification of a registration certificate or document.
nc:IdentificationID
An identifier.
j:RegistrationAuthorityName
A name of an authority, person, or organization which issued a property registration.
nc:TextType
A name of an authority, person, or organization which issued a property registration.
j:RegistrationDuplicateQuantity
A number of times proof of property registration was issued with no change in information by the issuing authority.
j:RegistrationEffectiveDate
A date the current registration takes effect. Actual value should go in the subelement nc:Date.
j:RegistrationExpirationDate
A date the current registration is no longer in effect. Actual value should go in the subelement nc:Date.
nc:JurisdictionText
An area in which an organization or person has some kind of authoritative capacity or responsibility over.
j:RegistrationHolder
An entity to whom a registration is issued.
j:ConveyanceRegistrationDecal
A sticker attached to a permanent registration plate on a conveyance when it is renewed for the current year.
j:ConveyanceRegistrationPermanentIndicator
True if a registration for a conveyance is permanent; false if a registration is temporary.
j:RegistrationStatus
A status of a registration. Actual value should go in the subelement nc:StatusDescriptionText.
j:Title
j:TitleIdentification
An identification of a certificate of title to a property item.
nc:IdentificationID
An identifier.
j:TitleIssueDate
A date on which a jurisdictional titling authority issued a title to the owner of a property item. Actual value should go in the subelement nc:Date.
j:TitleIssuingAuthorityName
A name of an authority which issued a title.
j:TitleLienIndicator
True if a lien exists on the titled property; false otherwise.
j:TitleStatus
A status of a property title. Actual value should go in the subelement nc:StatusDescriptionText.
j:TitleHolder
An entity to whom a title is issued.
nc:EntityOrganization
An organization capable of bearing legal rights and responsibilities.
j:Lien
A legal encumbrance placed on a property item.
j:LienAmount
A monetary amount representing a legal encumbrance placed on a property. Actual value should go in the subelement nc:AmountType.
j:LienDate
A date a lien was placed on a property item. Actual value should go in the subelement nc:Date.
j:LienReleaseDate
A date a legal encumbrance is removed from a property item. Actual value should go in the subelement nc:Date.
j:LienReleaseReason
A data concept for a reason a legal encumbrance is removed from a property item.
j:LienReleaseReasonText
A reason a legal encumbrance is removed from a property item. Actual value should go in the subelement nc:TextType.
j:ItemTitlePurchaseDate
A date a current owner purchased a vehicle. Actual value should go in the subelement nc:DateType.
j:ItemTitlePurchasePriceAmount
A price a current owner paid to purchase a vehicle. Actual value should go in the subelement nc:AmountType.
j:ItemTitleSalesTaxAmount
A sales tax charged on a purchase of a vehicle. Actual value should go in the subelement nc:AmountType.
j:ItemTitleSalesTaxPercentage
A tax rate used for computing sales tax on a vehicle. Actual value should go in the subelement nc:PercentType.
j:ItemTitleTaxableValue
A dollar value used to compute the taxes on a vehicle.
nc:ItemValueAmount.
A dollar value used to compute the taxes on a vehicle.
nc:Amount
An amount of money.
nc:Organization
A unit which conducts some sort of business or operations.
nc:OrganizationName
A name of an organization.
nc:OrganizationDoingBusinessAsName
A name an organization uses for conducting business.
nc:OrganizationLocation
A location of an organization.
nc:OrganizationTaxIdentification
A tax identification assigned to an organization.
nc:Person
A human being.
nc:PersonName
A combination of names and/or titles by which a person is known.
nc:PersonBirthDate
A date a person was born.
nc:PersonSexText
A gender or sex of a person.
j:PersonAugmentation
j:DriverLicense
A license issued to a person granting driving privileges.
j:DriverLicenseIdentification
A driver license identification or driver license permit identification, including the number and state.
j:DriverLicenseExpirationDate
A date after which a driver license or driver license permit is no longer valid.
j:DriverLicenseIssueDate
A date when a driver license or driver license permit is issued or renewed.
n2-br:PersonAugmentation
n2:BoatEducationCertificateIdentification
nc:IdentificationID
An identifier.
nc:ContactInformationAssociation
An association between contact information and an entity.
nc:ContactInformation
A set of details about how to contact a person or an organization.
nc:ContactMailingAddress
A postal address by which a person or organization may be contacted.
nc:AddressFullText
A complete address.
nc:LocationStreet
A road, thoroughfare or highway.
nc:StreetFullText
A complete reference for a street.
nc:LocationCityName
A name of a city or town.
nc:LocationStateName
A name of a state, commonwealth, province, or other such geopolitical subdivision of a country.
nc:LocationPostalCode
An identifier of a post office-assigned zone for an address.