Trade-in intents, the offers partners make on them, and the auctions that put a vehicle out to several dealers.
https://api.reportauto.euA trade-in records a seller’s intent to trade a vehicle with a partner. Partners then bid on it with offers, and the seller accepts one.
Registers a trade-in for a partner, optionally bound to an existing request through request_id and session_key.
Authentication API key
Seller’s name.
Seller’s phone number.
Seller’s email address.
Registration plate of the vehicle.
Country, e.g. USA.
State, e.g. FL.
Free-text note from the seller.
Partner the trade-in is offered to.
Request to associate the trade-in with.
Session key of that request.
1curl -X POST "https://api.reportauto.eu/api/trade_in" \
2 -H "Authorization: API_KEY $CAROOM_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "full_name": "Jamie Rivera",
6 "phone": "+37256781061",
7 "email": "jamie@example.com",
8 "info": "I want to test the car comes up",
9 "country_state_code": "FL",
10 "country_code": "USA",
11 "plate": "NEWUS",
12 "partner_id": 16,
13 "request_id": 1164,
14 "session_key": "ef651a9c-0d68-4fd3-a382-526741591ed3"
15 }'Changes the price on a trade-in. A partner uses it to set the offered price; a seller uses it to state the price they expect.
Authentication API key
ID of the trade-in.
Price, as a decimal string.
Note attached to the price.
1curl -X PATCH "https://api.reportauto.eu/api/trade_in/77" \
2 -H "Authorization: API_KEY $CAROOM_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "offer_price": "2345.99",
6 "info": "Best we can do this month"
7 }'A partner bids on a trade-in. Offers carry an expiry and an optional comment, and can be conditional on the seller buying a new vehicle.
Authentication API key
ID of the trade-in being bid on.
Amount offered.
Partner making the offer.
ISO 8601 timestamp when the offer lapses.
Whether the offer is conditional on trading for a new vehicle.
Note shown to the seller.
1curl -X POST "https://api.reportauto.eu/api/trade_in/1000/offers" \
2 -H "Authorization: API_KEY $CAROOM_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "trade_for_new": true,
6 "expires_at": "2020-10-08T15:30:00.000",
7 "value": 35690,
8 "comment": "This is a fair price",
9 "partner_id": 7
10 }'The seller accepts an outstanding offer. Authorised by the session key rather than by an account, so it works straight from the link in the notification.
Authentication Session key
ID of the trade-in.
True to accept the offer.
Session key that authorises the seller.
1curl -X PATCH "https://api.reportauto.eu/api/trade_in/1340/offers" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "accept": true,
5 "session_key": "b3c8d9df-9dc4-4221-907e-08517fe84829"
6 }'Places a bid in an auction using a dealer key, without an account session. Used by dealers bidding through a shared link.
Authentication Dealer key in the body
Key identifying the bidding dealer.
Auction being bid in.
Amount offered.
1curl -X POST "https://api.reportauto.eu/api/public/offers" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "dealer_key": "41cfe3cb-2b42-4f5d-aea0-31a97f6b8dac",
5 "auction_id": 10,
6 "value": 3000
7 }'A partner can put a trade-in out to a set of dealers as a timed auction. Dealers bid through the public offers endpoint — see Trade-ins.
Opens an auction on a trade-in for a named set of dealers. Start and end times default to now and thirty days out; neither may be in the past.
Authentication API key
Trade-in being auctioned.
Partner running the auction — supplies the geometry and currency.
Dealer IDs invited to bid.
ISO 8601 close time. Defaults to 30 days out.
ISO 8601 open time. Defaults to now.
Reserve price. Defaults to the expected price.
Minimum bid increment.
Location of the vehicle. Optional for a partner.
How long the winning bid holds, as { days, miles }.
1curl -X POST "https://api.reportauto.eu/api/auctions" \
2 -H "Authorization: $CAROOM_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "dealers": [53, 55],
6 "end_time": "2022-02-10T20:27:17.855Z",
7 "partner_id": 8,
8 "trade_in_id": 1503,
9 "validity": { "days": "3", "miles": 250 }
10 }'The invited dealer’s view of an auction, opened straight from the link they were sent. The dealer key in the path is the credential — bids go to the public offers endpoint under Trade-ins.
Authentication Dealer key in the path
Key identifying the invited dealer.
1curl "https://api.reportauto.eu/api/public/auctions/dealers/41cfe3cb-2b42-4f5d-aea0-31a97f6b8dac"Returns the auction with its bids and current standing.
Authentication API key
ID of the auction.
1curl "https://api.reportauto.eu/api/auctions/32" \
2 -H "Authorization: $CAROOM_API_KEY"