Search
K
Lien Add - Sandbox

Lien Add

2.75.0OAS 3.0

Enables lenders to estimate fees, submit lien add transactions, and manage digital signature requests, returning status and confirmation data.

API Base URL
  • Server 1:https://api-test.vitu.com/national-public-api/v2
Security
bearerAuth (http)

Access tokens MUST follow JWT best practices per RFC8725: reject the “none” algorithm, verify signature and alg, and validate exp/nbf/aud/iss claims.

Additional Information
Contact Vitu API Support ([email protected])
Proprietary — Vitu License

Fees

Fees operations.

Calculate Fees

Calculates fees

post
https://api-test.vitu.com/national-public-api/v2/fees

Query Parameters

transactionTypestring

Identifier of the type of the transaction

Allowed values:EVRINTERSTATEDMVDESKNTX

Default:INTERSTATE

Headers

x-on-behalf-of-userinteger(int32)

>= -2147483648<= 2147483647

Body

application/json

LienAddTransactionRequest

LienAddTransactionRequest
One Of
statestringrequired

Allowed values:UT

Match pattern:^[\s\S]*$

<= 255 characters

applicationTypestringrequired

Allowed values:LienAdd

refNumberstring(uuid)

<= 36 characters

loanNumberstring | null

Match pattern:(?=^[\s\S]*$)(?=^[\s\S]*$)

<= 255 characters

lienholder1object
Show Child Parameters
vehicleobject
Show Child Parameters
ownerobject
Show Child Parameters
coOwnerobject
Show Child Parameters
registrationobject
Show Child Parameters
sellerobject
Show Child Parameters

Response

application/json

OK

FeesResponseDTO

FeesResponseDTO
post/fees

Body

{ "refNumber": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "state": "AL", "applicationType": "LienAdd", "registration": { "action": "NewRegistration", "address": { "street": "1116 Clarendon Ave", "city": "Brighton", "county": "Jefferson", "state": "AL", "zipCode": "35020", "zipCodeExt": "405" } }, "seller": { "address": { "street": "500 Lessor Ave", "city": "Birmingham", "county": "Jefferson", "state": "AL", "zipCode": "35205", "zipCodeExt": "1234" } }, "owner": { "ownerIsBusiness": false, "customerLastName": "Doe", "ownerType": "Business" }, "vehicle": { "vin": "5NMS4DAL5MHTEST", "state": "AL", "vehicleType": "Passenger", "fuelType": "Gasoline", "useType": "Personal", "grossWeight": 4100, "dealerServiceFee": 150, "documentFees": 75, "addOns": 0, "deliveryFee": 250, "tradeInValue": 0, "secondTradeInValue": 0, "manufacturesSuggestedRetailPrice": 32000, "purchaseDate": "2026-02-24T10:00:00Z", "isMilitary": false, "sellingPrice": 28995, "saleType": "Purchase", "soldAs": "New", "isLeaseBuyout": false, "isLeaseBuyoutTaxesRemittedBySeller": false, "isDrivenOffLot": true } }
 
application/json