- Created by Andrew Barton, last modified on Feb 09, 2024
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 8 Current »
Fundamentally submitting a payment for an impound vehicle consists of 4 steps:
Finding the correct vehicle
finding its fees/total to the user and eligibility for release
Creating the receipt & payment
Finding the correct vehicle is done by calling the /impound/lookup endpoint with a payload containing either
Partial or full VIN
License plate number & License state
Date + vehicle details
You’ll also need to send along your region code, and the statuses you’re interested in. In this case the status you’re interested in is “STORED”. Here is an example looking for vehicle in the test region of IMP-TS, in the stored status, with a particular license and license state
Lookup by license and license state code
curl --location 'https://staging-api.autoreturn.net/api-web/api/impound/lookup' \
--header 'Content-Type: application/json' \
--data '{
"regionCode": "IMP-TS",
"impoundStatus": [
"STORED"
],
"vehicleLookupData": {
"license": "KK00001",
"licenseStateCode": "NC"
},
"start": 0,
"limit": 50
}'
Here is an example of looking up by VIN
Lookup by VIN
curl --location 'https://staging-api.autoreturn.net/api-web/api/impound/lookup' \
--header 'Content-Type: application/json' \
--data '{
"regionCode": "IMP-TS",
"impoundStatus": [
"STORED"
],
"vehicleLookupData": {
"VIN": "2P4GP2539YR506044"
},
"start": 0,
"limit": 50
}'
Looking up by vehicle details is more complicated, since you need our list of makes, models and colors.
You can get these lists by calling /api-web/api/refdata/{regionCode}/colors/api-web/api/refdata/{regionCode}/makes
and once you have the make, you can request all models for that make using
/api-web/api/refdata/{regionCode}/models/by-make/{makeCode}
Once the user has selected a value for these they should select a date, then you can send those to us, for example.
Lookup by vehicle details
curl --location 'https://staging-api.autoreturn.net/api-web/api/impound/lookup' \
--header 'Content-Type: application/json' \
--data '{
"regionCode": "IMP-TS",
"impoundStatus": [
"STORED"
],
"vehicleLookupData": {
"makeId": 148,
"modelId": 2307
},
"dateFrom": "2023-01-09T00:00:00",
"dateTo": "2023-01-10T00:00:00",
"start": 0,
"limit": 50
}
'
Note that the limit is very important here, as you could end up returning many vehicles if you allow the user to select something very broad, like all toyotas towed in January.
Response example
[
{
"id": 1067632,
"status": "STORED",
"version": 6,
"region": {
"id": 8000,
"privateRegion": false,
"standardRegion": true,
"managedRegion": true,
"code": "IMP-TS",
"name": "Impound Test Region",
"state": "CA",
"center": {
"lat": 37.766,
"lon": -122.428
},
"zoneId": "America/Los_Angeles",
"serverTimeOffset": 0,
"topRight": {
"lat": 37.832,
"lon": -122.355
},
"bottomLeft": {
"lat": 37.668,
"lon": -122.529
}
},
"make": {
"id": 148,
"code": "AIR",
"name": "AIR",
"active": true,
"motorcycle": false
},
"model": {
"id": 2307,
"makeId": 148,
"name": "CITY BIKE DA DONNA",
"code": "CITY BIKE DA DONNA",
"active": true,
"motorcycle": false
},
"color": {
"id": 1,
"name": "BLACK",
"code": "BLCK",
"active": true
},
"body": {
"id": 65155,
"name": "ALL TERAIN VEHICLE",
"code": "ATV",
"active": true,
"motorcycle": false,
"sortOrder": 29
},
"vehicleYear": 0,
"keyStatus": "KEY_MADE",
"odometer": 0,
"vin": "2P4GP2539YR506044",
"noVin": false,
"vinNotVisible": false,
"noPlate": false,
"license": "KK00001",
"licenseState": {
"code": "NC",
"name": "NORTH CAROLINA",
"active": true
},
"storage": [
{
"timeFrom": "2023-01-09T04:29:09.232",
"lot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "123 Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"id": 50408
}
],
"account": {
"id": 305,
"code": "TSTACC",
"name": "TSTACC",
"active": true,
"regionCode": "IMP-TS",
"requestTowCompany": false,
"imsOnly": false,
"sortOrder": 0,
"etims": false
},
"equipment": {
"id": 188,
"equipmentClass": "LIGHT",
"regionCode": "IMP-TS",
"code": "LIGHT",
"name": "Regular",
"secondVehicleAllowed": false,
"dispatch": true,
"impound": true,
"defaultForAutodispatch": true,
"allowedIfTCTZETisMissing": false
},
"reason": {
"id": 1887,
"code": "TEST",
"name": "Test",
"regionCode": "IMP-TS",
"active": true,
"sendToImpoundSystem": true,
"category": "IMPOUND",
"medical": false,
"sweep": false,
"skipStorage": false,
"salvor": false,
"ads": true,
"publiclyVisible": false
},
"zone": {
"code": "IMP-TS",
"name": "Test Zone",
"precinctId": 0,
"active": true,
"testZone": true,
"regionDefault": false
},
"towOperatorCompany": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentImpoundOperator": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentLot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "123 Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"currentLocation": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "123 Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"holds": [],
"contacts": [
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"void": false,
"city": "City",
"zip": "12345",
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address",
"address2": "Address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12330,
"state": "CA",
"type": "PAID_BY",
"id": 12330
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"void": false,
"city": "City",
"zip": "12345",
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address",
"address2": "Address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12331,
"state": "CA",
"type": "PAID_BY",
"id": 12331
}
],
"relatedVehicles": [],
"towReferenceNumber": "000268A000268",
"waivers": [],
"patrolUnitNumber": "5409",
"towOrigin": {
"addr1": "SEE MAP",
"city": "Mountain View",
"state": "CA"
},
"responseDate": "2023-01-09T04:47:37",
"requestedDate": "2023-01-09T04:27:37.207",
"dispatchedDate": "2023-01-09T04:27:37",
"acceptedDate": "2023-01-09T04:28:52",
"onsiteDate": "2023-01-09T04:28:58",
"inTowDate": "2023-01-09T04:29:04",
"clearedDate": "2023-01-09T04:29:09.232",
"driverName": "Passport Test Driver",
"conditions": [],
"specialEvent": false,
"nonStandardVin": false
}
]
Once you have the correct vehicle you can then retrieve its fees and total unpaid amount by its vehicleId.
VehicleId is the unique id for each time a vehicle gets towed. If it gets towed twice, it will get 2 vehicleIds. You then make a request to the /impound endpoint which will get you the complete vehicle details including the fees as of the time of the request.
Get detailed vehicle information
curl --location 'https://staging-api.autoreturn.net/api-web/api/impound?id=1067632
for example will give a response containing most of the details of the vehicle. In particular you’ll want to look at
currentLocationwhich represents the best way to get into contact with whoever has current possession of the vehiclemake.name , model.name , color.name , license , licenseState.code
unpaidFeeItemswhich contains all of the fee items that are not paid yet.totalUnpaidwhich contains the total unpaid amount for this vehicleeligibleForOnlinePaymentindicates if the vehicle is currently releasable. Holds may prevent release of the vehicle, in which case you probably don’t want to let people pay for it. The vehicle may also enter other states that would make online payments not apply correctly.
Here is an example of the response
Detailed vehicle info response
{
"instructions": "Please call us to get more information about this vehicle.",
"vehicle": {
"id": 1067632,
"status": "STORED",
"version": 16,
"vin": "2P4GP2539YR506044",
"noVin": false,
"vinNotVisible": false,
"noPlate": false,
"license": "KK00001",
"licenseState": {
"code": "NC",
"name": "NORTH CAROLINA",
"active": true
},
"region": {
"id": 8000,
"privateRegion": false,
"standardRegion": true,
"managedRegion": true,
"code": "IMP-TS",
"name": "Impound Test Region, CA",
"state": "CA",
"center": {
"lat": 37.766,
"lon": -122.428
},
"zoneId": "America/Los_Angeles",
"serverTimeOffset": 0,
"topRight": {
"lat": 37.832,
"lon": -122.355
},
"bottomLeft": {
"lat": 37.668,
"lon": -122.529
}
},
"towReferenceNumber": "000268A000268",
"make": {
"id": 148,
"code": "AIR",
"name": "AIR",
"active": true,
"motorcycle": false
},
"model": {
"id": 2307,
"makeId": 148,
"name": "CITY BIKE DA DONNA",
"code": "CITY BIKE DA DONNA",
"active": true,
"motorcycle": false
},
"color": {
"id": 1,
"name": "BLACK",
"code": "BLCK",
"active": true
},
"body": {
"id": 65155,
"name": "ALL TERAIN VEHICLE",
"code": "ATV",
"active": true,
"motorcycle": false,
"sortOrder": 29
},
"vehicleYear": 0,
"keyStatus": "KEY_MADE",
"odometer": 0,
"storage": [
{
"timeFrom": "2023-01-09T04:29:09.232",
"lot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"id": 50408
}
],
"account": {
"id": 305,
"code": "TSTACC",
"name": "TSTACC",
"active": true,
"regionCode": "IMP-TS",
"requestTowCompany": false,
"imsOnly": false,
"sortOrder": 0,
"etims": false
},
"equipment": {
"id": 188,
"equipmentClass": "LIGHT",
"regionCode": "IMP-TS",
"code": "LIGHT",
"name": "Regular",
"secondVehicleAllowed": false,
"dispatch": true,
"impound": true,
"defaultForAutodispatch": true,
"allowedIfTCTZETisMissing": false
},
"reason": {
"id": 1887,
"code": "TEST",
"name": "Test",
"regionCode": "IMP-TS",
"active": true,
"sendToImpoundSystem": true,
"category": "IMPOUND",
"medical": false,
"sweep": false,
"skipStorage": false,
"salvor": false,
"ads": true,
"publiclyVisible": false
},
"zone": {
"code": "IMP-TS",
"name": "Test Zone",
"precinctId": 0,
"active": true,
"testZone": true,
"regionDefault": false
},
"towOperatorCompany": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentImpoundOperator": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentLot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"currentLocation": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"holds": [],
"contacts": [
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address",
"address2": "Address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12330,
"state": "CA",
"type": "PAID_BY",
"id": 12330
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address",
"address2": "Address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12331,
"state": "CA",
"type": "PAID_BY",
"id": 12331
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12338,
"type": "PAID_BY",
"id": 12338
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12342,
"type": "PAID_BY",
"id": 12342
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12350,
"type": "PAID_BY",
"id": 12350
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12351,
"type": "PAID_BY",
"id": 12351
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12352,
"type": "PAID_BY",
"id": 12352
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12353,
"type": "PAID_BY",
"id": 12353
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "Unknown",
"zip": "Unknown",
"void": false,
"firstName": "",
"lastName": "",
"address1": "Unknown",
"address2": "Address2",
"identification": "UNKNOWN",
"identificationType": "OTHER",
"contactId": 12354,
"type": "PAID_BY",
"id": 12354
},
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address1",
"address2": "address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12389,
"state": "CA",
"type": "PAID_BY",
"id": 12389
}
],
"relatedVehicles": [],
"waivers": [],
"patrolUnitNumber": "5409",
"towOrigin": {
"addr1": "SEE MAP",
"city": "Mountain View",
"state": "CA"
},
"responseDate": "2023-01-09T04:47:37",
"requestedDate": "2023-01-09T04:27:37.207",
"dispatchedDate": "2023-01-09T04:27:37",
"acceptedDate": "2023-01-09T04:28:52",
"onsiteDate": "2023-01-09T04:28:58",
"inTowDate": "2023-01-09T04:29:04",
"clearedDate": "2023-01-09T04:29:09.232",
"driverName": "Passport Test Driver",
"conditions": [],
"specialEvent": false,
"nonStandardVin": false
},
"feeIncreases": [
{
"dateTime": {
"dateTimeString": "2024-02-09T00:00:00.000"
},
"delta": 22.760000000000001563194018672220408916473388671875,
"amount": 9203.980000000000001563194018672220408916473388671875
},
{
"dateTime": {
"dateTimeString": "2024-02-10T00:00:00.000"
},
"delta": 22.760000000000001563194018672220408916473388671875,
"amount": 9226.740000000000003126388037344440817832946777343750
}
],
"allFeeItems": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.5000,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.5000,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.7300,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.0300,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 372.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 8466.7200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 643.5600,
"totalPricePretax": 7823.1600,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-19T08:23:36.26958",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 5.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 113.8000,
"unitTax": 1.7300,
"effectiveDate": "2024-01-24T10:00:39.88896",
"totalTax": 8.6500,
"totalPricePretax": 105.1500,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 2.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 45.5200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-26T09:09:26.9357",
"totalTax": 3.4600,
"totalPricePretax": 42.0600,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-30T16:54:11.52637",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 9.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 204.8400,
"unitTax": 1.7300,
"effectiveDate": "2024-02-01T12:15:50",
"totalTax": 15.5700,
"totalPricePretax": 189.2700,
"name": "Storage"
}
],
"condensedFeeItems": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.50,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.50,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.73,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.03,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 396.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 9012.9600,
"unitTax": 1.73,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 685.0800,
"totalPricePretax": 8327.88,
"name": "Storage"
}
],
"unpaidFeeItems": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.50,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.50,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.73,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.03,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 396.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 9012.9600,
"unitTax": 1.73,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 685.0800,
"totalPricePretax": 8327.88,
"name": "Storage"
}
],
"eligibleForRelease": true,
"eligibleForOnlinePayment": true,
"receipts": [],
"totalUnpaid": 9181.2200
}
Once the user has indicated that they want to pay you must collect contact information from the user, this is used to ensure that the vehicle is released to the correct person later in the process.
You then call the /createReceiptAndPayment endpoint with the vehicleId, contact details and amount paid.
Note how in the response the vehicle’s status has changed to RELEASE_PENDING. This happens when a vehicle in a releasable state has been fully paid for. Also note the value in vehicle.releaseAuthorizedThrough, this is the latest time that the vehicle owner can show up to the yard to retrieve the vehicle before additional fees might be applied.
Creating a receipt
curl --location 'https://staging-api.autoreturn.net/api-web/api/impound/createReceiptAndPayment' \
--header 'Content-Type: application/json' \
--data-raw '{
"vehicleId": 1067632,
"amount": 9181.2200,
"paymentType": "CREDIT_CARD",
"receiptMessage": "Payment was made online",
"creditCardType": "VISA",
"authorizationNumber": "string",
"checkNumber": "string",
"externalRefNumber": "string",
"impoundContact": {
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address1",
"address2": "address2",
"city": "City",
"state": "CA",
"zip": "12345",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"email": "joe@example.com",
"type": "PAID_BY",
"phoneNumber": "5555555555"
},
"paymentDate": "2024-02-01T12:15:50"
}'
Response Example
{
"instructions": "Please call us to get more information about this vehicle.",
"vehicle": {
"id": 1067632,
"status": "RELEASE_PENDING",
"version": 18,
"vin": "2P4GP2539YR506044",
"noVin": false,
"vinNotVisible": false,
"noPlate": false,
"license": "KK00001",
"licenseState": {
"code": "NC",
"name": "NORTH CAROLINA",
"active": true
},
"region": {
"id": 8000,
"privateRegion": false,
"standardRegion": true,
"managedRegion": true,
"code": "IMP-TS",
"name": "Impound Test Region, CA",
"state": "CA",
"center": {
"lat": 37.766,
"lon": -122.428
},
"zoneId": "America/Los_Angeles",
"serverTimeOffset": 0,
"topRight": {
"lat": 37.832,
"lon": -122.355
},
"bottomLeft": {
"lat": 37.668,
"lon": -122.529
}
},
"towReferenceNumber": "000268A000268",
"make": {
"id": 148,
"code": "AIR",
"name": "AIR",
"active": true,
"motorcycle": false
},
"model": {
"id": 2307,
"makeId": 148,
"name": "CITY BIKE DA DONNA",
"code": "CITY BIKE DA DONNA",
"active": true,
"motorcycle": false
},
"color": {
"id": 1,
"name": "BLACK",
"code": "BLCK",
"active": true
},
"body": {
"id": 65155,
"name": "ALL TERAIN VEHICLE",
"code": "ATV",
"active": true,
"motorcycle": false,
"sortOrder": 29
},
"vehicleYear": 0,
"keyStatus": "KEY_MADE",
"odometer": 0,
"storage": [
{
"timeFrom": "2023-01-09T04:29:09.232",
"lot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"id": 50408
}
],
"account": {
"id": 305,
"code": "TSTACC",
"name": "TSTACC",
"active": true,
"regionCode": "IMP-TS",
"requestTowCompany": false,
"imsOnly": false,
"sortOrder": 0,
"etims": false
},
"equipment": {
"id": 188,
"equipmentClass": "LIGHT",
"regionCode": "IMP-TS",
"code": "LIGHT",
"name": "Regular",
"secondVehicleAllowed": false,
"dispatch": true,
"impound": true,
"defaultForAutodispatch": true,
"allowedIfTCTZETisMissing": false
},
"reason": {
"id": 1887,
"code": "TEST",
"name": "Test",
"regionCode": "IMP-TS",
"active": true,
"sendToImpoundSystem": true,
"category": "IMPOUND",
"medical": false,
"sweep": false,
"skipStorage": false,
"salvor": false,
"ads": true,
"publiclyVisible": false
},
"zone": {
"code": "IMP-TS",
"name": "Test Zone",
"precinctId": 0,
"active": true,
"testZone": true,
"regionDefault": false
},
"towOperatorCompany": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentImpoundOperator": {
"code": "ART-IMP-TS",
"id": 1338,
"name": "Test Company"
},
"currentLot": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"currentLocation": {
"code": "ART-IMP-TS",
"latitude": 29.763576,
"longitude": -95.356544,
"companyCode": "ART-IMP-TS",
"addr1": "Test Zone Lot",
"city": "San Francisco",
"zip": "94105",
"phone": "9999999999",
"twoStepRelease": false,
"state": {
"id": "CA",
"code": "CA",
"name": "CALIFORNIA",
"country": "USA",
"displayName": "CA - CALIFORNIA"
},
"id": 1369,
"name": "ART-IMP-TS Test Lot"
},
"holds": [],
"contacts": [
{
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address1",
"address2": "address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12390,
"state": "CA",
"type": "PAID_BY",
"id": 12390
}
],
"releaseAuthorizedThrough": "2024-02-08T20:21:15.274753",
"releaseAuthorizedOn": "2024-02-08T16:21:15.277795",
"releaseAuthorizedBy": "AR abarton",
"relatedVehicles": [],
"waivers": [],
"patrolUnitNumber": "5409",
"towOrigin": {
"addr1": "SEE MAP",
"city": "Mountain View",
"state": "CA"
},
"responseDate": "2023-01-09T04:47:37",
"requestedDate": "2023-01-09T04:27:37.207",
"dispatchedDate": "2023-01-09T04:27:37",
"acceptedDate": "2023-01-09T04:28:52",
"onsiteDate": "2023-01-09T04:28:58",
"inTowDate": "2023-01-09T04:29:04",
"clearedDate": "2023-01-09T04:29:09.232",
"driverName": "Passport Test Driver",
"conditions": [],
"specialEvent": false,
"nonStandardVin": false
},
"feeIncreases": [
{
"dateTime": {
"dateTimeString": "2024-02-09T00:00:00.000"
},
"delta": 22.760000000000001563194018672220408916473388671875,
"amount": 22.760000000000001563194018672220408916473388671875
},
{
"dateTime": {
"dateTimeString": "2024-02-10T00:00:00.000"
},
"delta": 22.760000000000001563194018672220408916473388671875,
"amount": 45.520000000000003126388037344440817832946777343750
}
],
"allFeeItems": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.5000,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.5000,
"postedReceiptId": 1004001,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.7300,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.0300,
"postedReceiptId": 1004001,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 372.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 8466.7200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 643.5600,
"totalPricePretax": 7823.1600,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-19T08:23:36.26958",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 5.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 113.8000,
"unitTax": 1.7300,
"effectiveDate": "2024-01-24T10:00:39.88896",
"totalTax": 8.6500,
"totalPricePretax": 105.1500,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 2.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 45.5200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-26T09:09:26.9357",
"totalTax": 3.4600,
"totalPricePretax": 42.0600,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-30T16:54:11.52637",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 9.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 204.8400,
"unitTax": 1.7300,
"effectiveDate": "2024-02-01T12:15:50",
"totalTax": 15.5700,
"totalPricePretax": 189.2700,
"postedReceiptId": 1004001,
"name": "Storage"
}
],
"condensedFeeItems": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.50,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.50,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.73,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.03,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 396.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 9012.9600,
"unitTax": 1.73,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 685.0800,
"totalPricePretax": 8327.88,
"name": "Storage"
}
],
"unpaidFeeItems": [],
"eligibleForRelease": false,
"eligibleForOnlinePayment": false,
"receipts": [
{
"vehicleId": 1067632,
"fees": [
{
"code": "TowLD",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 145.5000,
"unitsCount": 1.00,
"feeCategory": "TOW",
"totalPrice": 145.5000,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalPricePretax": 145.5000,
"postedReceiptId": 1004001,
"name": "Tow Fee-Light"
},
{
"code": "ImpoundmentFee",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 1.00,
"taxRate": 8.2500,
"feeCategory": "IMPOUNDMENT",
"totalPrice": 22.7600,
"unitTax": 1.7300,
"effectiveDate": "2023-01-09T04:29:09.232",
"totalTax": 1.7300,
"totalPricePretax": 21.0300,
"postedReceiptId": 1004001,
"name": "Impoundment Fee"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 372.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 8466.7200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-15T20:15:50.18237",
"totalTax": 643.5600,
"totalPricePretax": 7823.1600,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-19T08:23:36.26958",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 5.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 113.8000,
"unitTax": 1.7300,
"effectiveDate": "2024-01-24T10:00:39.88896",
"totalTax": 8.6500,
"totalPricePretax": 105.1500,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 2.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 45.5200,
"unitTax": 1.7300,
"effectiveDate": "2024-01-26T09:09:26.9357",
"totalTax": 3.4600,
"totalPricePretax": 42.0600,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 4.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 91.0400,
"unitTax": 1.7300,
"effectiveDate": "2024-01-30T16:54:11.52637",
"totalTax": 6.9200,
"totalPricePretax": 84.1200,
"postedReceiptId": 1004001,
"name": "Storage"
},
{
"code": "Storage-STANDARD_REGULAR-IMP-TS-NONE",
"feeEventType": "TOW_COMPLETED",
"unitPrice": 21.0300,
"unitsCount": 9.00,
"taxRate": 8.2500,
"feeCategory": "STORAGE",
"totalPrice": 204.8400,
"unitTax": 1.7300,
"effectiveDate": "2024-02-01T12:15:50",
"totalTax": 15.5700,
"totalPricePretax": 189.2700,
"postedReceiptId": 1004001,
"name": "Storage"
}
],
"amount": 9181.2200,
"posted": true,
"paidAmount": 9181.2200,
"receiptType": "RELEASE",
"createdDate": "2024-02-08T16:21:15.169112",
"impoundContact": {
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address1",
"address2": "address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12390,
"state": "CA",
"type": "PAID_BY",
"id": 12390
},
"unpaidAmount": 0.0000,
"paid": true,
"effectiveDate": "2024-02-01T12:15:50",
"payments": [
{
"amount": 9181.2200,
"posted": true,
"createdDate": "2024-02-08T16:21:15.204587",
"impoundContact": {
"phoneNumber": "5555555555",
"email": "joe@example.com",
"city": "City",
"zip": "12345",
"void": false,
"firstName": "Joe",
"lastName": "Schmoe",
"address1": "Address1",
"address2": "address2",
"identification": "ABC123",
"identificationType": "US_DL",
"idState": "CA",
"contactId": 12390,
"state": "CA",
"type": "PAID_BY",
"id": 12390
},
"paymentType": "CREDIT_CARD",
"paymentDate": "2024-02-01T12:15:50",
"authorizationNumber": "string",
"externalRefNumber": "string",
"userName": "abarton",
"receivedForUserId": 121,
"id": 1003692
}
],
"id": 1004001
}
],
"totalUnpaid": 0
}
- No labels