The Vehicle Credentials Vocabulary is designed to help organize and share information about vehicles and their ownership. It includes terms and definitions that describe different aspects of vehicles, such as their specifications, registration details, insurance information, and ownership information. This vocabulary is useful for anyone involved with digital credentials related to vehicles, whether they are car owners, dealerships, or government agencies.

This is an experimental vocabulary. Its contents and associated files such as contexts are subject to change.

Introduction

Introduction to the Verifiable Vehicle Credentials Vocabulary

The Verifiable Vehicle Credentials Vocabulary provides a clear way to describe important information about vehicles and their ownership. This vocabulary simplifies communication about vehicles by ensuring everyone uses the same terms and definitions. By having a common language, misunderstandings can be reduced when sharing information about vehicles.

This vocabulary is beneficial for many reasons. It allows for consistent data sharing between different parties involved in the vehicle industry. Whether it's a car manufacturer, dealership, insurance company, or government agency, everyone can have a shared understanding. This improves efficiency and helps to streamline processes, making it easier to handle vehicle credentials quickly and accurately.

Various market verticals can benefit from using the Vehicle Credentials Vocabulary. Automotive manufacturers can standardize their vehicle specifications, while dealerships can provide better information to potential buyers. Insurance companies can use the vocabulary to assess risk and evaluate policies based on clear vehicle data. Additionally, government agencies can improve their record-keeping and make vehicle information more accessible to the public.

Use cases for the vocabulary include vehicle registration, tracking ownership changes, and sharing technical specifications between manufacturers and dealerships. It is also valuable in managing insurance claims and assessing vehicle values. The vocabulary meets the requirements of being comprehensive and adaptable, which means it can evolve along with changes in the vehicle industry.

In summary, the Vehicle Credentials Vocabulary is a powerful tool that brings clarity and consistency to the vehicle industry. By facilitating better communication and data sharing, this vocabulary can help a wide range of businesses and organizations work more effectively together. It sets the stage for improved operations and better customer experiences throughout the vehicle lifecycle.

Namespaces

This specification makes use of the following namespaces:

vvc
https://w3id.org/vvc
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
xsd
http://www.w3.org/2001/XMLSchema#
schema
http://schema.org/

@context files

The following @context files make use of the terms defined in this specification:

Examples

In this section we give examples of the types of credentials that can be expressed with the Verifiable Vehicle Credentials vocabulary.

Vehicle Title Example

  {
    "@context": [
      "https://www.w3.org/ns/credentials/v2",
      "https://w3id.org/vvc/v1rc2"
    ],
    "type": [
      "VerifiableCredential",
      "VehicleTitleCredential"
    ],
    "issuer": "did:web:dmv.utopia.example",
    "credentialStatus": {
      "id": "https://example.gov/utopiadmv/credentials/status/3#94567",
      "type": "BitstringStatusListEntry",
      "statusPurpose": "revocation",
      "statusListIndex": "94567",
      "statusListCredential": "https://example.gov/utopiadmv/credentials/status/3"
    },
    "credentialSubject": {
      "type": "VehicleTitle",
      "vehicleIdentificationNumber": "4Y1SL65848Z411439",
      "manufacturer": {
        "type": "Organization",
        "name": "Honda"
      },
      "bodyType": "4H",
      "numberOfAxles": 2,
      "weight": {
        "type": "QuantitativeValue",
        "value": "3000",
        "unitCode": "LBR"
      },
      "vehicleModelDate": "1990",
      "fuelType": "G",
      "purchaseDate": "2020-02-01",
      "firstSold": {
        "type": "FirstSaleInformation",
        "class": "AA",
        "year": "2020",
        "month": "BB"
      },
      "odometerReading": {
        "type": "Observation",
        "observationDate": "2020-02-01",
        "variableMeasured": "Odometer Mileage",
        "value": "100000",
        // The unitCode value below is a UN/CEFACT Common Code.
        "unitCode": "1M",
        "description": "ODOMETER IS NOT THE ACTUAL MILEAGE"
      },
      "owner": [
        {
          "type": "Person",
          "name": "USEDCAR COLLECTOR",
          "address": {
            "type": "PostalAddress",
            "streetAddress": "123 LEMON AVE",
            "addressLocality": "UTOPOLIS",
            "addressRegion": "UTOPIA",
            "postalCode": "12345"
          },
          "hasCertification": {
            "type": "Certification",
            "about": "Driver's License Number",
            "certificationIdentification": "542426814"
          },
          "description": "Primary Owner"
        },
        {
          "type": "Person",
          "name": "USEDCAR ENTHUSIAST",
          "hasCertification": {
            "type": "Certification",
            "about": "Driver's License Number",
            "certificationIdentification": "789245168"
          } 
        }
      ],
      "ownerSaleRequirements": "USEDCAR COLLECTOR AND USEDCAR ENTHUSIAST",
      "feesPaid": {
        "type": "MonetaryAmount",
        "currency": "USD",
        "value": "100"
      },
      "validFrom": "2024-02-01",
      "titleIssueDate": "2024-02-01",
      "licensePlateIdentifier": "ABC1234",
      "equipmentTrustNumber": "12345678",
      "lienholder": {
        "type": "Organization",
        "name": "USEDCAR LIENHOLDER",
        "address": {
          "type": "PostalAddress",
          "streetAddress": "456 LEMON AVE",
          "addressLocality": "UTOPOLIS",
          "addressRegion": "UTOPIA",
          "postalCode": "12345"
        }
      },
      "lienholderReleaseDate": "2020-01-01",
      "controlNumber": "12345678",
      "description": "OFF HIGHWAY",
      "designations": "Original Taxi"
    },
    "proof": {
      "type": "DataIntegrity",
      "cryptosuite": "ecdsa-rdfc-2019",
      "verificationMethod": "did:web:dmv.utopia.example#key-1",
      "proofPurpose": "assertionMethod",
      "proofValue": "z4peo48uwK2EF4Fta8P...HzQMDYJ34r9gL"
    }
  }

Vehicle Registration Example

  {
    "@context": [
      "https://www.w3.org/ns/credentials/v2",
      "https://w3id.org/vvc/v1rc2"
    ],
    "type": [
      "VerifiableCredential",
      "VehicleRegistrationCredential"
    ],
    "issuer": "did:web:dmv.utopia.example",
    "credentialStatus": {
      "id": "https://example.gov/utopiadmv/credentials/status/3#94567",
      "type": "BitstringStatusListEntry",
      "statusPurpose": "revocation",
      "statusListIndex": "94567",
      "statusListCredential": "https://example.gov/utopiadmv/credentials/status/3"
    },
    "credentialSubject": {
      "type": "VehicleRegistration",
      "vehicleIdentificationNumber": "4Y1SL65848Z411439",
      "manufacturer": {
        "type": "Organization",
        "name": "Honda"
      },
      "weight": {
        "type": "QuantitativeValue",
        "value": "3000",
        "unitCode": "LBR"
      },
      "vehicleModelDate": "1990",
      "fuelType": "G",
      "owner": [
        {
          "type": "Person",
          "name": "USEDCAR COLLECTOR",
          "address": {
            "type": "PostalAddress",
            "streetAddress": "123 LEMON AVE",
            "addressLocality": "UTOPOLIS",
            "addressRegion": "UTOPIA",
            "postalCode": "12345"
          },
          "hasCertification": {
            "type": "Certification",
            "about": "Driver's License Number",
            "certificationIdentification": "542426814"
          }
        }
      ],
      "validFrom": "2024-02-01",
      "registrationStartDate": "2024-02-01",
      "registrationExpirationDate": "2025-02-01",
      "licensePlateIdentifier": "ABC1234",
    },
    "proof": {
      "type": "DataIntegrity",
      "cryptosuite": "ecdsa-rdfc-2019",
      "verificationMethod": "did:web:dmv.utopia.example#key-1",
      "proofPurpose": "assertionMethod",
      "proofValue": "z4peo48uwK2EF4Fta8P...HzQMDYJ34r5pd"
    }
  }

Vehicle Insurance Example

  {
    "@context": [
      "https://www.w3.org/ns/credentials/v2",
      "https://w3id.org/vvc/v1rc2"
    ],
    "type": [
      "VerifiableCredential",
      "VehicleInsuranceCredential"
    ],
    "issuer": "did:web:dmv.utopia.example",
    "credentialStatus": {
      "id": "https://example.gov/utopiadmv/credentials/status/3#94567",
      "type": "BitstringStatusListEntry",
      "statusPurpose": "revocation",
      "statusListIndex": "94567",
      "statusListCredential": "https://example.gov/utopiadmv/credentials/status/3"
    },
    "credentialSubject": {
      "type": "VehicleInsuranceInformation",
      "vehicleIdentificationNumber": "4Y1SL65848Z411439",
      "manufacturer": {
        "type": "Organization",
        "name": "Honda"
      },
      "owner": [
        {
          "type": "Person",
          "name": "USEDCAR COLLECTOR",
          "address": {
            "type": "PostalAddress",
            "streetAddress": "123 LEMON AVE",
            "addressLocality": "UTOPOLIS",
            "addressRegion": "UTOPIA",
            "postalCode": "12345"
          }
        }
      ],
      "validFrom": "2024-02-01",
      "policyNumber": "CI12345000",
      "policyStartDate": "2025-01-01",
      "policyEndDate": "2026-01-01",
      "coverageAmount": {
        "type": "MonetaryAmount",
        "currency": "USD",
        "value": "1000000"
      },
      "licensePlateIdentifier": "ABC1234"
    },
    "proof": {
      "type": "DataIntegrity",
      "cryptosuite": "ecdsa-rdfc-2019",
      "verificationMethod": "did:web:dmv.utopia.example#key-1",
      "proofPurpose": "assertionMethod",
      "proofValue": "z4peo48uwK2EF4Fta8P...HzQMDYJ34rm80"
    }
  }

Term definitions

Property definitions

The following are property definitions in the vvc namespace.

bodyType

Body Type

The Body Type property specifies the classification of a vehicle based on its physical design characteristics, such as sedan, coupe, SUV, or truck. This property is useful for vehicle identification, regulatory purposes, and consumer preferences.
stable
Relevant @context:
https://w3id.org/vvc

brand

Brand

The Brand property identifies the name of the brand associated with the vehicle, typically linked to the manufacturer. This property is vital for branding, marketing, and consumer identification purposes, helping customers recognize and select vehicles based on brand reputation.
stable
Relevant @context:
https://w3id.org/vvc

controlNumber

Control Number

The Control Number is a unique identifier assigned to a vehicle or related documentation for tracking and management purposes. This property helps in organizing records, facilitating audits, and ensuring that all vehicle credentials can be accurately referenced.
stable
Relevant @context:
https://w3id.org/vvc

coverageAmount

Coverage Amount

The Coverage Amount property specifies the maximum sum that an insurance policy will pay in the event of a claim. This information is crucial for understanding the financial protection offered by the policy.
stable
Relevant @context:
https://w3id.org/vvc

designations

Designations

A collection of official titles or designations related to the vehicle's title status. This property may encompass various identifiers that indicate the vehicle's legal status, such as 'clear', 'salvage', or other relevant classifications that impact ownership, insurance, or transferability.
stable
Relevant @context:
https://w3id.org/vvc

equipmentTrustNumber

Equipment Trust Number

The Equipment Trust Number is a unique identifier associated with the financing or leasing trust of a piece of equipment. This property is used to track and manage ownership and financial agreements related to the equipment, ensuring clarity in financial transactions and responsibilities.
stable
Relevant @context:
https://w3id.org/vvc

feesPaid

Weight

The feesPaid property denotes the fees paid as part of the transaction, registration, insurance, or other event represented by a credential.
stable
Relevant @context:
https://w3id.org/vvc

fuelType

Fuel Type

The Fuel Type property indicates the kind of fuel that a vehicle utilizes for operation, such as gasoline, diesel, electric, or hybrid. This information is crucial for consumers' energy choices, regulatory adherence, and environmental considerations.
stable
Relevant @context:
https://w3id.org/vvc

insuranceProvider

Insurance Provider

The Insurance Provider property identifies the company or organization that issues the insurance policy for the vehicle. This property is essential for managing policy details, facilitating claims processing, and ensuring compliance with insurance requirements.
stable
Relevant @context:
https://w3id.org/vvc

isInsured

Weight

The isInsured property indicates whether the vehicle in question is covered under an insurance policy.
stable
Relevant @context:
https://w3id.org/vvc

licensePlateIdentifier

License Plate Identifier

The License Plate Identifier is a unique alphanumeric code assigned to a vehicle's license plate. This property is used to identify the vehicle on public roads and in legal documentation, aiding in tracking ownership, registration, and compliance with local regulations.
stable
Relevant @context:
https://w3id.org/vvc

lienholder

Lienholder

The Lienholder property identifies the individual or organization that has a legal claim or interest in a vehicle due to a loan or other financial obligation. This property is crucial for understanding any existing liens on the vehicle, which may affect ownership rights and transferability.
stable
Relevant @context:
https://w3id.org/vvc

lienholderReleaseDate

Lienholder Release Date

The Lienholder Release Date indicates the date on which a lienholder formally relinquishes their claim on a vehicle. This property is important for documenting the resolution of a lien and allowing for the clear transfer of ownership without encumbrances.
stable
Relevant @context:
https://w3id.org/vvc

manufacturer

Manufacturer

The Manufacturer property identifies the organization responsible for producing the vehicle. This property is important for tracking the source of the vehicle, compliance with regulatory standards, and addressing any manufacturer recalls or warranties.
stable
Relevant @context:
https://w3id.org/vvc

motivePower

Weight

The motivePower property allows expression of a vehicle's propulsion mechanism.
stable
Relevant @context:
https://w3id.org/vvc

motorcycleEngineNumber

Motorcycle Engine Number

The Motorcycle Engine Number is a unique identifier assigned to the engine of a motorcycle. This property is essential for tracking engine specifications, verifying identity, and facilitating compliance with regulatory requirements regarding vehicle identification.
stable
Relevant @context:
https://w3id.org/vvc

numberOfAxles

Number of Axles

The Number of Axles property specifies the total count of axles on a vehicle. This information is important for regulatory compliance, vehicle classification, and determining weight restrictions for transportation purposes.
stable
Relevant @context:
https://w3id.org/vvc

numberOfCylinders

Weight

The numberOfCylinders property denotes the number of cylinders in a vehicle's engine, if applicable.
stable
Relevant @context:
https://w3id.org/vvc

odometerReading

Odometer Reading

The Odometer Reading represents the total distance traveled by a vehicle as recorded by the vehicle's odometer. This property is useful for assessing the vehicle's usage, maintenance needs, and overall value in relation to age and condition.
stable
Relevant @context:
https://w3id.org/vvc

owner

Owner

The Owner property identifies the individual or organization that possesses legal rights to a vehicle. This property can be used to associate a vehicle with a person's name or an organization's entity, providing clear ownership information for registration and legal purposes.
stable
Relevant @context:
https://w3id.org/vvc

ownerSaleRequirements

Owner Sale Requirements

A detailed description of the conditions and requirements that a vehicle owner must fulfill to sell their vehicle. This may include documentation needed, compliance with legal regulations, and any restrictions or obligations associated with the sale, ensuring a lawful and smooth transfer of ownership.
stable
Relevant @context:
https://w3id.org/vvc

policyEndDate

Policy End Date

The Policy End Date specifies the date on which the insurance coverage expires. This property is important for tracking the need for policy renewal and ensuring continuous insurance coverage for the vehicle.
stable
Relevant @context:
https://w3id.org/vvc

policyHolder

Policy Holder

The Policy Holder is the person or organization that holds the policy in question.
stable
Relevant @context:
https://w3id.org/vvc

policyNumber

Policy Number

The Policy Number property refers to the unique identifier assigned to an insurance policy covering a vehicle. This property is essential for managing insurance details, facilitating claims processing, and ensuring compliance with mandatory insurance requirements.
stable
Relevant @context:
https://w3id.org/vvc

policyStartDate

Policy Start Date

The Policy Start Date indicates the date when the insurance coverage begins. This property is crucial for understanding the validity period of the policy and ensuring the vehicle is insured continuously.
stable
Relevant @context:
https://w3id.org/vvc

provenanceResource

Provenance Resource

A reference to the source or origin of information regarding a vehicle's history, ownership, and other relevant details. This property may contain links to documents, records, or databases that provide verification of the vehicle's lineage and legal standing, ensuring transparency and trust in vehicle-related transactions.
stable
Relevant @context:
https://w3id.org/vvc

purchaseDate

Purchase Date

The Purchase Date specifies the date on which a vehicle was acquired by the owner. This property is important for tracking ownership history, determining warranty eligibility, and assessing vehicle depreciation over time.
stable
Relevant @context:
https://w3id.org/vvc

registeringOrganization

Registering Organization

The Registering Organization property identifies the company or governmental entity responsible for the registration of the vehicle. This property is essential for verifying the legitimacy of the registration and for facilitating communication regarding registration matters.
stable
Relevant @context:
https://w3id.org/vvc

registrationExpirationDate

Registration Expiration Date

The Registration Expiration Date indicates the date on which the vehicle registration will become invalid unless renewed. This property is critical for ensuring compliance with registration requirements and avoiding penalties for operating an unregistered vehicle.
stable
Relevant @context:
https://w3id.org/vvc

registrationStartDate

Registration Start Date

The Registration Start Date indicates when the vehicle's registration became effective. This property is important for tracking the registration timeline and ensuring compliance with regulatory requirements.
stable
Relevant @context:
https://w3id.org/vvc

titleIssueDate

Title Issue Date

The date and time when the vehicle title was officially issued by the governing authority. This property records the moment the ownership of the vehicle was formally recognized and documented, serving as an important reference for ownership history and transactions.
stable
Relevant @context:
https://w3id.org/vvc

vehicleIdentificationNumber

Vehicle Identification Number

A unique identifier assigned to a vehicle, commonly known as the Vehicle Identification Number (VIN). This number is used to track the vehicle's history, including ownership, registration, and insurance details. It is essential for verifying the vehicle's identity and is included in various official documents.
stable
Relevant @context:
https://w3id.org/vvc

vehicleModelDate

Vehicle Model Date

The Vehicle Model Date specifies the date associated with the specific model of a vehicle, indicating when the model was introduced or last updated. This property is important for understanding the model's manufacturing history, compliance with safety recalls, and assessing vehicle value.
stable
Relevant @context:
https://w3id.org/vvc

weight

Weight

The vehicleType property allows general expression of a vehicle's type classification.
stable
Relevant @context:
https://w3id.org/vvc

vesselType

Weight

The vesselType property allows expression of a watercraft's type classification.
stable
Relevant @context:
https://w3id.org/vvc

weight

Weight

The Weight property indicates the mass of a vehicle, typically measured in kilograms or pounds. This information is crucial for compliance with transportation regulations, assessing performance metrics, and determining towing capacities.
stable
Relevant @context:
https://w3id.org/vvc

weightClass

Weight

The weightClass property allows general expression of a vehicle's weight classification.
stable
Relevant @context:
https://w3id.org/vvc

Class definitions

The following are class definitions in the vvc namespace.

FirstSaleInformation

First Sale Information

First Sale Information refers to the details regarding the initial sale or transfer of ownership of a vehicle. This class encompasses data such as the sale date, selling party, and purchasing party, which are vital for documenting the vehicle's ownership history.
stable
Relevant @context:
https://w3id.org/vvc

VehicleInsuranceCredential

Vehicle Insurance Credential

A document that provides evidence of insurance coverage for a vehicle. This credential includes information such as the insurance policy number, the name of the insurance provider, coverage details, and the effective dates of the policy.
stable
Relevant @context:
https://w3id.org/vvc

VehicleInsuranceInformation

Vehicle Insurance Information

Vehicle Insurance Information refers to the details regarding the insurance coverage for a vehicle, including policy numbers, insurance provider, and validity periods. This class ensures that relevant insurance data is linked with the vehicle for regulatory and risk management purposes.
stable
Relevant @context:
https://w3id.org/vvc

VehicleRegistration

Vehicle Registration

A Vehicle Registration represents the official record of a vehicle's registration with a government authority. This class includes details such as the registration number, date of registration, and the name of the registered owner, as well as any pertinent registration status or expiration information.
stable
Relevant @context:
https://w3id.org/vvc

VehicleRegistrationCredential

Vehicle Registration Credential

A document that verifies a vehicle's registration with a governmental authority. This credential includes details such as the vehicle identification number (VIN), registration number, the owner's information, and the registration's validity period. It serves as proof that the vehicle has been registered and is allowed to operate on public roads.
stable
Relevant @context:
https://w3id.org/vvc

VehicleTitle

Vehicle Title

A Vehicle Title represents the legal document that establishes a person's or entity's ownership of a vehicle. This class includes information such as the title number, date of issue, and any relevant liens or encumbrances associated with the vehicle.
stable
Relevant @context:
https://w3id.org/vvc

VehicleTitleCredential

Vehicle Title Credential

A document that establishes ownership of a vehicle. This credential is issued by the appropriate authority and contains important information including the vehicle identification number (VIN), the owner's name, and any liens against the vehicle. It is used in various legal and financial transactions involving the vehicle.
stable
Relevant @context:
https://w3id.org/vvc