Skip to main content

Get Vehicles Node

The Get Vehicles node retrieves vehicle policy information for a customer based on their customer number. This non-visual node queries the service in the background and returns vehicle details including registration number, model, year, and coverage information for use by subsequent nodes in the flow.

info

To display vehicle information to the user, use the Show Vehicle node after retrieving the data with the Get Vehicles node.

Use Case​

Use the Get Vehicles node when you want to:

  • Retrieve all active vehicle policies for a customer based on their customer number.
  • Populate vehicle data for use in subsequent nodes (e.g., displaying available vehicles, filtering by coverage, or processing vehicle-specific claims).
  • Query vehicle details like registration number, model, year, and coverage information in the background.

Don't use it when:

  • You need to retrieve vehicles based on criteria other than customer number.
  • You need to filter or aggregate vehicle data beyond what this node provides.

UI Examples​

Only output, no UI

Behavior​

  • Non-blocking: the node executes in the background without user interaction.
  • Requires input: expects a CustomerNumber from node properties.
  • Produces output: returns vehicle policy data (registration number, model, year, coverage information, etc.) stored in the value bag.
  • Renders: no UI elements.
  • Validation: logs a warning and returns status Not if customer number is missing or empty.
  • Output handling: returns either Ok status with vehicle data, Not status if no vehicles found, or CustomerInformation status if required customer data is unavailable.

Node Metadata​

PropertyDescription
Node classGetVehiclesNode
MessageType108
CanBeEditedFalse
CanBeProcessedOnceFalse
RequireUserResponseNo

Input Properties​

PropertyDescription
customerNumber

Customer number used to retrieve vehicle policies for a customer.

defaultValidationMessage

The default error message shown when the input is invalid or missing. This is used if no custom validation message is provided.

  • Default Values:
      • En:Please type in value
      • No:Skriv noe
      • Dk:Indtast værdi
      • Fi:Kirjoita kenttään
      • Se:Ange värde
sectionId

Groups this node visually under a specific section in TellUs. When multiple nodes share the same sectionId, they are displayed together under a shared header.

defaultValue

The initial value that is prefilled into the input field when the node is rendered. Useful for suggesting defaults or pre-populating known data.

isRequired

Determines whether the user must provide a value before continuing. If set to true, the form will not proceed without input.

  • Default Values:
      • En:true
  • Allowed Values:
      • true
      • false
isRequiredValidationMessage

The error message shown when a required field is left empty. This overrides the default validation message when isRequired is true.

  • Default Values:
      • En:Value is required
      • No:Verdi er påkrevd
      • Dk:Værdi er påkrævet
      • Fi:Arvo vaaditaan
      • Se:Värde krävs

Output Properties​

PropertyDescription
vehiclesData

Vehicle data object containing details of the customer's vehicle policies.

Properties include:

  • CustomerSsn: The customer's social security number.
  • RegistrationNumber: The vehicle's registration number.
  • ExposureNumber: The exposure number for the vehicle policy.
  • ExposureStatus: The current status of the vehicle exposure.
  • Model: The vehicle model name.
  • Year: The vehicle's year of manufacture.
  • MachineDamageIncluded: Indicates if machine damage coverage is included in the policy.
  • RentalCarIncluded: Indicates if rental car coverage is included in the policy.
  • CoverageCode: The coverage code associated with the vehicle policy.

Editor Example​

Try it in the Atlas Editor

This link opens a prebuilt flow using this node in context. You can inspect how it's configured, how it's connected, and how it behaves in a real editor environment.

Node in TellUs