Avtoorder API for partners

1. Open the contact form and choose the "Partnership Opportunity" subject.
2. Write "API access", your company, your use case and the server IP addresses you will call from.
3. We create a client for you and send the key over a private channel. It is shown once, so store it safely.
4. Your key has a scope: the full catalog, or only the cars Avtoorder holds in its own stock. Call GET /me to see it.

• Send the key only as Authorization: Bearer avto_live_… in the request header.
• A key in the URL query string is rejected with 400 key-in-query and the key is flagged as exposed, because URLs end up in logs and browser history. Rotate it if this happens.
• Keys can be restricted to a list of IP addresses.
• Keys can be rotated with a grace period during which the old key still works, and revoked immediately at any time.
• Keep keys on your server. Never ship them in a browser or mobile app.

Example

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 12
RateLimit-Policy: "minute";q=60;w=60, "day";q=20000;w=86400
RateLimit: "minute";r=0;t=12

{
  "type": "https://avtoorder.com/en/developers#error-rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "requestId": "0f3c…"
}

• The turnkey price (turnkeyEstimate) is an estimate, not a quote. It has isEstimate: true and the exchange rate used, with its source (fx.rateSource) and the time it was captured (fx.capturedAt).
• Every assumption the estimate had to make is listed in customs.assumptions. totalIsLowerBound: true (engine power or the customs duty unknown) means the real total can be higher. An unknown registration date is flagged (registrationUnknown) but does not make the total a lower bound.
• When the price of a car is unknown, priceCny is null and priceOnRequest is true. It is never 0. Such cars have no estimate and turnkeyUnavailableReason is price_on_request. For some listings we do not quote a turnkey price at all (for example, listings priced in USD, see askingPrice.currency); turnkeyUnavailableReason is then not_offered_for_listing.
• totalEstimate in list responses is approximate, can change between pages and can be 0 while truncated is true. Do not use it to decide when to stop paging.
• sort=recommended (the default) is a mixed ranking that interleaves the inventories; newest is also a mixed ranking across inventories that puts newer cars first within each inventory, not a strict order by listing date; price_asc and price_desc sort by price, low to high and high to low; mileage_asc puts the lowest mileage first; year_desc the highest year first. year is the car's year as the listing reports it: for most used cars the year of first registration, for some the model year. firstRegistration is the month and year of first registration when known.
• fuel is read from the listing — its stated energy type where that is reliable, otherwise an unambiguous technology name or engine code in the title (for example DM-i is plugin_hybrid, 280TSI is gasoline) — and is null when neither states it. A car with a null fuel never matches a fuel filter, so a fuel-filtered list holds the cars known to have that drivetrain, not necessarily all of them. Extended-range EVs (EREV) are reported as hybrid. condition: used means not known to be new, and cars with condition: null can appear in results, including under condition=used.
• locale sets the language of titles and labels where a translation exists; car titles, trims and some spec values are often in English or Chinese regardless of locale.
• GET /brands lists the brand keys known to the catalog: some may currently have no cars, and count is null when unknown. Brand and model keys can be non-ASCII (for example Chinese), so URL-encode them.
• Photos are served through our own image links (sizes 384, 640, 1080 and 1920 via ?w=). Links are stable but not guaranteed permanent: once your key is revoked they stop fetching new photos, although images that are already cached may keep loading for a while, and a link stops working when its photo is removed. Refresh them from the API when you re-sync.
• VINs are masked except for cars held in Avtoorder's own stock.