API and widget for partners

Key and limits

Every request carries the key in the Authorization: Bearer vk_live_… header. We store only a hash of the key: if you lose it, we'll issue a new one.

• Each key has its own limits per minute and per day. Remaining quota is in the X-RateLimit-Remaining and X-RateLimit-Day-Remaining headers; when exceeded you get 429 and Retry-After.
• Every request is logged: response time, status, country, tariff version — this is how we answer partners' questions.
• A manager issues the key — contact us

Turnkey price: POST /api/v1/quote

Send the car data (make, year, seller price in won or yuan, engine size, power, fuel) and the client's country; the city is optional.

curl -X POST https://core8global.com/api/v1/quote \
  -H "Authorization: Bearer vk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"country":"KZ","city":"almaty","car":{"make":"Kia","model":"Sorento","year":2022,"price":31500000,"currency":"KRW","engineCc":2151,"powerHp":202,"fuel":"diesel"}}'

Response:

{
  "quote": {
    "ok": true,
    "currency": "KZT",
    "totalMinor": 1534561400,
    "totalText": "≈ 15 345 614 ₸",
    "preliminary": true,
    "groups": [{ "key": "car", "minor": 1170000000, … }, …],
    "lines": [ … ],
    "days": { "min": 21, "max": 35 }
  },
  "tariff": { "version": "kz-3f9a1c2b", "ratesAsOf": "2026-10-12", "rules": 14, "unverified": 3 }
}

• Amounts are integers in the minor units of the country's currency plus a ready totalText string in the locale language.
• If data is missing (for example, power for Russia), quote.ok = false and quote.missing lists what is needed.
• Instead of car you can pass lotId — a car number from our catalogue.

Tariff version

Every response and the X-Tariff-Version header carry the country's tariff version. It changes when customs rates, country settings or exchange rates change. If you store prices, recalculate when the version changes. unverified > 0 means some rates are not yet verified against regulations and the calculation is preliminary.

Errors

401

No key or the key is revoked.

404

No car with this lotId in the catalogue.

422

Invalid car data (fields lists which) or unknown country.

429

Per-minute or daily limit exceeded.

500

Error on our side — it is already in the log.

Widget for your website

A turnkey calculator with a request to a manager — in one line. CORE8 GLOBAL branding and our design; the client's default country comes from data-country.

<script src="https://core8global.com/widget.js" data-partner="your-slug" data-country="KZ" async></script>

Requests from the widget arrive in our CRM tagged with your partner label — you can see how many clients you brought.