Examples - ATC Taxes & Fees API

ZIP Code Services

Use these endpoints to look up location information before making fee quote requests.

ZIP Code Information Lookup

GET

REQUEST

GET https://svc.autotitling.com/AGFService/v3.0/?Method=zipcodeinfo&ZipCode=24073

RESPONSE

<ZipCodeResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ZipCodeData>
    <ZipCode>24073</ZipCode>
    <State>Virginia</State>
    <County>MONTGOMERY</County>
    <City>CAMBRIA</City>
  </ZipCodeData>
</ZipCodeResponse>

Important: Use the exact City and County spelling from this response in your fee quote requests.

Check if ZIP Codes are In-State

GET

REQUEST

GET https://svc.autotitling.com/AGFService/v3.0/?Method=isinstate&ZipCode1=35034&ZipCode2=35210

RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<boolean>true</boolean>

Fee Quote Examples

Standard Purchase Transaction

POST Colorado

Verbosity 3, Granularity 2 - Full detail with subfee breakdown

REQUEST

<ServiceRequest xmlns="urn:atc-feequote" type="FeeQuote" requestFrom="ATC"
    verbosityLevel="3" granularity="2" quoteType="A">
  <IsProcessing>0</IsProcessing>
  <State>CO</State>
  <County>Larimer</County>
  <City>Fort Collins</City>
  <OutsideCityLimits>0</OutsideCityLimits>
  <Vehicle>
    <VIN>TESTVIN</VIN>
    <BasePrice>10000</BasePrice>
    <CustomerType>D</CustomerType>
    <FuelType>G</FuelType>
    <Cylinders>0</Cylinders>
    <Finance>
      <DownPayment>0</DownPayment>
      <MonthlyPayment>0</MonthlyPayment>
      <MonthsInTerm>0</MonthsInTerm>
      <CapCostReduction>0</CapCostReduction>
    </Finance>
    <GVW>8000</GVW>
    <GVWR>0</GVWR>
    <Length>30</Length>
    <MPG>16</MPG>
    <RegistrationMonths>12</RegistrationMonths>
    <LienStatus>1</LienStatus>
    <Year>2023</Year>
    <MSRP>100000</MSRP>
    <Plate>
      <IsTransfer>0</IsTransfer>
      <PlateType>R</PlateType>
    </Plate>
    <RegistrationOption>B</RegistrationOption>
    <DaysSincePurchase>0</DaysSincePurchase>
    <TitleStatus>T</TitleStatus>
    <TradeIns>
      <TradeIn><Amount>0</Amount></TradeIn>
    </TradeIns>
    <TransactionType>P</TransactionType>
    <VehicleType>PV</VehicleType>
    <VehicleSubType>OTH</VehicleSubType>
    <IsCommercialVehicle>0</IsCommercialVehicle>
    <IsPermanentTrailer>0</IsPermanentTrailer>
    <IsFleetVehicle>0</IsFleetVehicle>
    <Weight>5000</Weight>
    <Rebates>
      <Dealer>0</Dealer>
      <Manufacturer>0</Manufacturer>
    </Rebates>
    <DocFees>
      <DocFee name="Doc Fees">50</DocFee>
    </DocFees>
    <TheftProtections>
      <TheftProtection name="TheftProtection">150</TheftProtection>
    </TheftProtections>
  </Vehicle>
</ServiceRequest>

RESPONSE (Partial)

<FeeServiceResponse xmlns="urn:atc-feequote" quoteType="A" verbosityLevel="3">
  <Status>0</Status>
  <Notes>
    <Note>
      <NoteText>Fee is $5.00 per each 8 1/2 by 11-inch page filed.</NoteText>
      <SourceType>State</SourceType>
      <DisplayForATC>0</DisplayForATC>
    </Note>
  </Notes>
  <FeeTotal>2435.21</FeeTotal>
  <TotalSalesTax>
    <Rate>8.050000</Rate>
    <Amount>809.030000</Amount>
  </TotalSalesTax>
  <FeeDetails>
    <FeeDetail>
      <FeeId>320627</FeeId>
      <FeeCategory>Standalone</FeeCategory>
      <FeeName>State Tax</FeeName>
      <FeeType>Sales</FeeType>
      <SourceType>State</SourceType>
      <FormulaMerged>(0.029000 * ((10000 + 50.00 + 0.00 - 0.0 - 0) - 0.0)) - 0.0</FormulaMerged>
      <FormulaTextual>(0.029000 * ((Base Price + Doc Fees + Delivery Fees - Discounts - Trade In Amount) - Tax Credit)) - Taxes Paid to Another State</FormulaTextual>
      <FeeTaxRate>2.90000</FeeTaxRate>
      <Amount>291.45</Amount>
    </FeeDetail>
    <!-- Additional FeeDetails... -->
  </FeeDetails>
</FeeServiceResponse>

Lease Transaction - Taxes Paid in Lease

POST Connecticut

CT requires taxes to be written into the lease - note the $0 tax amount returned with the rate.

REQUEST

<ServiceRequest xmlns="urn:atc-feequote" type="FeeQuote" requestFrom="ATC"
    verbosityLevel="1" granularity="0" quoteType="A">
  <IsProcessing>0</IsProcessing>
  <State>CT</State>
  <County>Fairfield</County>
  <City>Danbury</City>
  <OutsideCityLimits>0</OutsideCityLimits>
  <Vehicle>
    <VIN></VIN>
    <BasePrice>30000</BasePrice>
    <CustomerType>D</CustomerType>
    <FuelType>G</FuelType>
    <Finance>
      <DownPayment>10000</DownPayment>
      <MonthlyPayment>700</MonthlyPayment>
      <MonthsInTerm>36</MonthsInTerm>
      <CapCostReduction>10000</CapCostReduction>
    </Finance>
    <GVW>4469</GVW>
    <GVWR>4469</GVWR>
    <RegistrationMonths>12</RegistrationMonths>
    <LienStatus>0</LienStatus>
    <Year>2023</Year>
    <MSRP>32000</MSRP>
    <Plate>
      <IsTransfer>0</IsTransfer>
      <PlateType>R</PlateType>
    </Plate>
    <TitleStatus>T</TitleStatus>
    <TransactionType>L</TransactionType>
    <VehicleType>PV</VehicleType>
    <Weight>2950</Weight>
  </Vehicle>
  <OptionalFilters>
    <Filter name="LeaseTaxesPaidUpfront" Value="1"></Filter>
  </OptionalFilters>
</ServiceRequest>

RESPONSE (Partial)

<FeeServiceResponse xmlns="urn:atc-feequote" quoteType="A" verbosityLevel="1">
  <Status>0</Status>
  <Notes>
    <Note>
      <NoteText>Tax MUST be written into the lease, CANNOT BE PAID UP FRONT</NoteText>
      <SourceType>State</SourceType>
      <DisplayForATC>0</DisplayForATC>
    </Note>
  </Notes>
  <FeeTotal>254.28</FeeTotal>
  <TotalSalesTax>
    <Rate>6.350000</Rate>
    <Amount>0.000000</Amount>
  </TotalSalesTax>
  <FeeDetails>
    <FeeDetail>
      <FeeName>State Tax</FeeName>
      <FeeType>Sales</FeeType>
      <FeeDescription>Tax MUST be written into the lease, CANNOT BE PAID UP FRONT</FeeDescription>
      <FeeTaxRate>6.35000</FeeTaxRate>
      <Amount>0.00</Amount>
    </FeeDetail>
    <!-- Registration fees... -->
  </FeeDetails>
</FeeServiceResponse>

Purchase with EV Tax Credit

POST Colorado

The TaxCredit field reduces the taxable amount for qualified EV purchases.

REQUEST (Key Fields)

<ServiceRequest xmlns="urn:atc-feequote" type="FeeQuote"
    verbosityLevel="3" granularity="1" quoteType="A">
  <State>CO</State>
  <County>Larimer</County>
  <City>Fort Collins</City>
  <Vehicle>
    <BasePrice>40000</BasePrice>
    <FuelType>H</FuelType>  <!-- Hybrid -->
    <TransactionType>P</TransactionType>
    <TitleStatus>MSO</TitleStatus>  <!-- New vehicle -->
    <TradeIns>
      <TradeIn><Amount>1000</Amount></TradeIn>
    </TradeIns>
    <DeliveryFees>
      <DeliveryFee name="DeliveryFees">100.0</DeliveryFee>
    </DeliveryFees>
    <TaxCredit>7500</TaxCredit>  <!-- Federal EV Tax Credit -->
  </Vehicle>
</ServiceRequest>

RESPONSE (Tax Calculation)

<FeeDetail>
  <FeeName>State Tax</FeeName>
  <FeeType>Sales</FeeType>
  <FormulaMerged>(0.029000 * ((40000 + 0.00 + 100.00 - 0.00 - 1000) - 7500)) - 0.0</FormulaMerged>
  <FormulaTextual>(0.029000 * ((Base Price + Doc Fees + Delivery Fees - Discounts - Trade In Amount) - Tax Credit)) - Taxes Paid to Another State</FormulaTextual>
  <FeeTaxRate>2.90000</FeeTaxRate>
  <Amount>916.40</Amount>  <!-- Reduced due to tax credit -->
</FeeDetail>

Note: The $7,500 tax credit reduces the taxable base from $39,100 to $31,600, resulting in lower taxes.

Common Errors

Error Message	Cause	Solution
`RegionID could not be derived`	City/county misspelled or combination doesn't exist	Use ZIP decoder service to get correct spelling
`Invalid Decimal value`	Element missing or not passed as valid decimal	Pass value as decimal; use 0 for unknown fields
`Enumeration constraint failed`	Invalid enum value provided	Check Data Points for valid string values